Getting started with the PingDirectory server

After you have set up your PingDirectory server instance, you can configure any specific server settings, import your user database, or run initial performance tests to optimize the server’s throughput.

The administrative console’s URL is based on the host name and HTTPS port specified during installation, such as https://hostname.com:443/console.

Apply Server Configurations

Apply your server configuration changes individually or using a dsconfig batch file. The batch file defines the PingDirectory server configuration tool (dsconfig) commands necessary to configure your server instance. For more information on using batch files, see Using dsconfig batch mode.

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

Import Data

Import user data using the import-ldif tool. The import serves as an initial test of the schema settings.

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

Install and Configure the Delegated Admin Application

Install a Javascript-based web application for business users to manage identities stored in the PingDirectory server. The application provides delegated administration of identities for help desk or customer service representatives initiating a password reset and unlock, an employee in HR updating an address stored within another employee profile, or an application administrator updating identity attributes or group membership to allow application single sign-on (SSO) access.

Run Performance Tests

The PingDirectory server provides two tools for functional performance testing using in-house LDAP clients that access the server directly: searchrate to test search performance and modrate to test modification performance.

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

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