How do I gather DRA Diagnostic Logs for Technical Support? (NETIQKB72935)

  • 7016868
  • 25-Sep-2015
  • 25-Sep-2015

Environment


Directory & Resource Administrator 8.6
Directory & Resource Administrator 8.7
NetIQ Directory & Resource Administrator 8.7
NetIQ Directory & Resource Administrator 8.6

Situation

How do I use the Directory and Resource Administrator diagnostic utility (DRADiagnosticUtil.exe)?

How do I gather Diagnostic Logs for Technical Support?
Resolution

Resolution

By default the Dradiagnostic utility is installed on the DRA server. This utility is located in the <Path to DRA Installation folder>\DRA\DraDiagnosticUtil.exe, and must be launched locally on the DRA server or Remote 32 bit Console machine experiencing the issue(s).

Below is the list of the 4 basic options presented to the user in the first window of the diag utility. Extended details of sub-options within those options follows below the list.

Enable or change logging for a DRA component -- This option is used when the logging level for a component / service of DRA is required to be changed.
Collect Diagnostic information about a DRA failure -- This option will give the user the option to choose which items are needed to be collected.
View Accounts Provider Job (APJS) Diagnostics --
View lock diagnostics for Read / Write and Replication Locks


Enable or change logging for a DRA component:

 For all items listed below, TS will often ask the customer to set the log level to 10-All; unless asked differently. Also the Find Logs button, will open a windows explorer window to the path of the log files.

Service -- Netiq Administration Service (Only used on the DRA Server)
DOM Files -- DOM files containing a cache of the managed domains specific to the DRA Console (or DRA Server) on which the utility is being run.
Delegation and Configuration Console -- Also known as the DN&C Console, used to perform admin actions and configuration of DRA
Web Console -- Log settings for the Webconsole , specific to the DRA server hosting the web console
ADSI Scripts --
Core Service -- NetIQ DRA Core Service , used for communication to the Log Archive Server on each DRA Server, and also for DRA Reporting collectors
Once you have set the correct log levels click finish to apply the new levels.

Collect Diagnostic information about a DRA failure 

This option will have 8 preconfigured log settings, and a 9th for Other. Choosing Other will allow the user to pick specific options to collect logs from.
The first section of the Diagnostic Settings window is related to the Windows Event Logs and general DRA environmental configuration settings. **Note the Windows Event Logs can often result in a larger diagnostic log zip file.**
The Second section is used to collect specific settings about the DRA Server. The pre-configured logging options will pre-populate these check boxes, whereas the 'Other' option will check all the boxes. TS may direct the customer to choose very specific settings. ** Note the Domain Cache files can often result in a larger diagnostic log zip file. **
The last section Client Diagnostics Settings here only apply to the Consoles locally installed on the Server / workstation running the DRA Diag Utility. Also the web console logs are collected via check boxes here as well.
Once you have set the various logging options, click Next to continue. The next steps will prompt you for a location to store the temp files used to build the master log zip file. You will also have the option of choosing a location to save the Zip file.