Capturing DirXML Trace Information
Novell Cool Solutions: Tip
Digg This -
Posted: 11 Mar 2002
Here are a few tips from Novell Support to help you capture DirXML trace information on a variety of platforms.
For full details and updates regarding this tip, see TID-10065332.On NetWare:
DSTRACE.NLM can be used to display trace messages on the NetWare system console. Trace messages can also be logged to a file (DSTRACE.LOG) using DSTRACE.NLM. DSTRACE.NLM displays messages to a screen labeled DSTrace Console. Any system console screen label can be seen on the top of the server screen when holding down the system console's ALT key. After loading DSTRACE.NLM, type DSTRACE to see the current settings of the NLM. An easy way to configure dstrace.nlm to display only DirXML trace messages is: DSTRACE -ALL +DXML +DVRS. If you would like to display message tags and time stamps use the following: DSTRACE -ALL +DXML +DVRS +TAGS +TIME.
Another method of displaying trace messages is to use the internal trace of ds.nlm.
- The internal trace method can be displayed to the system console screen by entering the following set command at the system console: set dstrace=on. Once the internal dstrace is turned on, a system console screen labeled Directory Services is available for view. Any system console screen label can be seen on the top of the screen when holding down the ALT key.
- To turn on DirXML trace messages for this trace screen enter: set dstrace=+DXML.
- To turn off DirXML trace messages for this trace screen enter: set dstrace=-DXML.
- To turn on DirXML driver trace messages for this trace screen enter: set dstrace=+DVRS.
- To turn off DirXML driver trace messages for this trace screen enter: set dstrace=-DVRS.
- To turn off the internal trace screen enter: set dstrace=off.
- The internal version of trace can be saved by typing TTF=ON.
- All the trace screen information will be saved to a DSTRACE.DBG file in SYS:/SYSTEM.
- TTF=OFF turns off trace file logging.
- Set DSTrace=*r after the TTF=on will reset the DSTRACE.DBG file.
On Windows 2000:
In the Control Panel, there is a NDS Services icon. In NDS Services there is a DSTRACE.DLM. When that service is started a text window pops up. To set the filters to capture the DirXML trace info, select Edit | Options. A screen displays a number of check boxes. Check the boxes that say DirXML and DirXML Drivers. Uncheck everything else.
To capture the information, select File | New. A dialog box will ask for a filename. Enter a filename with the extension of LOG. When all the needed information is captured select File | Close and the file will be saved.
Solaris is similar to NetWare.
- The 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.
- To turn all filters off: set ndstrace=nodebug.
- To turn the DirXML filters on: set ndstrace=+dxml, then a set ndstrace=+dvrs.
- To capture the trace information: ndstrace file on.
- To turn the file off: ndstrace file off.
- The trace log file by default is located in /var/nds directory and is called NDSTRACE.LOG.
Important Note for all Platforms:The amount of DirXML driver information that is traced can be controlled by a DriverSet attribute. There are three possible attributes that can be added to the DriverSet object to create useful information for DirXML troubleshooting. DirXML-DriverTraceLevel, XSLTraceLevel, and JavaTraceFile. To create (or modify) any of the three settings use ConsoleOne. Select the DriverSet object, go to Properties, select the Other tab, Add a new attribute (or modify the existing one). Add the desired attribute depending on what information is needed. The values of the TraceLevel attributes can be anything from 1 to 3. 3 provides the most information and should be used for troubleshooting purposes. You shouldn't set the XSLT Trace Level attribute unless you are debugging stylesheets since 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 so do not leave this value set for long periods of time.
A side note:
Another method of displaying trace messages is to use the NDSiMon utility. This is a web management tool that can be used to view DSTrace messages from any Web browser.
Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions. www.webwiseone.com