Managing the directory server configuration

Use the Directory Server Configuration page to configure the directory server in the IBM® Security Identity Manager virtual appliance.

Before you begin

Install and configure the directory server. Make sure you create the directory server DN location. See Install and configure the directory server.

About this task

Configure or reconfigure the directory server options. See Table 1.
Table 1. Directory Server configuration details
Button Directory server options
Configure
Configure with existing LDAP database
Select this check box to configure an existing LDAP database and specify the LDAP database configuration.

When you select this check box, the configuration uses the existing IBM Security Identity Manager schema and data.

Host name
Specify the name of the server that hosts the directory server.

The acceptable formats for the host name are IPv4, FQDN, and IPv6. For example, isimldap.example.com.

Port
Specify the directory service port.

For example, 389.

You can select or clear the SSL check box to manage the secure connection.

Principal DN
Specify the principal distinguished name.

For example, cn=root.

Password
Specify the password for the directory server.
Organization name
Specify the name of the enterprise or the organization.

For example, JK Enterprises.

Default organization short name
Specify the abbreviation or short form of the organization name.

For example, jke.

IBM Security Identity Manager DN Location
Specify the directory server DN location.

For example, dc=com.
Reconfigure
Host name
Specify the name of the server that hosts the directory server.

The acceptable formats for the host name are IPv4, FQDN, and IPv6. For example, isimldap.example.com.

Port
Specify the directory service port.

For example, 389.

You can select or clear the SSL check box to manage the secure connection.

Principal DN
Specify the principal distinguished name.

For example, cn=root.

Password
Specify the password for the directory server.

Procedure

  1. From the top-level menu of the Appliance Dashboard, click Configure > Manage External Entities > Directory Server Configuration.
    The Directory Server Configuration page displays the Directory Server Configuration table.
  2. Click Configure.
  3. In the Directory Server configuration details window, specify the expected variable values.
    For more information, see Table 1.
  4. Click Save Configuration to complete this task.

    A window with certificate information is displayed if you selected the SSL check box during configuration.

  5. Click Yes to confirm.
    Note: The directory server reconfiguration takes some time. Do not refresh or close the page. Wait for the reconfiguration process to complete.
  6. Optional: To reconfigure an existing directory server configuration, do these steps.
    1. Before you reconfigure, create a snapshot to recover from any configuration failures.
      See Managing the snapshots.
    2. From the Directory Server Configuration table, select a record.
      For example, IBM Security Identity Manager User Registry.
    3. Click Reconfigure.
    4. In the Edit directory server configuration details window, edit the configuration variables.
      For more information, see Table 1.
    5. Click Save Configuration.
      A window opens that displays the certificate information.
    6. Click Yes to confirm.
      Note: The directory server reconfiguration takes some time. Do not refresh or close the page. Wait for the reconfiguration process to complete.
  7. Optional: To unconfigure an existing directory server, do these steps:
    1. From the Directory Server Configuration table, select a record.
    2. Click Unconfigure.
    3. Click Yes to confirm the deletion.

What to do next

After you configure the directory server, configure the database server. If you already configured the database server, you can reconfigure it. See Managing the database server configuration.