All Products
Search
Document Center

Cloud Backup:Register an on-premises Oracle database

Last Updated:Oct 14, 2026

Before you use Cloud Backup to back up an Oracle database deployed on an on-premises server, you must register the database instance in the Cloud Backup console.

Prerequisites

The on-premises database server is connected to Alibaba Cloud VPCs through VPNs or Express Connect circuits. The following CIDR blocks are routable between the on-premises server and Alibaba Cloud: 100.64.0.0/10, 100.64.0.0/11, and 100.96.0.0/11.

Procedure

  1. Log on to the Cloud Backup console.

  2. In the left-side navigation pane, choose Backup > Database Backup. Select a region in the top navigation bar. On the Database Backup page, click the Oracle tab, then click Register Database Instance on the Local Database Instance tab.

    image

  3. In the Add Client panel, install and activate the Cloud Backup client as prompted.

    Automatically install the Cloud Backup client for database backup

    Windows

    1. Download and decompress the Cloud Backup client for Windows.

      Note

      To download the Cloud Backup client to your on-premises server, copy the download URL and open it in a browser on that server.

    2. Log on to the on-premises server. Navigate to the extracted directory, type PowerShell in the path bar to open a terminal. Click the image icon in the Cloud Backup console, then copy and run the installation command in PowerShell to activate the Cloud Backup client for Windows.

      image

    3. If the output highlighted in the following figure appears, the Cloud Backup client for Windows is installed.

      image

    Linux

    1. Download and decompress the Cloud Backup client for Linux.

      1. Copy the download URL and run the wget command to download the Cloud Backup client for Linux to the on-premises server.

        wget https://a-hbr-resource-shanghai.oss-cn-shanghai.aliyuncs.com/unibackup/hbr-uni-install-linux.tar.gz
      2. Run the following command to extract the Cloud Backup client for Linux.

        tar -zxvf hbr-uni-install-linux.tar.gz
    2. Log on to the on-premises server, click the image icon on the Cloud Backup console to copy the installation command, and run it from the directory containing the client.exe file to activate the Linux backup client.

      image

    3. If the output highlighted in the following figure appears, the Cloud Backup client for Linux is installed.

      image

  4. Optional. If automatic installation of the Cloud Backup client fails, manually install the Cloud Backup client.

    Manually install the Cloud Backup client for database backup

    1. Download and decompress the Cloud Backup client for Windows.

    2. Double-click dbackupxxxxx.dbg.exe (version 42518) and click Next.

      image

    3. Select File and Oracle, then click Next.

      image

    4. Copy the Backup Server IP Address, Backup Server Port, and Access Key values from the Cloud Backup console to the corresponding fields, select SSL encryption, and click Next until the installation completes.

      image

    5. When the installation completes, navigate to the extracted directory and type PowerShell in the path bar to open a terminal. Click the image icon in the Cloud Backup console to copy and run the installation command in PowerShell.

      image

      If the output highlighted in the following figure appears, the Cloud Backup client is installed.

      image

    6. Return to the Cloud Backup console and activate the on-premises database.

      1. Choose <hd> More </hd> > Reactivate in the Actions column of the database.

      2. In the Activate Instance dialog box, log on with your database username and password and activate the instance, or use password-free logon. Configure the parameters and click OK.

        Important

        If you need to run the restoration job of an Oracle RAC database or run the backup and restoration jobs of a standby Oracle Data Guard database, you must use the database username and password for logon during instance activation. If you use password-free logon, these backup and restoration jobs fail.

        image

        Parameter

        Description

        Database Account

        The username for the database instance.

        This user account must have the sysdba role and the resource and connect permissions. For more information, see Step 2: Create a backup account and configure permissions.

        Password

        The user's password.

    After registration and activation, check the status on the Local Database Instance tab. If Client Status shows Installed, Database Status shows Online.

    image

Delete a registered database

  1. Uninstall the Cloud Backup client.

    Log on to the on-premises server and run one of the following commands to uninstall the Cloud Backup client.

    Windows

    1. Navigate to the installation directory of the Cloud Backup client in PowerShell, for example, C:\Program Files\aliyun\unibackup>.

    2. Run the following command:

       .\uninstall-unibackup.exe /S /NCRC

    Linux

    • CentOS

      sudo rpm --erase "dbackup3-agent-oracle"
      sudo rpm --erase "dbackup3-agent"
      sudo rpm --erase "dbackup3-common"
    • Ubuntu

      sudo dpkg -r "dbackup3-agent-oracle" "dbackup3-agent" "dbackup3-common"
  2. Unregister a database.

    If you no longer need to back up an Oracle database, unregister it: On the Local Database Instance tab, find the database and choose More > Unregister Instance in the Actions column.

    Warning

    After you unregister a database, all backups generated by the Cloud Backup client for Windows cannot be restored. Proceed with caution.

  3. In the dialog box that appears, click OK.

More operations

  • Unregister Instance

    To unregister an instance that you no longer need to back up, go to the ECS Database Instance tab, find the instance, and in the Actions column, choose ⋮ > Unregister Instance. Click OK in the confirmation dialog box.

    Warning

    After you unregister an instance, its backup data becomes unrecoverable.

  • Create Cluster

    If your Oracle database instance is part of a cluster, you must manually create the cluster after registering the instances. Cloud Backup then backs up these database instances as a single cluster to the same backup vault. On the ECS Database Instance tab, select the database instances for the cluster and click Create Cluster. In the dialog box, confirm your selections and click OK.

    Note

    After creating an Oracle RAC cluster, you only need to configure a backup plan on a single database instance to perform subsequent operations.

Next steps

Back up an Oracle database