Skip to main content

Troubleshooting

Troubleshoot Breeze Agent automatically first. If the automatic script is unavailable or does not identify the issue, continue with the manual checks.

Automatic Troubleshooting​

Linux

Run the troubleshooting script from the Breeze Agent directory:

cd /opt/breeze-agent/
./troubleshoot.sh

Windows

  1. Open Command Prompt by pressing Win+R, entering cmd, and pressing Enter.

  2. Run the troubleshooting script from the Breeze Agent directory:

    C:\> cd "C:\Program Files\Breeze"
    C:\Program Files\Breeze> troubleshoot.bat
    note

    If the troubleshooting script is not available in the Breeze Agent directory, update Breeze Agent to the latest version using the installer file from the Cloudaware Admin console.

Manual Troubleshooting​

Linux

  1. Check the log file for errors:

    /var/log/breeze-agent.log

    The log file should be empty if Breeze Agent is working as expected.

  2. If the log file is empty, set the log_level parameter in the agent configuration file to 1 to increase Breeze Agent output verbosity.

    • 2.1. Go to the agent configuration directory:

      cd /opt/breeze/agent/etc

    • 2.2. Open agent.conf and set log_level to 1:

      "log_level": "1"

    • 2.3. Run Breeze Agent manually or wait for the cron job.

    note

    If Breeze Agent runs manually, log data is printed to STDOUT. If Breeze Agent runs by cron job, log data is printed to /var/log/breeze-agent.log.

  3. Verify that the Breeze server is responding:

    • 3.1. Test the direct connection:

      telnet breeze-server.cloudaware.com 443

    • 3.2. Test the HTTPS connection:

      curl -v https://breeze-server.cloudaware.com
    note

    telnet works only when a direct internet connection is used. If the environment uses a proxy connection, use curl.

Windows

  1. Check the log file for errors:

    C:\Program Files\Breeze\agent.log

    The log file should be empty if Breeze Agent is working as expected.

  2. If the log file is empty, set the log_level parameter in the agent configuration file to 1 to increase Breeze Agent output verbosity.

    • 2.1. Go to the agent configuration directory:

      C:\> cd "C:\Program Files\Breeze\etc"

    • 2.2. Open agent.conf and set log_level to 1:

      "log_level": "1"

    • 2.3. Run Breeze Agent manually from Task Scheduler or wait for the scheduled task, then check C:\Program Files\Breeze\agent.log.

  3. Verify that the Breeze server is responding.

    • 3.1. In Command Prompt, run:

      telnet breeze-server.cloudaware.com 443

    • 3.2. In PowerShell, run:

      [System.Net.WebRequest]::Create("https://breeze-server.cloudaware.com/").GetResponse() | Select-Object StatusCode,StatusDescription,ResponseUri | Format-List
    tip

    This is a single line command. If the server is reachable, the result will be as below:

    RESPOND:

    StatusCode : OK

    StatusDescription : OK

    ResponseUrl: https://breeze-server.cloudaware.com/