To Enable Trace for PasswordSync (Oracle Waveset 8.1.1 System Administrator's Guide)

Oracle Waveset 8.1.1 System Administrator's Guide

To Enable Trace for PasswordSync

You can use the following methods to configure tracing for Waveset’s PasswordSync feature:

Using the PasswordSync Configuration Tool

This section describes how to configure tracing from the PasswordSync Configuration Trace tab.

Note –

For more information about installing and configuring PasswordSync, see Chapter 11, PasswordSync, in Oracle Waveset 8.1.1 Business Administrator’s Guide.

The first time you run the configuration tool, the wizard does not allow you to configure tracing. Subsequently, when you run the configuration tool, the wizard displays a Trace tab where you can configure tracing.

The following figure shows the PasswordSync Configuration tool Trace tab.

Figure 5–2 Trace Tab in the PasswordSync Configuration Tool

Example Password Configuration screen showing the Trace
tab.

From this tab, you can specify the following:

Use the Trace Level field to specify the level of detail you want PasswordSync to provide when writing to the trace log. A value of 0 turns tracing off, while a value of 4 shows full detail.
Use the Max File Size field to specify a maximum size for the log file.

When the trace file exceeds the size specified in the Max File Size (MB) field, PasswordSync starts a new trace file and appends .bk to the old trace file name. For example, if your trace level is set to 100 Mbytes, and your trace file writes to C:\logs\pwicsvc.log, when the trace file exceeds 100 Mbytes PasswordSync renames the file to C:\logs\pwicsvc.log.bk. PasswordSync then creates a new C:\logs\pwicsvc.log file where new trace file messages are written.
Use the Trace File field to specify a location for the PasswordSync trace file.

Editing the Registry Keys

To enable additional PasswordSync configuration settings, edit the following PasswordSync registry keys using the PasswordSync configuration tool.

Note –

Using PasswordSync configuration tool is the safest method for editing PasswordSync registry keys. Editing these keys directly in the Windows Registry is discouraged.

Table 5–3 Registry Keys


Key Name	Type	Description
`dumpFilebase`	`REG_SZ`	Set this registry key to enable Windows to generate a dump file if the PasswordSync DLL displays an exception. You must set this registry key to the fully qualified directory path where you want to write the memory dump. For example: `c:\temp` Set the registry value to write the memory dump each time Waveset catches an exception during password processing. Note: On Windows 2000 server (any service pack), you also must install in the configured directory `DbgHelp.dll`, which is available from Microsoft. The minimum release version for the `DbgHelp.dll` file must be Version 5.1. Download the `DbgHelp.dll` file here: `http://www.microsoft.com/whdc/DevTools/Debugging/default.mspx` If `DbgHelp.dll` is not installed, no dump files will be generated on Windows 2000. The format for dump file names is `lhpwic-YYYYMMDD-HHmm-xxxxx.dmp` In this name, `YYYYMMDD` will be the date of the dump, `HHmm` is the time of the dump (24-hour clock), and `xxxxx` is the thread number of the application. You must manually remove dump files! Dump files range in size from 20 MB to more than 100 MB, depending on the size of the Windows Local Security Authority Subsystem (LSASS) process. Over time, systems with limited disk space could fill up if these dump files are not removed.
`installdir`	`REG_SZ`	Directory where the PasswordSync application is installed.

The PasswordSync registry keys are located in the following location:

HKEY_LOCAL_MACHINE\SOFTWARE\Sun Microsystems\Sun Identity Manager\Passwordsync

Other keys are present in this location.