Cloud Backup:Back up local files

Usage notes

Cloud Backup does not charge any fees if you only install the backup client and do not create a backup plan.

Create a backup plan to periodically back up local server files

1. Log on to the Cloud Backup console.

2. In the navigation pane on the left, choose Backup > On-Premises File Backup.

3. In the upper-left corner of the top menu bar, select a region.

4. Select the backup client version.

   Important

   If you are not using an old version of the backup client, the Old Version and New Version buttons do not appear in the console. Proceed with the subsequent steps. We recommend that you upgrade older backup clients to the latest version.

   • If you are using an old version of the backup client, on the On-Premises File Backup page, click Old Version.

   • If you are using a new version of the backup client, on the On-Premises File Backup page, click New Version.

5. Find the destination client and click Back Up in the Actions column.

6. In the Create Backup Plan panel, configure the parameters as described in the following table and click OK.

   Important

   • If the region that you selected supports backup policies, you can configure a backup plan only by associating it with a backup policy. Cloud Backup periodically backs up the local files based on the backup policy.

   • In the navigation pane on the left of the console, click Policy Center to view the regions that support backup policies. For more information about how to create a backup policy, see Create a backup policy.

   

   Parameter	Description
   Backup Folder Rule	Specifies the directory to be backed up. Cloud Backup backs up all files and subdirectories in the specified directory. Examples: D:\work\local_backup_path and /home/backup_path. Select All Folders or Specified Folders. If you select All Folders, specify whether to enable Exclude System Folders. If you enable Exclude System Folders, the excluded system directories for Windows and Linux are not included in the backup plan. Click the icon to the right of Exclude System Folders to view the details of the excluded system directories. If you do not enable Exclude System Folders, all directories are included in the backup plan. If you select Specified Folders, you must specify a Source Paths. The source path must follow these rules: If no wildcard character (*) is used, you can enter up to eight paths. If a wildcard character (*) is used, you can enter only one path. Wildcard characters such as /*/* are supported. Each path must be an absolute path. For example, a path must start with /, \\, C:\, or D:\. When you use Volume Shadow Copy Service (VSS), multiple paths, UNC paths, wildcard characters, and file exclusion are not supported. When you use a UNC path, VSS, wildcard characters, and file exclusion are not supported. If the backup source contains a UNC path, Windows Access Control Lists (ACLs) are not backed up.
   Exclude System Folders	Turn on the Exclude System Folders switch to exclude system directories from the backup.
   Backup File Type	Select All Types or Specified Type. If you select Specified Type, you must specify the file types to be backed up in the Select File Type box.
   Source Paths	This parameter is required only when you turn on the Advanced Rule Mode switch and select Specified Folders. You can configure a custom source path. The source path must follow these rules: If no wildcard character (*) is used, you can enter up to eight paths. If a wildcard character (*) is used, you can enter only one path. Wildcard characters such as /*/* are supported. Each path must be an absolute path. For example, a path must start with /, \\, C:\, or D:\. When you use Volume Shadow Copy Service (VSS), multiple paths, UNC paths, wildcard characters, and file exclusion are not supported. When you use a UNC path, VSS, wildcard characters, and file exclusion are not supported. If the backup source contains a UNC path, Windows Access Control Lists (ACLs) are not backed up.
   Backup Rule	This parameter is required only when you turn on the Advanced Rule Mode switch and select Specified Folders. Include All Files: All files are backed up. Include Files or Exclude Files: In the input file list box, enter a list of files. The files are backed up based on the rule.
   Backup Policy	Select a backup policy from the drop-down list. Cloud Backup automatically backs up the data source based on the backup policy that you configure. A backup policy defines operations such as the encryption method for the backup vault, backup interval, retention period, cross-region replication policy, automatic data archiving, and virus scan for backup points. This helps you flexibly manage your data source assets. If the default backup policy does not meet your requirements, click Create Backup Policy or Edit Policy to manage backup policies. For more information about the parameters in a backup policy, see Policy center.
   Use VSS	Specifies whether to use Windows VSS to define the source path. Note When you use VSS, multiple paths, UNC paths, wildcard characters, and file exclusion are not supported.
   Enable Bandwidth Throttling	Bandwidth throttling helps you control backup traffic during peak hours to prevent impacts on your business. To use traffic shaping, turn on the Enable Bandwidth Throttling switch, select a Time Range (Hour) based on your business needs, enter a value for Max Bandwidth (MByte/s), and then click Add.

Successful backup

• When the scheduled backup time arrives, Cloud Backup starts and runs the backup job.

  Note

  The backup progress percentage is a dynamic estimate that the system generates based on the current data volume and is for reference only. It may not reflect the exact completion percentage. During the backup process, the displayed total scanned size may be smaller than the actual total data size because the data scan is not yet complete. The completion of the backup job is determined by its final status.

  On the Backup Jobs tab, if the Status of a backup job is Completed, the backup is successful.

  View details about the backup job, such as Total Scan, Completed Backups, Written to Vault, and Backup Speed. For more information about these metrics, see the tooltips in the Cloud Backup console.

  Note

  For backup jobs completed on or after June 1, 2025, statistics for both data volume and file count are displayed for Total Scanned at Source, Backup Completed, and Data Written to Vault. For backup jobs completed before this date, only data volume statistics are shown for these metrics.

  

