Read and Review Automation Anywhere Documentation

Automation 360

Close Contents

Contents

Open Contents

Perform Bot agent diagnostic checks

  • Updated: 3/24/2021
    • Automation 360 v.x
    • Explore
    • RPA Workspace

Perform Bot agent diagnostic checks

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

  1. Open the Windows command prompt.
  2. Navigate to C:\Program Files\Automation Anywhere\Bot Agent.
  3. Enter AADiagnosticUtility.exe to run the Bot agent diagnostic utility.
    Various options to perform the diagnostic check are displayed with their descriptions.
    Option Description
    -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 importProxy option.

    -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.
    -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.

    -importSSLCertificate path_to_ssl_certificate Import 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_certificate option.

    You must restart the Automation Anywhere Bot agent service so that the imported certificate becomes effective.

    -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 importSSLCertificate option.

    -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.

    -list View active bot deployments on the local devices.

    Use this option to check and list the automation (bots) that are running.

    -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.

  4. 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.

Send Feedback