Release Notes
One Identity Active Roles Diagnostic Tools 1.4.1
One Identity Active Roles Diagnostic Tools 1.4.1
Release Notes
October 2022
These release notes provide information about the One Identity Active Roles Diagnostic Tools release. For the most recent documents and product information, see the Active Roles online product documentation.
About Active Roles Diagnostic Tools
Release Notes > About One Identity Active Roles Diagnostic Tools 1.4.1
About One Identity Active Roles Diagnostic Tools 1.4.1
This release of Diagnostic Tools provides the following tools:
- System Checker Check your computer, SQL Server, and Active Directory domains to see if you are ready to deploy Active Roles.
- Log Viewer Examine Active Roles diagnostic logs and event logs. Find Knowledge Articles that may help you resolve errors.
- Directory Changes Monitor Get statistic of directory changes that occurred in a particular Active Directory domain.
System Checker
System Checker performs a number of checks on your computer, and produces a report allowing you to see if the computer is ready for Active Roles versions 7.2, 7.3, 7.4, or 7.5. You must fix any reported errors before you install Active Roles. In addition, you can use System Checker to see if a given SQL Server instance can host Active Roles databases and whether a given Active Directory domain can be managed by Active Roles.
System Checker performs, and reports the results of the following checks:
- System readiness checks that verify:
- The hardware prerequisites, including the amount of installed physical memory (RAM), the processor speed and architecture (x86 or x64)
- The version and edition of the Windows operating system that the computer runs
- Whether Active Roles software prerequisites are installed, including:
- Microsoft .NET Framework 4.7.2
- Windows Management Framework 5.1
- Microsoft Visual C++ 2017 Redistributable
- Microsoft OLE DB Driver for SQL Server
- Web Server (IIS)
- Windows PowerShell Execution Policy
- Azure Active Directory Module for Windows PowerShell
- Windows PowerShell Module for Lync/Skype for Business
- SharePoint Online Management Shell
- Exchange Online Remote PowerShell Module V2
- Whether the PowerShell execution policy allows running PowerShell scripts on the computer
Which system readiness checks are performed depends upon the operating system the computer runs and upon the Active Roles components you are going to install. System Checker allows you to select the desired components, and then performs only the checks that apply to the components you selected. For example, the check for the Web Server (IIS) server role is performed only if you have selected the Web Interface component.
- SQL Server checks where you specify the SQL Server instance to check, along with the connection authentication method and credentials, and get a report showing:
- Whether the specified SQL Server instance can be contacted on the network with the specified connection credentials
- Response time, which indicates how fast the SQL Server instance is
- Whether the version and edition of the SQL Server instance meet the minimum requirements for the Active Roles database server and replication
- Whether the server collation of the SQL Server instance meets the requirements for the Active Roles database server
- Whether the specified connection credentials have sufficient rights to create an Active Roles database.
- Active Directory checks where you specify the Active Directory domain or the domain controller to check, along with domain connection credentials, and get a report showing:
- Whether the specified domain or domain controller can be contacted on the network with the specified connection credentials
- Response time, which indicates how fast the domain controller is
- Whether the specified connection credentials have sufficient rights to publish the Active Roles Administration Service in the specified domain
- Whether the specified connection credentials provide sufficient rights for the Active Roles Administration Service to perform Exchange recipient management tasks in the specified domain
Log Viewer
Log Viewer enables you to browse and analyze diagnostic log files created by the Active Roles Administration Service as well as event log files created by saving the Active Roles event log in Event Viewer on the computer running the Administration Service. This tool can help you drill down through the sequence or hierarchy of requests processed by the Administration Service, identify error conditions that the Administration Service encountered during request processing, and find Knowledge Articles that apply to a given error condition.
With Log Viewer, you can open an Active Roles diagnostic log file (ds.log) or saved event log file (.evtx) and view a list of:
- Errors encountered by the Administration Service and recorded in the log file
- Requests processed by the Administration Service and traced in the log file
- All trace records found in the diagnostic log file
- All events found in the event log file
When you select an error in the list, you can choose a command to look for solution in Knowledge Base. The command performs a search in One Identity Software Knowledge Base to list the Knowledge Articles that can provide helpful information on how to troubleshoot the error you selected.
Log Viewer also enables you to:
- Search the list for a particular text string, such as an error message
- Filter the list by various conditions, to narrow the set of list items to those you are interested in
- View detailed information about each list item, such as error details, request details or stack trace
