PingDirectory

Configuring the PingDirectory server using dsconfig interactive mode

Configure the PingDirectory server using the dsconfig command-line tool in interactive mode.

Steps

  1. Launch the dsconfig tool in interactive command-line mode.

    Example:

    $ bin/dsconfig

  2. Enter the LDAP connection parameters.

    Choose from:

    • Enter the PingDirectory server’s host name or IP address.

    • Press Enter to accept the default.

  3. Enter the number corresponding to the type of LDAP connection that you are using on the PingDirectory server,, or press Enter to accept the default.

    The numbers for the LDAP connection type are 1 for LDAP, 2 for SSL, and 3 for StartTLS. The default entry is 1.

  4. Enter the LDAP listener port number, or accept the default port.

    The default port is the port number of the server local to the tool.

  5. Enter the user bind DN and the bind DN password.

    The default is cn=Directory Manager.

  6. On the Directory Server Configuration Console main menu, enter a number corresponding to the configuration that you want to change.

    The number might change between releases or within the same release, depending on the options selected, such as in cases where more expert level objects and properties are displayed.

  7. In this example, select the number for Backend.

  8. Set the db-cache-percent to 40%.

    The optimal cache percentage depends on your system performance objectives and must be tuned as determined through analysis. In many cases, the default value chosen by the setup utility is sufficient.

  9. On the Backend management menu, enter the number corresponding to view and edit an existing backend.

  10. Select the backend to work with or press Enter to accept the default.

    In this example, using the basic object menu, only one backend that can be viewed in the directory, userRoot.

  11. From the Local DB Backend properties menu, type the number corresponding to the db-cache-percent property.

  12. Enter the option to change the value, and then type the value for the db-cache-percent property.

    In this example, type 40 for 40 %.

  13. To apply the changes, enter f.

    Before you apply the change, the dsconfig interactive command-line mode provides an option to view the equivalent non-interactive command based on your menu selections. This is useful in building dsconfig script files for configuring servers in non-interactive or batch mode. If you want to view the equivalent dsconfig non-interactive command, type d. For more information, see Getting the equivalent dsconfig non-interactive mode command.

  14. In the Backend management menu, to quit the dsconfig tool, enter q.

Viewing dsconfig advanced properties

Configure dsconfig interactive mode to hide or display additional advanced properties.

About this task

For most configuration settings, some properties are more likely to be modified than others.

Steps

  1. Repeat steps 1–9 in Configuring the PingDirectory server using dsconfig interactive mode.

  2. To display the advanced properties, from the Local DB Backend properties menu, enter a.

    Result:

    This toggles any hidden properties.