Test an LDAP server for user registry failover

After configuring a LDAP host for failover you should test the failover server by stopping the main LDAP server.

This task assumes the following setup:

• dmgr is installed on the primary LDAP server running Application Server version 6.0.2 or higher.

• All other LDAP hosts are Active Directory machines with similar user registry designs.

• At least one of the other LDAP hosts has been configured for failover.

This topic references one or more of the application server log files. As a recommended alternative, we can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files on distributed and IBM i systems. We can also use HPEL in conjunction with the native z/OS logging facilities. If we are using HPEL, we can access all of the log and trace information using the LogViewer command-line tool from the server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.

1. Stop the Active Directory Server on the failover server.

2. Start the deployment manager process.

   1. Start the Command Prompt application.

   2. (iseries) Change directories to profile_root/bin.

   3. (dist)(zos) Change directories to profile_root\bin.

   4. Enter startManager.

3. Review the SystemOut.log file to see if the LDAP failover happened. The sample text is an example of a SystemOut.log file that records a successful failover:

   [7/11/05 15:38:31:324 EDT] 0000000a LdapRegistryI A   SECJ0418I:  Cannot connect to the LDAP server ldap://xxxx.xxxxx.xxxx.com:NNN. {primary LDAP server}
   [7/11/05 15:38:32:486 EDT] 0000000a UserRegistryI A   SECJ0136I:  Custom Registry:com.ibm.ws.security.registry.ldap.LdapRegistryImpl has been initialized
   [7/11/05 15:38:53:787 EDT] 0000000a LdapRegistryI A   SECJ0419I:  The user registry is currently connected to the LDAP server ldap://xxxx.xxxxx.xxxx.com:NNN. {failover LDAP server}
    [7/11/05 15:39:35:667 EDT] 0000000a WsServerImpl  A   WSVR0001I: Server dmgr open for e-business 

4. Log into the console to see working and non-working cases.

   1. Start a browser.

   2. Browse to http://localhost:9060/admin.

   3. Type in the user ID and password and click OK.

   4. Log out of the Administrative Console.

   5. Type in DummyAdmin as the user ID and dummy1admin as the password and click OK. This should fail proving WebSphere Application Server is connected to the other LDAP server. Please make sure that on a production system the user registries are identical so this problem does not happen when switching between LDAP servers.

5. Stop the deployment manager.

   1. Start the Command Prompt application.

   2. (iseries) Change directories to profile_root/bin.

   3. (dist)(zos) Change directories to profile_root\bin.

   4. To stop the deployment manager, enter the following command:
      stopManager -user username -password password

Related tasks

Configure multiple LDAP servers for user registry failover

Configure Lightweight Directory Access Protocol user registries