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 has 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 operating systems running on those machines, the OU or Group to which the machines belong, and the error message thrown during installation failure.

Report generation

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

1. Log into 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 using the Select Domain option.
3. Specify OUs (if necessary) using the Select OUs option.
4. Click Generate to generate the report.

Advanced Filtering

• Once the report is generated, the entries can be narrowed-down based on the following parameters by clicking on the Advanced Filter [] icon at the far right of the report



1. Computer Name: This option lets you narrow-down the failed agent installation attempts by username. The conditions available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With.
2. IP Address: This option lets you display results by IP address. The conditions available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With.
3. 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 on any of the columns (except the Status column) to view the report's entries in ascending or descending order.

Searching

1. Click on the search icon[ ] in order to search for specific data in the report.
2. Specific users can be searched for using their Computer Name.
3. Searching happens using the criteria 'contains'. For example, if the username column is searched for the word "jack" , then all machine names 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 automatically email them to administrators or specific email addresses. Learn to schedule reports here.
• The Export As option at the right corner of the page helps export the report in CSV, PDF, XLS, XLSX, HTML and CSVDE formats.
• The More option at the 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 mail 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.