Configuring the index properties - PingDirectory - 9.3

PingDirectory 9.3

PingDirectory 9.3
PingDirectory 9.3 (Latest)

By default, the index-entry-limit value is 4000, meaning the server stops maintaining index values for keys that match more than 4000 entries. You can change the value with the dsconfig tool.

Before running the following commands, be aware that you must do an index rebuild on the system, which requires a system shutdown unless the command is run as a task.

To configure the index properties:

  1. Run dsconfig with the set-backend-prop subcommand.
  2. Set the index-entry-limit to 5000. Confirm that you want to apply the changes.

    By default, this value is set to 4000.


    Remember to include the bind parameters for your system.

    $ bin/dsconfig set-backend-prop \
      --backend-name userRoot \
      --set index-entry-limit:5000 \
    One or more configuration property changes require administrative action
    or confirmation/notification. Those properties include:
    * index-entry-limit: If any index keys have already reached this limit,
    indexes must be rebuilt before they will be allowed to use the new limit.
    Setting a large limit (greater than 10,000) could have a big impact on
    write performance and database growth on disk.
    Continue? Choose 'no' to return to the previous step (yes / no) [yes]: yes
  3. Stop the server.
    $ bin/stop-server
  4. Rebuild the index.
    $ bin/rebuild-index --baseDN dc=example,dc=com \
      --index cn --index givenName --index objectClass \
      --index sn --maxThreads 10
  5. View the Index Summary Statistics table, which automatically displays to system out after running the rebuild-index command.

    You can also access the table at logs/tools/rebuild-index-summary.txt.

    A screen capture of the Index Summary Statistics table showing the limits for each index.
  6. Repeat steps 1-4 to make more adjustments to your indexes.
  7. Restart the server.
    $ bin/start-server