Identity Manager processes are saved to a file by using a parameter on the driver or through DSTrace. The parameter on the driver is the Trace file parameter.
The driver processed that are captured through DSTrace are the processes that occur on the Identity Manager engine. If you use the Remote Loader, you need to capture a trace on the Remote Loader at the same time as you are capturing the trace on the Identity Manager engine.
The following methods helps you capture and save Identity Manager processes through DSTrace on different OS platforms.
Open the Control Panel >
> , then click .A window opens named NDS Server Trace Utility.
Select
> , then click .This clears all of the default flags.
Select
and .Click
.Select
.Specify the filename and location of where you want the DSTrace information saved, then click
.Wait for the event to occur.
Select
.This stops the information from being written to the log file.
Open the file in a text editor and search for the event or the object you modified.
Enter ndstrace to start the ndstrace utility.
Enter set ndstrace=nodebug
Turns off all trace flags currently set.
Enter set ndstrace on
Displays trace messages to the console.
Enter set ndstrace file on
Captures trace messages to the file ndstrace.log the directory where eDirectory is installed. By default it is /var/nds.
Enter set ndstrace=+dxml
Displays the Identity Manager events.
Enter set ndstrace=+dvrs
Displays the Identity Manager driver events.
Wait for the event to occur.
Enter set ndstrace file off
This stops the logging of information to the file.
Enter exit to quit the ndstrace utility.
Open the file in a text editor. Search for the event or the object that was modified.
iMonitor allows you to get DSTrace information from a web browser. It does not matter where Identity Manager is running. These are the files that run iMonitor:
NDSIMON.DLM Runs on Windows.
ndsimonitor Runs on UNIX.
Access iMonitor from http://server_ip:8008/nds.
Port 8008 is the default port.
Enter a username and password with administrative rights, then click
.Select
on the left side.Click
.Select
.Click
.Select
on the left side.Click the document with the
of to see a live trace.Change the
if you want to see information more often.Select
on the left side, then click to turn the tracing off.You can view the trace history by selecting Trace History. The files are distinguished by their time stamps.
If you need a copy of the HTML file, the default location is:
Windows: Drive_letter:\Novell\NDS\ndsimon\dstrace\*.htm
UNIX/Linux: /var/nds/dstrace/*.htm
You can capture the events that occur on the machine running the Remote Loader service.
Launch the Remote Loader Console by clicking the icon.
Select the driver instance, then click
.Set the
to 3 or above.Specify a location and file for the trace file.
Specify the amount of disk space that the file is allowed.
Click
twice to save the changes.You can also enable tracing from the command line by using the following switches. For more information, see Configuring the Remote Loader
in the Identity Manager 4.0.1 Remote Loader Guide.
Table 15-3 Command Line Tracing Switches
Switch |
Secondary Name |
Parameter |
Description |
---|---|---|---|
-trace |
-t |
integer |
Specifies the trace level. This is only used when hosting an application shim. Trace levels correspond to those used on the Identity Manager server. Example: -trace 3 or -t3 |
-tracefile |
-tf |
filename |
Specify a file to write trace messages to. Trace messages are written to the file if the trace level is greater than zero. Trace messages are written to the file even if the trace window is not open. Example: -tracefile c:\temp\trace.txt or -tf c:\temp\trace.txt |
-tracefilemax |
-tfm |
size |
Specifies the approximate maximum size that trace file data can occupy on disk. If you specify this option, there is a trace file with the name specified using the tracefile option and up to 9 additional “roll-over” files. The roll-over files are named using the base of the main trace filename plus “_n”, where n is 1 through 9. The size parameter is the number of bytes. Specify the size by using the suffixes K, M, or G for kilobytes, megabytes, or gigabytes. If the trace file data is larger than the specified maximum when the Remote Loader is started, the trace file data remains larger than the specified maximum until roll-over is completed through all 10 files. Example: -tracefilemax 1000M or -tfm 1000M |