Previous TopicNext Topic

Agent Installation Failures Report

The ADSelfService Plus login agent helps keep Windows, macOS, and Linux machines protected using MFA. It also enables users to reset their passwords and unlock their accounts directly from the login screen of their machines.

The Agent Installation Failures Report displays the list of Windows, macOS, or Linux machines on which the scheduled installation of the login agent failed. This report provides details related to the agent installation failures, such as the IP addresses and names of the machines on which the installation failed, the OSs running on those machines, the OUs or groups to which the machines belong, and the error messages thrown during the installation failures.

You can generate the Agent Installation Failures Report by following these steps:

1. Log in to the ADSelfService Plus admin portal with administrator or operator privileges and navigate to Reports > GINA/macOS/Linux Agent Reports > Agent Installation Failures Report.
2. Specify the domain in which to search using the Select Domain option.
3. Specify the OUs (if necessary) using the Select OUs option.
4. Click Generate.

Advanced filtering

Once the report is generated, you can narrow down the entries based on the following parameters by clicking the Advanced Filter ( ) icon on the far right of the report:

• Computer Name: This option lets you narrow down the failed agent installation attempts by the username. The conditions available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With.
• IP Address: This option lets you display the results by the IP address. The conditions available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With.
• Location: This option lets you display the failed agent installation results by the location of the machine in the domain. The conditions available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With.

Sorting

Click any of the columns to view the report's entries in ascending or descending order.

Searching

• Click the search icon ( ) to search for specific data in the report.
• Search for specific users using their Computer Name.
• Search using the criteria Contains. For example, if the word jack is searched for using the Username column, then all the usernames containing the sequence jack will be displayed as a result.

Schedule Reports, Export As, and More

• The Schedule Reports option can be used to schedule the generation of reports at specified intervals and to automatically email them to administrators or specific email addresses. Learn how to schedule reports here.
• The Export As option in the top-right corner of the page lets you export the report in CSV, PDF, XLS, XLSX, HTML, or CSVDE format.
• The More option in the top-right corner of the page lists the Printable View, Send Mail, and Export Settings options.
• The Printable View option can be used to preview and print the report.
• The Send Mail option can be used to email the report to the desired email addresses.
• Additionally, you can configure custom Export Settings, such as a personalized title for the report and a header logo that you may wish to display on each page.

Previous TopicNext Topic