Novell Home

My Favorites

Close

Please to see your favorites.

How to get DirXML trace information

(Last modified: 31Jan2006)

This document (10065332) is provided subject to the disclaimer at the end of this document.

goal

How to get DirXML trace information

fact

Novell Identity Manager 2.0

Novell DirXML 1.1a

Novell DirXML 1.1

Novell DirXML 1.0

symptom

Set DirXML trace level

DirXML and DSTRACE/ndstrace

fix

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
DSTRACE +DXML
DSTRACE +DVRS    

To display message the tags and time stamps use the following:
DSTRACE +TAGS
DSTRACE +TIME

***********************************************


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
SET NDSTRACE=+DXML
SET NDSTRACE=+DVRS

 

note

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

disclaimer

The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.

  • Document ID:
  • 10065332
  • Solution ID: NOVL60644
  • Creation Date: 12Oct2001
  • Modified Date: 31Jan2006
    • NetIQeDirectory

Did this document solve your problem? Provide Feedback