13.12 Tracing Identity Manager Communications

DSTrace is used to trace Identity Manager communications. In a BCC, it is generally best to trace both sides of the communication channel (both drivers).

For information about setting trace levels for driver sets, see Adding Trace Levels in iManager.

For information about using ndstrace, see Using ndstrace in the Novell eDirectory 8.8 Troubleshooting Guide.

The trace messages are written to the ndstrace.log file located in the directory where eDirectory is installed. By default, it is /var/nds. You might want to delete this file before starting a trace so the events logged in the file are specific to the actions you are tracing.

To trace the communications for the BCC-specific Identity Manager drivers on a Linux BCC:

  1. Modify two attributes on both DriverSet objects:

    1. Start your Internet browser and enter the URL for iManager.

      The URL is http://server_ip_address/nps/iManager.html. Replace server_ip_address with the IP address or DNS name of the server that has iManager and the Identity Manager preconfigured templates for iManager installed.

    2. Specify your username and password, specify the tree where you want to log in, then click Login.

    3. Click the View Objects button at the top of the iManager page.

    4. In tree view, browse to and right-click the desired DriverSet object, then select Modify Object.

    5. Click the General tab, and in the list of valued attributes, click DirXML-DriverTraceLevel, then click Edit.

    6. Ensure that the Trace Level is set to 4, then click OK.

    7. Repeat Step 1.e and Step 1.f for the DirXML-XSLTraceLevel attribute, also setting the trace level to 4.

    8. Repeat Step 1.d through Step 1.g for the other driver sets you want to trace.

  2. At the Linux terminal console, log in as the root user, then start the DSTrace utility by entering

    /opt/novell/eDirectory/bin/ndstrace
    
  3. Configure DSTrace by entering

    ndstrace inline -all +dvrs +dxml +time 
    
  4. Exit the DSTrace utility by entering

    exit
    
  5. Enable DSTrace by again entering ndstrace on at the Linux terminal console.

  6. Run the desired actions for the information you want traced.

  7. Disable DSTrace by entering ndstrace off at the Linux terminal console.