All Products
Search
Document Center

Cloud Backup:Create a synchronization plan

Last Updated:Mar 04, 2024

After you add source and destination data sources, you can create a synchronization plan to synchronize data. This topic describes how to create a synchronization plan.

Prerequisites

  • Cloud Backup is activated. You are not charged for activating Cloud Backup. The data synchronization feature is in public preview and is provided free of charge.

  • A Cloud Backup client is installed on the server where the data synchronization job is executed. For more information, see Download and activate a Cloud Backup client for Windows or Download and activate a Cloud Backup client for Linux.

    Important
    • The Cloud Backup client for Windows does not support mounting of Network File System (NFS) file systems. If NFS files systems exist on the source or destination, select the Cloud Backup client for Linux when you create a synchronization plan.

    • Neither OSS nor S3-Compatible Storage supports synchronization of Archive objects. Only data of objects (including the objects to which symbolic links point) is replicated. Metadata information, such as the read and write permissions on the objects, is not supported.

    • For NAS data synchronization, the maximum length of a file name is 248 bytes. If the length of a file name exceeds 248 bytes, the file fails to be synchronized or the synchronization job is partially completed.

  • Source and destination data sources are added. For more information, see Add a data source.

  • We recommend that you plan the source and destination file paths in advance. For example, create a path to save files on the destination in advance.

Procedure

  1. Log on to the Cloud Backup console.

  2. In the left-side navigation pane, choose Synchronization > Data Synchronization.

  3. In the top navigation bar, select a region.

  4. On the Data Source List tab, find the data source that you want to synchronize and click Sync to Another in the Actions column.

  5. In the Create Sync Plan panel, perform the following configurations.

    1. Associate a client group and click Next.

      A client is used to execute the synchronization plan that you create. The client can be installed on the source or destination server.

      You can add multiple clients to a client group to concurrently run a synchronization job.

      • Create Backup Client Group: Select Create Backup Client Group, enter a name for the client group in Client Group Name, and add the required clients to the client group.

      • Select Backup Client Group: Select an existing client group.

      After you add clients to the client group, you can modify or delete the clients in the client group in the View Client Groups panel. If no client is installed, download and activate a Cloud Backup client. For more information, see Download and activate a Cloud Backup client.

    2. Configure the parameters of the synchronization plan and click OK. The following table describes the parameters.

      Parameter

      Description

      Source

      The data source. You must add the data source in advance. For more information, see Add a data source.

      • Source File Path: the path of the file to be synchronized. Example: /source.

      Destination

      Data is synchronized from the source to the destination. You must add the data source in advance. For more information, see Add a data source.

      • Destination: the destination to which data is synchronized. Select a destination from the drop-down list.

      • Destination File Path: the path of the files on the destination. You must create the destination path in advance.

        Important

        If a file with the same name already exists in the destination path when you write files, the file may be overwritten. Select a file conflict policy based on your business requirements.

      • When a file with the same name exists in the path:

        • Skip the file with the same name and do not overwrite it: ignores the file and does not synchronize it.

        • Overwrite the file if the file is updated: synchronizes the file if the file is updated and overwrites the existing file.

        • Always overwrite the file with the same name: synchronizes the file as the source file.

      Scan Policy

      You can use the file synchronization rule and incremental file list to configure the scan policy and improve data synchronization efficiency.

      • No: The scan policy is not used.

      • Sync File Rule

        • Include All Files

        • Include Files and Exclude Files: If you select either option, enter the files in the Enter Paths field. Cloud Backup then synchronizes the specified files in the selected path based on the rule.

      • Incremental File List: You can synchronize data based on incremental files only if Source is set to OSS or S3 Compatible Storage. The path must be a subdirectory in the source path.

        • On Source: The incremental file synchronization table is on the source.

        • On Destination: The incremental file synchronization table is on the destination.

        • Incremental List Path: Enter the location of the incremental file synchronization table on the source or destination in Incremental List Path.

        Note

        For example, when you create a plan for synchronization from S3-Compatible Storage to Object Storage Service (OSS), you can use the incremental file list to specify the files to be synchronized. If the incremental file lists changelist1.csv and changelist2.csv are stored in the source path /changelist, the value of the path for the incremental file lists is /changelist.

        For more information, see Incremental file list (Changelist).

      Sync Plan

      The start time and interval of the synchronization plan are included.

      • Sync Plan Name: the name of the synchronization plan. If you do not configure this parameter, a random name is specified.

      • Sync Start Time: the start time of synchronization.

      • Sync Run Interval: the interval at which data is synchronized. Data can be synchronized by minute, hour, day, and week. The minimum interval is 10 minutes.

      Enable Data Verification

      The data verification feature compares the checksums calculated for the source and destination data to ensure data correctness. This feature is enabled by default.

      Advanced Settings

      By default, you do not need to modify the advanced settings. We recommend that you modify the advanced settings in the following conditions: A large amount of data or a large number of files are synchronized, and the synchronization job has performance issues and needs to be optimized.

      • Maximum Number of Files Per Task: Change the value based on your business requirements.

      • Maximum Amount of Data Per Task: Change the value based on your business requirements.

      After the synchronization plan is created, you can view the plan on the Sync Plan tab. Cloud Backup then periodically synchronizes data based on the synchronization plan.image.png

Synchronization is successful

When the synchronization execution time is reached, Cloud Backup executes the synchronization job. If the Status of the synchronization job is Successful, the synchronization is complete. You can download the report of completed synchronization jobs.

image.png

Troubleshooting

If a synchronization job fails, we recommend that you perform the following troubleshooting:

  • Modify and confirm the configurations as prompted.

  • View the client logs and locate the error code.

    Note

    The Cloud Backup client is installed in one of the following paths by default. The following paths are for reference only. The actual installation path may be different.

    • On Windows, you can view the logs in the C:\Program Files\Aliyun Hybrid Backup Service Client\logs path.

    • On Linux, you can view the logs in the /opt/alibabacloud/hbrclient/logs path.

  • Check whether an Apsara File Storage NAS (NAS) file system fails to be mounted.

    • The Cloud Backup client for Windows does not support mounting of Network File System (NFS) file systems. If NFS files systems exist on the source or destination, select the Cloud Backup client for Linux when you create a synchronization plan.

    • If no exception occurs on the network path to which the Server Message Block (SMB) file system is mounted, obtain the error code from the log file. Then, find and handle the error code by referring to the Microsoft Documentation Center.

What to do next

After a synchronization plan is created, you can select the required operation in the Actions column. The following table describes the available operations.

Operation

Description

Run Now

Immediately runs a synchronization job.

More > Edit

Modifies the synchronization plan.

More > Delete Plan

Deletes the synchronization plan if it expires.

More > Alert Settings

If the synchronization job fails or the client is disconnected from the server, Cloud Backup sends an alert notification by default. The following alert notification methods are available:

  • Disabled: The Cloud Backup client does not send alert notifications.

  • Notify Alibaba Cloud Account: The Cloud Backup client sends alert notifications to the owner of the Alibaba Cloud account by using emails, internal messages, and text messages.

  • Custom: If you select this option, you must select one or more alert contacts or alert contact groups. After the configuration is complete, the Cloud Backup client sends synchronization alert notifications to the selected alert contacts or alert contact groups. For more information, see Manage alert contacts.