Troubleshooting
Problem
In order to debug issues involving a failed server start up or to trace a specific operation from a fresh server start, it is often useful to collect an binary trace.
Resolving The Problem
Binary Server Trace Instructions:
1. Stop the LDAP server process, if running.
From a command prompt, type:
ibmslapd -I <instance name> -k
2. Determine whether or not tracing is currently enabled.
From a command prompt, type:
ldtrc info
If trace is enabled issue the following command:
ldtrc off
3. Enable binary tracing.
From a command prompt, type:
ldtrc on -t -l 50000000
In the above command, the value for the buffer size is 50
million-byte. This will keep the last 50 million bytes of trace
record data in shared memory (i.e. it flushes the oldest data once
the 50 MB value is reached). If for some reason the command fails
due to what may appear to be not enough shared memory resources,
feel free to scale the number down, but less than 20 million may
not provide the information desired.
4. Start LDAP server
ibmslapd -I <instance name> -n
5. Recreate the Problem
Reproduce the error or condition you want to trace.
6. Collect the trace records
Once the error or the condition you want to trace occurs, immediately issue the following command:
ldtrc dump trace.raw
Where trace.raw is the pathname and filename that will be used to
capture the records in shared memory.
7. Copy the trace.raw file into the <ITDS install home>/etc directory
For SDS/TDS v6.n: (replace n with appropriate release number such as 4, 3.1, 3, 2, 1, or 0 as applicable in your case).
On AIX, HP and Solaris: /opt/IBM/ldap/V6.n/etc
On Linux: /opt/ibm/ldap/V6.n/etc
On Windows: <Install_Drive>:\Program Files\IBM\LDAP\V6.n\etc
8. Collect the Format and Flow of the Binary Trace
cd to the etc directory as shown in step 7
ldtrc fmt trace.raw trace.fmt
ldtrc flw trace.raw trace.flw
Provide the trace.fmt and trace.flw files to support
9. Disable Tracing
From a command prompt, type:
ldtrc off
Related Information
Product Synonym
ITDS;TDS;IBM Tivoli Directory Server;Tivoli Directory Server
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21268262