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