How to get DirXML trace information

  • 10065332
  • NOVL60644
  • 12-Oct-2001
  • 31-Jan-2006

Archived Content: This information is no longer maintained and is provided 'as is' for your convenience.


How to get DirXML trace information


Novell Identity Manager 2.0

Novell DirXML 1.1a

Novell DirXML 1.1

Novell DirXML 1.0


Set DirXML trace level

DirXML and DSTRACE/ndstrace


Setting DirXML trace level  - ALL PLATFORMS: (IMPORTANT)

The DirXML trace level is controlled by a DriverSet attribute. These attribute can be added to the DriverSet object to create useful information for DirXML troubleshooting.

The three attributes that can be added are:

  • DirXML-DriverTraceLevel
  • XSLTraceLevel
  • JavaTraceFile

Normal troubleshooing should ONLY use DirXML-DriverTraceLevel.   Do NOT use the XSLTrace Level attribute unless you are debugging style sheets as it will add a lot of data to your trace screen/file.  For the JavaTraceFile the value should be a valid path and filename.  The JavaTraceFile provides basically the same information as a DSTrace.  The JavaTraceFile will keep using hard drive space as it captures information. Do NOT leave this value set for long periods of time.

To add the DirXML-DriverTraceLevel or XSLTrace Level attribute:

From ConsoleOne:

  1. Launch ConsoleOne.  
  2. Select the DriverSet object | Properties | select the Other tab | Add a new attribute (or modify the existing one).  
  3. The values of the TraceLevel attributes can be anything from 1 to 3.  TraceLevel 3 provides the most information and should be used for troubleshooting purposes.  

From iManager:

  1. Select DirXML Management | Overview
  2. Select the driverset link (above the overview graphic)
  3. Select the "Misc" tab and set the appropriate trace level from 1 to 3

Below are ways to capture and Save DirXML trace information:

Capturing driver-specific IDM trace with iManager

IDM has the capability to log driver-specific information directly to a file from the driver when configured with iManager.  This is recommended whenever possible because if you are running multiple drivers you will only have output from the relevant driver in the log.  This output is similar to the Remote Loader output in that is has just the relevant information for the relevant driver.

See  TID#10097185 [no longer available]


Capturing DirXML trace on NetWare:

DSTRACE.NLM can be used to display trace messages on the system console or trace messages to a file (DSTRACE.LOG).  

When the DSTRACE.NLM is loaded, it will display trace messages to a screen labeled DSTrace Console. 

DSTRACE SCREEN ON  Allows trace messages to appear on the DSTRACE Console. 
DSTRACE FILE ON        Captures trace messages sent to DSTRACE Console to the DSTRACE.LOG
DSTRACE FILE OFF      Stops capturing trace messages to log file
DSTRACE -ALL              Turns off all Trace flags

To display message the tags and time stamps use the following:


Capturing DirXML trace on Windows 2000:

Open Control Panel | NDS Services | Select  DSTRACE.DLM | Select Start | A window will open called NDS Server Trace Utility. 

To set the filters to capture the DirXML trace info, select Edit | Options | Select Clear All |  Check the boxes next to DirXML and DirXML Drivers | Select Ok

To capture the information to a log, select File | New.  A dialog box will ask for a filename.  Enter a filename with the extension of .LOG.  
To stop the capture of information, select File | Close and the file will be saved.


Capturing DirXML trace on UNIX: 

Trace is turned on with "ndstrace" at the console.  The "exit" command will quit the trace utility.  
The "ndstrace" command will display a screen that shows what filters are turned on and which are not.  

SET NDSTRACE=NODEBUG     Turns off all trace flags
SET NDSTRACE ON                  Captures trace messages to the file NDSTRACE.LOG in the /var/nds directory.
SET NDSTRACE FILE ON         Starts capturing trace messages to log file



iMonitor (NDSIMON.NLM (Novell Netware), NDSIMON.DLM (Microsoft Windows), ndsimonitor (Linux/Solaris/AIX/HP-UX) can be used from a web browser to get trace information:

Access iMonitor from http://<server_ip>:8008/nds (default)
In the left frame select "Trace Configuration"
In the main body, select "Clear all" then select the checkbox for "DirXML" and "DirXML Drivers" from the lower panel
Click "Trace On", then click "Trace History"
Select the document icon on the right side of the entry listed as "Current" to view the live trace

Feedback service temporarily unavailable. For content questions or problems, please contact Support.