All Products
Search
Document Center

Cloud Backup:Diagnostic tool for Cloud Backup clients

Last Updated:Sep 22, 2023

Cloud Backup provides a diagnostic tool for Cloud Backup clients. You can use the tool to diagnose various issues in the client environment, such as issues related to client installation, data backup, data restoration, and network connectivity. This topic describes how to install and use the diagnostic tool.

Download the diagnostic tool (installation-free)

Cloud Backup provides the diagnostic tool in the following versions. You can click the link to download a version based on the operating system of the server on which your Cloud Backup client is installed.

Parameters

Parameter

Description

-a

The content of the diagnostics. Valid values:

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

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

-r

The region where you want to perform diagnostics. Enter the region ID. For more information about region IDs, see Endpoints.

-t

The type of the Cloud Backup client that is installed on the on-premises server. Valid values:

  • file (default value): file

  • vm: virtual machine (VM)

  • db: database

-l

The log directory. If the Cloud Backup client is installed in a custom directory, use this parameter to specify the location of log files. For more information about how to view the default installation path and logs of an Cloud Backup client, see Where do I view the default installation path and logs of an Cloud Backup client?

Use the diagnostic tool

You can perform diagnostics by running the following commands.

  • Linux

    • Error diagnostics

      ./ht-linux-amd64 

      Expected result:

      Client installation path: /root/hbr-install-2.11.0-linux-amd64/logs
      The diagnostics on /root/hbr-install-2.11.0-linux-amd64/logs is completed and no exception is found. To perform further diagnostics, we recommend that you specify a path or check the network connectivity. 
    • Network diagnostics

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

      Expected result:

      Result of network diagnostics:
      
      Public domain name of the control network: post-cn-mp90rcien05.mqtt.aliyuncs.com. Private domain name: post-cn-mp90rcien05-internal.mqtt.aliyuncs.com. Port number: 1883. 
      The host is accessible over the Internet or an Express Connect circuit. 
      
      Public domain name of the data network: oss-cn-hangzhou.aliyuncs.com. Private domain name: oss-cn-hangzhou-internal.aliyuncs.com. HTTP port number: 80. HTTPS port number: 443. 
      If an HTTP connection is established, the host is accessible over the Internet. However, the private domain name is inaccessible. If you need to access the private domain name, check the settings of the firewall, Express Connect circuit, or virtual private network (VPN). 
      If an HTTP connection is established, the host can be accessed by using the private domain name or the private domain name. 

    If an i/o timeout message appears, the environment in which the Cloud Backup client is installed is faulty and the exception needs to be handled. For more information about how to resolve the exception, see Common network issues.

    Client log path: /root/hbr-install-2.11.0-linux-amd64/logs
    
    On November 16, 2022, the following issue is detected:
    An i/o timeout exception occurs in the request from the local host to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. We recommend that you check the firewall settings and upstream bandwidth. 
    
    On November 15, 2022, the following issue is detected:
    An i/o timeout exception occurs in the request from the local host to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. We recommend that you check the firewall settings and upstream bandwidth. 
    
    On November 14, 2022, the following issue is detected:
    An i/o timeout exception occurs in the request from the local host to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. We recommend that you check the firewall settings and upstream bandwidth. 
    ......
  • Windows

    • Error diagnostics

      Run the following command in Windows PowerShell:

      .\ht-windows-amd64.exe

      Expected result:

      Client log path: C:\Program Files\Aliyun Hybrid Backup Service Client\logs
      The diagnostics on C:\Program Files\Aliyun Hybrid Backup Service Client\logs is completed and no exception is found. To perform further diagnostics, we recommend that you specify a path or check the network connectivity. 
    • Network diagnostics

      Run the following command in Windows PowerShell:

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

      Expected result:

      Result of network diagnostics:
      
      Public domain name of the control network: post-cn-mp90rcien05.mqtt.aliyuncs.com. Private domain name: post-cn-mp90rcien05-internal.mqtt.aliyuncs.com. Port number: 1883. 
      The host is accessible over the Internet. However, the private domain name is inaccessible. If you need to access the private domain name, check the settings of the firewall, Express Connect circuit, or virtual private network (VPN). 
      
      Public domain name of the data network: oss-cn-hangzhou.aliyuncs.com. Private domain name: oss-cn-hangzhou-internal.aliyuncs.com. HTTP port number: 80. HTTPS port number: 443. 
      If an HTTP connection is established, the host is accessible over the Internet. However, the private domain name is inaccessible. If you need to access the private domain name, check the settings of the firewall, Express Connect circuit, or virtual private network (VPN). 
      If an HTTPS connection is established, the host is accessible over the Internet. However, the private domain name is inaccessible. If you need to access the private domain name, check the settings of the firewall, Express Connect circuit, or VPN. 

    If an i/o timeout message appears, the environment in which the Cloud Backup client is installed is faulty and the exception needs to be handled. For more information about how to resolve the exception, 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 November 14, 2022, the following issue is detected:
    An i/o timeout exception occurs in the request from the local host to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. We recommend that you check the network connectivity. 
    
    On November 13, 2022, the following issue is detected:
    An i/o timeout exception occurs in the request from the local host to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. We recommend that you check the network connectivity. 
    
    On November 12, 2022, the following issue is detected:
    An i/o timeout exception occurs in the request from the local host to http://hbr-000erjjjfoafwu7a802j.oss-cn-hangzhou-internal.aliyuncs.com. We recommend that you check the network connectivity. 
    ......