PingDirectory

Getting started with the PingDirectory server

After setting up your PingDirectory server instance, you can configure additional server settings, import your user database, and run initial performance tests to optimize the server’s throughput.

Configure the server

You can configure the PingDirectory server using the dsconfig command-line tool or the admin console. With dsconfig, you can also apply configuration changes in a batch file.

dsconfig

Learn to use the dsconfig tool.
Batch mode

Learn to use dsconfig batch mode.
Admin console

Learn to use the admin console.

Server configuration details

  • The batch file defines the dsconfig commands necessary for configuring your server instance.

  • The host name and HTTPS port you set during installation determine the deployment URL for the admin console.

    For example, given a host name of server1 and an HTTPS port of 1443, you would access the admin console at https://server1.com:1443/console. You can also find the admin console URL by running bin/status.

  • If you’re migrating from a Sun Java System directory server (version 5.x - 7.x), you can use the bin/migrate-sun-ds-config command to migrate your configuration settings to this new server instance.

Import user data

Import your user data using the import-ldif tool, as shown in the following example:

$ bin/import-ldif --backendID userRoot --ldifFile ../user-data.ldif

The import serves as an initial test of the schema settings. Learn more about Importing data and Managing the schema.

Test operational performance

The PingDirectory server provides two tools for functional performance testing using built-in LDAP clients that access the server directly:

  • Use searchrate to test the server’s peformance for search operations. For example:

    $ bin/searchrate --baseDN "dc=example,dc=com" --scope sub \
  --filter "(uid=user.[0-1999])" --attribute givenName --attribute sn \
  --attribute mail --numThreads 10 --numIntervals 20

  • Use modrate to test the server’s performance for modify operations. For example:

    $ bin/modrate --entryDN "uid=user.[0-1999],ou=People,dc=example,dc=com" \
  --attribute description --valueLength 12 --numThreads 10 --numIntervals 20

Improve performance

To improve the performance of either search or modify operations, consider the following strategies:

Preload the database.

Prime the server with backend data.
Tune the indexes.

Tune the existing indexes for your environment.
Create new indexes.

Create new indexes for common operations.

Install Delegated Admin (optional)

Install a Javascript-based web application for business users to manage identities stored in the PingDirectory server. Learn more in Installing Delegated Admin and the Delegated Admin Application Guide.

The Delegated Admin application provides delegated administration of identities in the following scenarios:

  • A help desk or customer service representative needs to initiate a password reset and unlock an account.

  • An employee in HR needs to update an address stored within another employee profile.

  • An application administrator needs to update identity attributes or group membership to allow single sign-on (SSO) access.