Diagnose and resolve backup failures for all Cloud Backup data sources, including client-based and service-based scenarios.
Step 1: Determine whether a client is required
Data sources that do not require client installation
When you back up Alibaba Cloud storage resources, such as OSS objects, NAS file systems, Tablestore instances, and ECS instances, in the Cloud Backup console for the first time, Cloud Backup uses the related service-linked roles to read these resources without installing a client. For more information about how to resolve backup failures and timeout errors in this scenario, see Step 2: Resolve failures without a client installed.
Data sources requiring client installation
When you back up files, on-premises server files, ECS instances, on-premises databases (MySQL, Oracle, and SQL Server), VMs, and large-scale NAS file systems that are stored in self-managed data centers, you must install a Cloud Backup client. Cloud Backup clients support Windows and Linux operating systems. For more information about how to resolve backup failures and timeout errors in this scenario, see Step 3: Resolve backup failures when a Cloud Backup client is installed.
Learn about the product in What is Cloud Backup? and Features supported by Cloud Backup.
Step 2: Resolve failures without a client installed
In the Cloud Backup console, modify and confirm the configurations as prompted.
Troubleshoot a job that fails to back up OSS objects.
Status of the Backup Jobs: Failed (The OSS bucket does not exist.)
The OSS bucket has been deleted.
If the deletion was intentional, ignore the job status. To avoid unnecessary storage fees, click Storage Vaults in the left navigation pane and delete the storage vault.
If the deletion was unintentional, create a new OSS bucket in the same region and restore objects to it. Create an OSS restore job.

Troubleshoot a job that fails to back up a NAS file system.
If Status of the backup job is abnormal, check the following:
Status of the Backup Jobs: Failed (The path cannot be accessed.)
The path specified in Source Paths does not exist. Update the source path to a valid network path. On the Backup Plans tab, find the file system and choose <hd> More </hd> > Modify Plan in the Actions column.

Status of the Backup Jobs: Failed (The specified file system does not exist.)
The NAS file system has been deleted.
If the deletion was intentional, ignore the job status. To avoid unnecessary storage fees, click Storage Vaults in the left navigation pane and delete the storage vault.
If the deletion was unintentional, create a NAS file system in the same region and restore files to it. Create a NAS restore job.

Status of the Backup Jobs: Failed (The mounting fails.)
On the Backup Plans tab, access the NAS file system on the Alibaba Cloud NAS tab. Ensure that VPC Default Permission Group (All Allowed) is used by the mount target Cloud Backup created for the NAS file system, and that it allows access from all IP addresses (0.0.0.0/0). If the default permission group restricts access, contact Alibaba Cloud NAS technical support.



Alibaba Cloud NAS does not support the SMB access control list (ACL) feature. If ACL is enabled for your SMB file system, Cloud Backup cannot access it.
Troubleshoot a job that fails to back up a Tablestore instance.
If Status of the backup job is abnormal, check the following:
Status of the Backup Jobs: Failed
Modify and confirm the configurations as prompted.
Instance Status of the Tablestore instance: Released
The Tablestore instance has been deleted.
If the deletion was intentional, ignore the job status. To avoid unnecessary storage fees, click Storage Vaults in the left navigation pane and delete the storage vault.
If the deletion was unintentional, create a Tablestore instance in the same region and restore tables to it. Restore Tablestore tables.

Step 3: Resolve failures with a client installed
In the Cloud Backup console, modify and confirm the configurations as prompted.
Check the client status. For more information, see How do I check the status of a Cloud Backup client? and Troubleshoot Cloud Backup client status exceptions
Occasional failures are typically caused by network jitter or temporary disconnections — no action is needed, and the backup resumes automatically. If failures persist, use the diagnostic tool for Cloud Backup clients to monitor the client's network environment. Common network issues.
Check whether the
hbrclient initcommand was run by mistake. Running this command on a client that is already registered and running overwrites its configuration, breaks the MQTT connection, and causes backup jobs to fail.Troubleshooting: Run
systemctl status hbrclientto check the service status. Check the log file/opt/alibabacloud/hbrclient/logs/hbrclient.logfor errors such aspingresp not received,MQTTPublishTimeout, anddial tcp i/o timeout. Both checks rely only on information that is available on the server: the hbrclient service status and thehbrclient.loglog file. If the service is running as expected and none of these errors appear in the log, an accidentalhbrclient initis not the cause of the failures. Continue with the other causes in this section.Solution: If the server also runs the Security Center anti-ransomware client, uninstall the anti-ransomware client in the Security Center console first to avoid conflicts with the backup client. If the anti-ransomware client is not installed on the server, skip this step. Then run
systemctl stop hbrclientto stop the service and delete the client configuration and runtime data from the/opt/alibabacloud/hbrclient/directory, but keep the client executable file. Next, re-register the client. The registration method depends on where the client runs. On an ECS instance, runhbrclient init ecs. On an on-premises server, this command does not apply. Instead, re-register the client with the vault that the client belongs to and the corresponding activation code. Finally, runsystemctl start hbrclientto start the service. Restarting the service alone does not resolve the issue. You must delete the client configuration and runtime data, and then re-register the client.NoteNote the following points when you recover the client:
After you uninstall the anti-ransomware client, the server is no longer protected against ransomware. Reinstall the anti-ransomware client and re-enable protection after the backup client runs as expected.
Do not delete the client executable file. Otherwise, the registration command cannot run. If you have already emptied the installation directory, download and install the client again before you re-register it.
The local NAS mount failed.
The Cloud Backup client configuration is incorrect, or the required mount tool is not installed.
If an out-of-memory (OOM) error occurs due to insufficient resources:
Scale up resources.
Split the source directory into multiple subdirectories. Method 1: Split the source path.

Enable bandwidth throttling and configure related parameters in the backup plan.

Reduce client resource usage by modifying its configuration file. Method 3: Reduce the resource consumption of the Cloud Backup client.
If a timeout occurs, check the hbrclient.log file. If "Program Stopping!" appears, the client was restarted. Log file paths:
On Linux:
/opt/alibabacloud/hbrclient/logs/hbrclient.logOn Windows:
C:\Program Files\Aliyun Hybrid Backup Service Client\logs\hbrclient.log