Getting started with Active Roles Diagnostic Tools
Release Notes > Getting started with Active Roles Diagnostic Tools 1.4.0
Getting started with Active Roles Diagnostic Tools 1.4.0
To install Active Roles Diagnostic Tools, run the file ActiveRolesDiagnosticTools.msi, and follow the instructions in the Setup wizard.
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, select the Active Roles version 7.0, 7.1, 7.2, 7.3, or 7.4, and select the Active Roles components 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, click Active Directory Checks and specify the name of the domain or the name of the domain controller. You can also specify connection credentials for access to the domain/domain controller.
System Checker creates a report depending upon what you selected to check, and displays the report in the report viewer. Reports are divided into sections each of which represents the results of a single check (for a list of all possible checks, see System Checker earlier in this document). If a given report section includes any error 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 you can open the report in a Web browser
- Save the report to a report file, so you can open the saved report in the report viewer
- To open a saved report, click Open in the System Checker main widow and select the report file.
- Rebuild the report, possibly changing the report options
To rebuild the report, click Recheck on the toolbar in the report viewer.
Using Log Viewer
You can start Log Viewer by running the Active Roles Log Viewer application from the Start menu or Apps page, depending upon your version of the Windows operating system.
Once you have started Log Viewer, open your Active Roles diagnostic log file or saved event log file: Click Open on the Log Viewer toolbar, and supply the path and name of the log file.
By default, Log Viewer displays a list of errors encountered by the Administration Service and recorded in the log file. You can use Log Viewer to look for information on how to troubleshoot a given error: Right-click the error in the list and then click Look for solution in Knowledge Base. Log Viewer performs a search in all the Knowledge Bases to list the Knowledge Articles that apply to the error you selected.
Other tasks you can perform:
- 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 and 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. This task is unavailable in case of an event log file.
- 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.
- 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.