Troubleshoot Directory Server

Unfortunately, even reliable servers such as the Directory Server sometimes have problems. When your Directory Server has problems, the following information can help you figure out what is wrong and how to fix the trouble.

You can find return codes for LDAP errors in the ldap.h file, which is located on your system in QSYSINC/H.LDAP.

Monitor errors and access with the Directory Server job log
When you get an error on your Directory Server and want more details, another action to take is to view the QDIRSRV job log.

Use TRCTCPAPP to help find problems
For reproducible errors, you can use Trace TCP/IP Application (TRCTCPAPP APP(*DIRSRV)) command to run a trace of the errors.

Use the LDAP_OPT_DEBUG option to trace errors
Trace problems with clients that are using the LDAP C APIs.

Common LDAP client errors
Knowing the causes of common LDAP client errors can help you to solve problems with your server.

Password policy-related errors
Enabling a password policy can sometimes cause unexpected errors.

Troubleshooting the QGLDCPYVL API
Using the User Trace facility may explain the error or determine if service is needed.

For additional information about common Directory Server problems, see the Directory Server home page Link outside the Information Center (www.iseries.ibm.com/ldap).

Directory Server uses several Structured Query Language (SQL) servers which are iSeries QSQSRVR jobs. When an SQL error occurs, the QDIRSRV job log will usually contain the following message:

SQL error -1 occurred

In these instances the QDIRSRV job log will refer you to the SQL server job logs. However, in some cases QDIRSRV might not contain this message and this referral, even if an SQL server is the cause of the problem. In these instances, it will help you to know what SQL server jobs the server started, so that you know in which QSQSRVR job logs to look for additional errors.

When the Directory Server starts normally, it generates messages similar to the following:

                                                             System:   MYISERIES
 Job . . :   QDIRSRV       User . . :   QDIRSRV       Number . . . :   174440

  >> CALL PGM(QSYS/QGLDSVR)
     Job 057448/QUSER/QSQSRVR used for SQL server mode processing.
     Job 057340/QUSER/QSQSRVR used for SQL server mode processing.
     Job 057448/QUSER/QSQSRVR used for SQL server mode processing.
     Job 057166/QUSER/QSQSRVR used for SQL server mode processing.
     Job 057279/QUSER/QSQSRVR used for SQL server mode processing.
	  Job 057288/QUSER/QSQSRVR used for SQL server mode processing.
     Directory Server started successfully.

The messages refer to the QSQSRVR jobs that were started for the server. The number of messages might differ on your server depending on the configuration and the number of QSQSRVR jobs needed to accomplish server startup.

On the directory servers Database/Suffixes Properties page in iSeries Navigator you specify the total number of SQL servers that Directory Server uses for directory operations after server startup. Additional SQL servers are started for replication.