Cloud Backup client diagnostic tool

更新时间:
复制 MD 格式

Cloud Backup provides a client diagnostic tool. You can use this tool to diagnose issues with client installation, backups, recovery, and network connectivity. This topic describes how to install and use the diagnostic tool.

Download the diagnostic tool (installation-free)

Cloud Backup provides the following versions of the diagnostic tool. Download the version that matches the operating system of the server where the client is installed.

Diagnostic tool parameters

Parameter

Description

-a

Specifies the content to diagnose. Valid values: check and network.

  • check (default): Analyzes logs and diagnoses environment issues.

  • network: Probes the network connectivity. For information about common issues, see Common network issues.

-r

Specifies the region for the diagnosis. Enter the region ID. To obtain the region ID, see Endpoints.

-t

Specifies the type of client installed on the local server. Valid values:

  • file (default): File

  • vm: Virtual machine

  • db: Database

-l

Specifies the log directory. If the client is installed in a custom directory, use this parameter to specify the location of the log folder. To view the default installation path and logs of a Cloud Backup client, see How to view the default installation path and logs of a Cloud Backup client.

Use the diagnostic tool

Run the following commands to perform diagnostics.

  • Linux

    • Diagnose errors

      ./ht-linux-amd64 

      The expected result is as follows:

      Client installation path is /root/hbr-install-2.11.0-linux-amd64/logs
      The check on /root/hbr-install-2.11.0-linux-amd64/logs is complete. No exceptions found. For further checks, specify a path or perform a network check.
    • Diagnose network connectivity

      ./ht-linux-amd64 -a network -r cn-hangzhou

      The expected result is as follows:

      The network check result is as follows:
      
      Control (communication) network public domain name: post-cn-mp90rcien05.mqtt.aliyuncs.com, leased line domain name: post-cn-mp90rcien05-internal.mqtt.aliyuncs.com, port: 1883.
      This server can be accessed over the public network or a leased line.
      
      Data network public domain name: oss-cn-hangzhou.aliyuncs.com, leased line domain name: oss-cn-hangzhou-internal.aliyuncs.com, HTTP connection port: 80, HTTPS connection port: 443.
      If you use an HTTP connection, this server can be accessed over the public network. However, the leased line domain name is inaccessible. To use the leased line for access, check the firewall or leased line/VPN settings.
      If you use an HTTPS connection, this server can be accessed using either the public or leased line domain name.

    If an i/o timeout message is returned, a problem exists in the environment where the Cloud Backup client is installed. You must resolve the problem. To resolve the diagnosed problems, see Common network issues.

    Client log path is /root/hbr-install-2.11.0-linux-amd64/logs
    
    On 2022-11-16, the following problem was detected:
    An i/o timeout exception occurred for the request from this server to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. Check the firewall configuration and upstream bandwidth.
    
    On 2022-11-15, the following problem was detected:
    An i/o timeout exception occurred for the request from this server to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. Check the firewall configuration and upstream bandwidth.
    
    On 2022-11-14, the following problem was detected:
    An i/o timeout exception occurred for the request from this server to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. Check the firewall configuration and upstream bandwidth.
    ......
  • Windows

    • Diagnose errors

      Open Command Prompt and run the following command:

      .\ht-windows-amd64.exe

      The expected result is as follows:

      Client log path is C:\Program Files\Aliyun Hybrid Backup Service Client\logs
      The check on C:\Program Files\Aliyun Hybrid Backup Service Client\logs is complete. No exceptions found. For further checks, specify a path or perform a network check.
    • Diagnose network connectivity

      Open Command Prompt and run the following command:

      .\ht-windows-amd64.exe -a network -r cn-hangzhou

      The expected result is as follows:

      The network check result is as follows:
      
      Control (communication) network public domain name: post-cn-mp90rcien05.mqtt.aliyuncs.com, leased line domain name: post-cn-mp90rcien05-internal.mqtt.aliyuncs.com, port: 1883.
      This server can be accessed over the public network. However, the leased line domain name is inaccessible. To use the leased line for access, check the firewall or leased line/VPN settings.
      
      Data network public domain name: oss-cn-hangzhou.aliyuncs.com, leased line domain name: oss-cn-hangzhou-internal.aliyuncs.com, HTTP connection port: 80, HTTPS connection port: 443.
      If you use an HTTP connection, this server can be accessed over the public network. However, the leased line domain name is inaccessible. To use the leased line for access, check the firewall or leased line/VPN settings.
      If you use an HTTPS connection, this server can be accessed over the public network. However, the leased line domain name is inaccessible. To use the leased line for access, check the firewall or leased line/VPN settings.

    If an i/o timeout message is returned, a problem exists in the environment where the Cloud Backup client is installed. You must resolve the problem. To resolve the diagnosed problems, see Common network issues.

    check path C:\Program Files\Aliyun Hybrid Backup Service Client\logs
    got path C:\Program Files\Aliyun Hybrid Backup Service Client\logs
    
    On 2022-11-14, the following problem was detected:
    An i/o timeout exception was detected for the request from this server to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. Check the network.
    
    On 2022-11-13, the following problem was detected:
    An i/o timeout exception was detected for the request from this server to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. Check the network.
    
    On 2022-11-12, the following problem was detected:
    An i/o timeout exception was detected for the request from this server to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. Check the network.
    ......