Troubleshooting Directory Server

 

Information to help you solve problems. Includes suggestions for collecting service data and solving specific problems.

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.

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

Directory Server uses several Structured Query Language (SQL) servers which are 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:   MYSYSTEM  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.

• Monitoring 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.

• Using 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.

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

• GLEnnnn message identifiers
  This information lists the GLE message identifiers and their descriptions.

• Common LDAP client errors
  This information describes common LDAP client errors.

• 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.

 

Parent topic:

IBM Directory Server for iSeries (LDAP)

 

Related information

Directory Server home page