PingDirectory

Configuring an external server using dsconfig

Use the dsconfig tool to create and configure external servers. Then, specify the host name, connection method, port number, and bind distinguished name (DN), as described in previous procedures.

Steps

  1. Run the dsconfig command.

    $ bin/dsconfig

  2. In the PingDirectoryProxy main menu, enter the number corresponding to external servers.

  3. Enter the number to create a new external server.

  4. Select the type of server you want to create.

    Example:

    This example creates a new Ping Identity PingDirectory server.

    >>>> Select the type of external server that you want to create:

  1) Ping Identity DS external server
  2) JDBC external server
  3) LDAP external server
  4) Sun DS external server

  ?) help
  c) cancel
  q) quit

Enter choice [c]: 1

  5. Specify a name for the new external server.

    Example:

    In this example, the external server is named east1.

    >>>> Enter a name for the Ping Identity DS external server that you want
to create: east1

  6. Configure the host name or IP address of the target LDAP external server.

    Example:

    Enter a value for the 'server-host-name' property:east1.example.com

  7. Configure the location property of the new external server.

    Example:

    Do you want to modify the 'location' property?

   1) Leave undefined
   2) Change it to the location: East
   3) Change it to the location: West
   4) Create a new location

   ?) help
   q) quit

Enter choice [1]: 2

  8. Define the bind DN and bind password.

    Example:

    Do you want to modify the 'bind-dn' property?

   1) Leave undefined
   2) Change the value

   ?) help
   q) quit

Enter choice [1]: 2

Enter a value for the 'bind-dn' property [continue]: cn=Proxy User,cn=Root DNs,cn=config

Enter choice [b]: 6

...

Do you want to modify the 'password' property?

   1) Leave undefined
   2) Change the value
   ?) help
   q) quit

Enter choice [1]: 2

Enter a value for the 'password' property [continue]:
Confirm the value for the 'password' property:

  9. To finish the operation, enter f.

    Enter choice [b]: f

Result

The Ping Identity DS external server was created successfully.

Next steps

After adding the server, run the prepare-external-server tool to configure communications between the PingDirectoryProxy server and the Ping Identity PingDirectory server.

For more information, see Preparing two new external servers using the prepare-external-server tool.