• On the Backup Plans tab, click the icon in front of the destination client. View the record of each backup job and the generated backup points in the Backup History section. You can use these historical backup points to restore local files.

  

Browse and download backup files

• Browse backup files

  The Browse feature lets you browse backed-up files. If a virus scan was performed on the backup point that you are browsing, Cloud Backup marks the infected files.

  1. On the Backup Plans tab, click the icon in front of the destination client.

  2. In the Backup History section, find the backup point for the specified point in time, click the backup point, and then select Browse.

  

• Download backup files

  You cannot directly download backed-up files to a local device. You can indirectly download backed-up files by restoring them to a specified path. For example, when you restore files, set Restore Path Type to Specify Path and set Destination Path to D:\work\local_backup_path_new. You must create this path before you start the restore job. Otherwise, the job fails. After the restore job is complete, the files from the backup point are downloaded to this path.

Extend the retention period of a backup point

To retain historical data from local file backups for a longer period, extend the retention period of the backup points.

1. On the Backup Plans tab, click the icon in front of the destination client.

2. In the Backup History section, click the historical backup point whose retention period you want to extend. Set Specify Time or select Never Expire.

   

3. Click Save.

Virus scan

To prevent files that contain viruses from being restored to your production environment, Cloud Backup provides the Backup Point Virus Detection feature. This feature helps you select clean and secure backup points for future data restoration. Click Virus Detection to scan files for viruses. For more information, see Virus scan for backup points.

Cross-region backup

To prevent regional disasters from affecting business continuity, Cloud Backup lets you create a cross-region mirror vault for a backup vault whose Storage Vault Type is General Backup or Tablestore Backup.

For a general backup vault that stores local files, create a cross-region mirror vault to implement cross-region disaster recovery. After the mirror vault is created, data in the source backup vault is automatically replicated to the mirror vault to ensure data consistency between the two regions. You can also use the mirror vault to perform cross-region data restoration when needed. For more information, see Cross-region backup. In addition, file backup supports enterprise-level features such as cross-account backup, automatic data archiving, KMS encryption, backup lock, and virus scan for backup points.

Configure retry parameters for failed file backups

If a file backup job fails due to factors such as an unstable network, configure retry parameters.

1. Log on to the server whose files you want to back up.

2. Switch to the default installation directory of the Cloud Backup client.

3. In the client folder, create a file named hbr.config.

   Note

   The hbr.config file is in the same directory as the hbrclient and ids executable programs.

4. Add the following parameters to the hbr.config file.

   Parameter	Description
   retry_times	For clients of version 2.16.0 and later, this is the number of data backup retries. The default value is 30.
   retry_interval	For clients of version 2.16.0 and later, this is the data backup retry interval. The default value is 1000 milliseconds.
   skip_error_files	Specifies whether to skip files that fail to be backed up. false (default): Does not skip files that fail to be backed up. true: Skips files that fail to be backed up.

   The following is a sample configuration of the hbr.config file:

   retry_times=30
   retry_interval=1000
   skip_error_files=false

Troubleshooting

If the Status of a client or backup job is abnormal, refer to the following suggestions for troubleshooting.

• Client Status: Stopped

  The backup client is disconnected from Cloud Backup.

  • If you have uninstalled the backup client and no longer need to perform backups or restore historical data, choose More > Delete Backup to delete the backup.

    Important

    Deleting a backup removes all backup data generated by the client and causes running backup and restore jobs to fail. Before you delete a client, make sure that you no longer need the backup data of the client and that no backup or restore jobs are running on the client. Proceed with caution.

  • Check the running status of the backup client on the local server. For more information, see How do I check the running status of a Cloud Backup client?.

• Backup Status: Failed

  • Check and correct the configuration based on the prompts in the UI.

  • View the logs to locate the specific error code.

    Note

    The default installation paths of the backup client are for reference only. Use the actual installation paths on your server.

    • Windows: C:\Program Files\Aliyun Hybrid Backup Service Client\logs

    • Linux: /opt/alibabacloud/hbrclient/logs

More operations

• Use HTTPS to transmit data

  Using HTTPS reduces data transmission performance. If you modify this setting, the change takes effect when the next backup or restore job starts.

  Click More > Client Settings in the Actions column, and then select whether to use HTTPS to transmit data.

• Alert notification method

  Click More > Alert Settings in the Actions column and then select an alert notification method.

  Alert notification method	Description
  Disabled	No alert notifications are sent for the client.
  Same as Backup Vault	The client uses the same alert notification method as the backup vault.
  Notify Alibaba Cloud Account	Alert notifications for the client are sent to the Alibaba Cloud account by email.
  Custom	You must select one or more contacts or contact groups. After the configuration is complete, alert notifications for the client are sent to the selected contacts or contact groups. For more information, see Manage alert contacts.

• Delete backup

  This operation deletes all backup data that is generated by this backup client.

  Warning

  Deleting a backup removes all backup data generated by the client and causes running backup and restore jobs to fail. Before you delete a client, make sure that you no longer need the backup data of the client and that no backup or restore jobs are running on the client.

  Click More > Delete Backup in the Actions column to delete client backup data that you no longer need.

References

• Back up files of an ECS instance

• Cloud Backup provides resource plans for different backup scenarios. Resource plans offer greater discounts and can help you save on costs. For more information, see Purchase a resource plan.