All Products
Search

This Product

    Cloud Backup:Register an on-premises Oracle database

    Document Center

    Cloud Backup:Register an on-premises Oracle database

    Last Updated:Jun 06, 2025

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

    Prerequisites

    The on-premises database server is connected to virtual private clouds (VPCs) by using virtual private networks (VPNs) or Express Connect circuits. One of the following CIDR blocks can be used for communication between the on-premises database 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. In the top navigation bar, select a region. On the Database Backup page, click the Oracle tab. On the Local Database Instance tab, click Register Database Instance.

      image

    3. In the Add Client panel, install and activate a 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, you can right-click the URL to copy the URL, and then open the URL in a browser on the on-premises server.

      2. Log on to the on-premises server. Go to the decompression directory and enter PowerShell in the path bar to open the terminal window. Then, click the image icon in the Cloud Backup console, and copy and run the installation command in PowerShell to activate the Cloud Backup client for Windows.

        image

      3. If the content of the red box 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. Right-click the URL to copy the URL, and then 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 tar command to decompress 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 in the Cloud Backup console to copy and run the installation command in the decompression directory to activate the Cloud Backup client for Linux.

        image

      3. If the content of the red box in the following figure appears, the Cloud Backup client for Linux is installed.

        image

    4. Optional. If the automatic installation of the Cloud Backup client for Windows fails, perform the following steps to 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 of version 42518 and click Next.

        image

      3. Select File and Oracle and click Next.

        image

      4. Copy the values of the Backup Server IP Address, Backup Server Port, and Access Key parameters from the Cloud Backup console to the corresponding fields in the installation step, and select Secure Sockets Layer (SSL) encryption. Click Next until the installation is complete.

        image

      5. When the installation is complete, go to the decompression directory and enter PowerShell in the path bar to open the terminal window. Then, click the image icon in the Cloud Backup console to copy and run the installation command in PowerShell.

        image

        If the content of the red box in the following figure appears, the Cloud Backup client is installed.

        image

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

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

        2. In the Activate Instance dialog box, use the database username and password for logon and activate the instance. Alternatively, use password-free logon. Then, configure the related parameters and click OK.

          Important

          When you run the Oracle RAC restoration job, you must use the database username and password for logon during instance activation. If you use password-free logon, the Oracle RAC restoration job fails.

          image

          Parameter

          Description

          Database Account

          The username of the database instance.

          The minimum permission set of the user is 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 password.

      After you register and activate the on-premises database, you can view the registration status on the Local Database Instance tab. If Client Status is displayed as Installed, Database Status is displayed as 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. Go to the installation directory of the Cloud Backup client by using 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, perform the following operations to unregister the database: Click the Local Database Instance tab. Find the database that you want to unregister, 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.

    Related operations

    • Unregister Instance

      If you no longer need to back up an Oracle database, perform the following operations to unregister the database: Click the ECS Database Instance tab. Choose More > Unregister Instance in the Actions column of the database. In the message that appears, click OK.

      Warning

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

    • Create Cluster

      If your Oracle database belongs to a cluster, you must create another cluster that consists of the database after you register the database. Cloud Backup backs up all databases in a cluster to the same backup vault. To create a cluster, perform the following operations: On the ECS Database Instance tab, select your database to be added to the cluster. Click Create Cluster. In the dialog box that appears, select the databases that belong to the cluster and click OK.

      Note

      After you create an Oracle RAC cluster, you need to configure a backup plan on only one database before you perform subsequent operations.

    What to do next

    Back up an Oracle database