Active Roles Diagnostic Tools
The Active Roles Diagnostic Tools package provides optional tools for checking system requirements, logs and changes in your Active Directory domain. The package contains the following tools:
-
System Checker: Checks your computer, SQL Server, and Active Directory domains to see if you are ready to deploy Active Roles. For more information on using the tool, see Using System Checker.
-
Log Viewer: Examines Active Roles diagnostic logs and event logs, and helps finding Knowledge Base Articles that may help you resolve errors.
-
Directory Changes Monitor: Gets the statistics of directory change operations that occurred in a particular Active Directory domain.
For more information on installing the Active Roles Diagnostic Tools package, see Steps to install Diagnostic Tools in the Active Roles Quick Start Guide.
Using System Checker
You can start System Checker by running the Active Roles System Checker application from the Start menu or Apps page, depending upon your version of the Windows operating system.
From the System Checker main window, you can perform the following tasks:
-
To check your computer, click System Readiness Checks, then select the appropriate Active Roles version for which to perform the checks.
-
To check a particular SQL Server instance, click SQL Server Checks and specify the SQL Server instance to check. You can also specify the authentication method and connection credentials for access to the SQL Server instance.
-
To check a particular Active Directory domain or a particular Domain Controller (DC), click Active Directory Checks and specify the name of the domain or the name of the DC. You can also specify connection credentials for access to the domain or DC.
System Checker then creates a report of the selected action, and displays it in its report viewer. Reports are divided into sections, each of which represents the results of a single check. If a report section includes any errors or warning messages, you can view the messages by expanding the section in the report viewer.
The report viewer also allows you to:
-
Print the report.
-
Export the report to an HTML file, so that you can open the report in a web browser later.
-
Save the report to a report file, so that you can open the saved report in the report viewer later.
-
Open a saved report by clicking Open in the main menu of System Checker, and selecting the report file.
-
Rebuild the report, and optionally also changing the report options.
To rebuild the report, click Recheck on the toolbar of the report viewer.
Using the Log Viewer tool
You can run the Active Roles Log Viewer application from the Start menu or from the Apps page, depending on the version of your Windows operating system. Alternatively, you can also start the application by navigating to its .exe file in the installation folder:
\Active Roles Diagnostic Tools\Log Viewer\arlogviewer.exe
To open a log in Log Viewer
-
In the Active Roles Log Viewer application, click Open.
-
Browse to the diagnostic log file or saved event log file you want to open.
-
Select the file, and click Open.
By default, Log Viewer displays a list of errors encountered by the Administration Service and recorded in the log file. To analyze these errors further, and look for information about them, right-click an error in the list, then click Look for solution in Knowledge Base. Log Viewer then searches the One Identity Knowledge Base to list the Knowledge Base Articles related to the error you selected.
Additional tasks in Log Viewer
Besides opening and troubleshooting logs, you can also perform the following tasks in Log Viewer:
-
To view a list of requests processed by the Administration Service and traced in the log file, click Requests in the View area on the Log Viewer toolbar.
-
To view all trace records found in the diagnostic log file or all events found in the event log file, click Raw log records in the View area on the Log Viewer toolbar.
-
To search the list for a particular text string, such as an error message, type the text string in the Search box on the Log Viewer toolbar, then press Enter.
-
To narrow the set of list items to those you are interested in, click Filter on the Log Viewer toolbar and specify the desired filter conditions.
-
To view detailed information about an error, request, trace record or event, right-click the corresponding list item, and click Details.
-
To view all trace records that apply to a given request, right-click the corresponding item in the Requests list and click Stack trace.
NOTE: Stack tracing is not available for event log files.
-
To view the request that caused a given error, right-click the error in the Errors list and click Related request. This task is unavailable in case of an event log file.
NOTE: Stack tracing is not available for event log files.
-
To view all trace records that apply to the request that caused a given error, right-click the error in the Errors list and click Stack trace for related request. This task is unavailable in case of an event log file.
Using the Directory Changes Monitor command-line interface
Active Roles Directory Changes Monitor is a command-line tool.
To run Directory Changes Monitor
-
Open the Windows command prompt.
-
Navigate to the folder where Directory Changes Monitor is installed.
-
Run the tool with the appropriate parameters.
TIP: To list the available parameters, run the following command:
dirchangesmon.exe /?
NOTE: Directory Changes Monitor has a single required parameter, /TargetDC, specifying the Domain Controller (DC) of the Active Directory domain from which to get directory change statistics. To retrieve information from a domain, make sure to run Directory Changes Monitor with a domain user account of that domain, or from a trusted domain.