15.1 Adding Trace Levels in Designer

You can add trace levels to the driver set or to each driver.

15.1.1 Driver

  1. In an open project in Designer, select the driver in the Outline view.

  2. Right-click and select Properties, then click 8. Trace.

  3. Set the parameters for tracing., then click OK. See Table 15-1 for more information about the driver trace parameters.

    If you set the parameters on the driver only, only information for that driver appears in the DSTrace log.

Table 15-1 Druver Trace Parameters

Parameter

Description

Tace level

As the driver trace level increases, the amount of information displayed in DSTrace increases.

Trace level one shows errors, but not the cause of the errors. If you want to see password synchronization information, set the trace level to five.

If you select Use setting from Driver Set, the value is taken from the driver set.

Trace file

Specify a file name an location of where the Identity Manager information is written for the selected driver.

If you select Use setting from Driver Set, the value is taken from the driver set.

Trace file encoding

The trace file uses the system’s default encoding. You can specify another encoding if desired.

Trace file size limit

Allows you to set a limit for the Java trace file. If you set the file size to unlimited, the file grows in size until there is no disk space left.

NOTE:The trace file is created in multiple files. Identity Manager automatically divides the maximum file size by ten and creates ten separate files. The combined size of these files equals the maximum trace file size.

If you select Use setting from Driver Set, the value is taken from the driver set.

Trace name

The driver trace messages are prepended with the value entered instead of the driver name. Use if the driver name is very long.

15.1.2 Driver Set

Setting the trace level on the driver set creates very long traces that are hard to read. All events from all drivers are included in one trace file. If you are troubleshooting an issue, it is best to set the trace only on the driver you are troubleshooting.

  1. In an open project in Designer, select the driver set in the Outline view.

    Selecting the Driver Set object
  2. Right-click and select Properties, then click 5. Trace.

  3. Set the parameters for tracing, then click OK. See Table 15-2 for more information about the driver set trace parameters.

    If you set the trace level on the driver set, all drivers appear in the DSTrace logs.

Table 15-2 Driver Set Trace Parameters

Parameter

Description

Driver trace level

As the driver trace level increases, the amount of information displayed in DSTrace increases.

Trace level one shows errors, but not the cause of the errors. If you want to see password synchronization information, set the trace level to five.

XSL trace level

DSTrace displays XSL events. Only set this trace level when troubleshooting XSL style sheets. If you do not want to see XSL information, set the level to zero.

Java debug port

Allows developers to attach a Java debugger.

Java trace file

When a value is set in this field, all Java information for the driver set is written to a file. The value for this field is the patch for that file.

As long as the file is specified, Java information is written to this file. If you do not need to debug Java, leave this field blank.

Trace file size limit

Allows you to set a limit for the Java trace file. If you set the file size to unlimited, the file grows in size until there is no disk space left.

NOTE:The trace file is created in multiple files. Identity Manager automatically divides the maximum file size by ten and creates ten separate files. The combined size of these files equals the maximum trace file size.