Perform Bot Agent diagnostic checks
- Updated: 2023/01/13
Use the Bot Agent diagnostic utility for connectivity-related issues between the Bot Runner device and Control Room. The utility helps to diagnose issues either by providing solutions or suggestions to help resolve the issues.
Prerequisites
Ensure the Bot Agent is installed on the user device.
Procedure
- Open the Windows command prompt.
-
Navigate to the Bot Agent installation path.
- Default path for Bot Agent installed at system level is C:\Program Files\Automation Anywhere\Bot Agent.
- Default path for Bot Agent installed at local user level is %USERPROFILE%\AppData\Local\Programs\Automation Anywhere\Bot Agent.
-
Enter AADiagnosticUtility.exe to run the Bot Agent diagnostic utility.
Various options to perform the diagnostic check are displayed with their descriptions.
Option Description -checkDownloadError <CR_URL>Check for bot dependency download errors if the bot deployment fails. Note: Error messages are maintained in the device memory and are removed when the Bot Agent service is restarted.Use this option when the Bot Runner device is connected to the Control Room but automations fail because the dependent packages are not downloaded on the Bot Runner device. In this case, the utility provides suggestions for further diagnosis.
-checkProxy <CR_URL>Check the proxy settings on the device. When the Bot Runner device is unable to connect to the Control Room, use this option to verify if a proxy is available or configured for the Bot Agent to use.
You are also provided the option to import proxy settings using the
importProxyoption.Note: Your device proxy settings for authenticated proxy can be set during the Bot Agent registration process and can be updated through the Bot Agent diagnostic utility. The same credentials are used for all users on the device.-checkWSError <CR_URL>Check for WebSocket connectivity and errors. Note: Error messages are maintained in the device memory and are removed when the Bot Agent service is restarted from Services tab of the Windows Task Manager.When a Bot Runner device is unable to connect to the Control Room because of WebSocket connection errors, this option provides the possible reasons for further investigation.
-collectLogsReduce the turnaround time for collecting information on issues by capturing multiple logs for the Bot Runner device. Use this option to capture and save current day node manager, bot launcher, and event viewer logs for debugging and troubleshooting in a zipped folder on the device where the utility is being run.- For Bot Agent installed at system level, the logs are saved in C:\ProgramData\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip
- For Bot Agent installed at local-user level, the logs are saved in %USERPROFILE%\AppData\Local\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip
Note:- To capture Windows logs for security events,
run the utility with elevated privileges (run as
administrator).
If you run the utility without elevated privileges, the following error is displayed:
Error: Unable to capture security_event_viewer_<date>.evtx
- To save storage space, delete the file after debugging.
-configProxy <CR_URL>Check proxy configuration and configure proxy credentials, if required. When the Bot Runner device is unable to connect to the Control Room because of missing credentials for an authenticated server, use this option to configure the proxy server credentials. Verify that the connectivity problem is resolved by logging in to the Control Room.
-importProxy <CR_URL>Import the proxy settings from a logged-in user device to the system user device. Note: You must have administrator permission to import proxy settings.When the Bot Runner device is unable to connect to the Control Room because of proxy server issues, use this option to import the proxy settings from a logged-in user to the system user for the Bot Agent.
This option provides information about the following:- Whether the proxy server is authenticated or not.
- Control Room URL is added to the safe recipients list in the proxy server.
- WebSocket connections are allowed as part of the proxy configuration.
-importSSLCertificate path_to_ssl_certificateImport a SSL certificate into the Java credential store, if required. Note: You must have administrator permission to import the SSL certificate.When the Bot Runner device is unable to connect to the Control Room because of an invalid SSL certificate, use this option to import the SSL certificate. You must ensure a valid certificate file is available in the file location specified in the
importSSLCertificatepath_to_ssl_certificateoption.You must restart the Automation Anywhere Bot Agent service so that the imported certificate becomes effective.
-listView active bot deployments on the local devices. Use this option to check and list the automation (bots) that are running.
-ping <CR_URL>Check connectivity between the Control Room and Bot Runner devices. Use this option to check if a Bot Runner device can ping (reach) the Control Room.
-validateSSLCertificate <CR_URL>Check for a valid SSL certificate and view whether the certificate is valid or invalid. Note: You must have read permission to perform this check.When the Bot Runner device is unable to connect to the Control Room because of an invalid SSL certificate, use this option to check and view if the SSL certificate is valid or not. To resolve the issue, use the
importSSLCertificateoption. -
Enter the following option in the command prompt:
<filepath>\AADiagnosticUtility.exe -<option>
<CR_URL>
For example, to verify WebSocket errors, enter the following in the command prompt: AADiagnosticUtility.exe -checkWSError https://yourcrurl.com/The option returns the following result: Recently this device have not encountered any Web Socket errors
Use the other options to perform further diagnostic checks.