All Products
Search
Document Center

Cloud Backup:Register an on-premises Oracle database

Last Updated:Mar 13, 2024

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.

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

  4. On the Database Backup page, click Oracle.

  5. On the Local Database Instance tab, click Register Database Instance.

  6. In the Add Client panel, install a Cloud Backup client as prompted.

    • Windows

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

      2. Log on to the on-premises server. Then, use PowerShell to run the following command in the decompressed directory to activate the Cloud Backup client for Windows.

        You can obtain the following sample command from the Cloud Backup console:

        ./client.exe init local-uni --uniUserInfoToken "eyJ1cmwiOiJodHRwczovL2EtaGJyLXJlc291cmNlLWhhbmd6aG91Lm9zcy1jbi1oYW5nemhvdS1pbnRlcm5hbC5hbGl5dW5jcy5jb20vY2xpZW50L2luc3RhbGwvZGJhY2t1cF9hZ2VudC93aW42NC84LjAuMjkyOTItMS4wMjg1Nzc2LmRiZy8iLCJob3N0IjoiMTAwLjEwMy44LjExNiIsInBvcnQiOjYwMzA1LCJteXNxbEFnZW50IjoiTm8iLCJtc3NxbEFnZW50IjoiTm8iLCJvcmFjbGVBZ2VudCI6IlllcyIsInZlcnNpb24iOiI4LjAuMjkyOTItMS4wMjg1Nzc2LmRiZyIsImFjY2Vzc0tleSI6IjMyNThhNzQyZjc1OGZhYzZlYTBkYTIxMGQ0YmYwOTYwIiwidXNlU3NsIjoiWWVzIiwiYWdlbnQiOiJvcmFjbGUiLCJ1c2VyVG9rZW4iOiIwNVA5R1NKVCIsInJlZ2lvbklkIjoiY24taGFuZ3pob3UiLCJzb3VyY2VUeXBlIjoiT1JBQ0xFIn0="
    • Linux

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

        You can right-click the package to obtain the download link and use a command similar to wget 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

        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 and run the command to activate the Cloud Backup client for Linux.

        You can obtain the following sample command from the Cloud Backup console:

        sudo ./client init local-uni --uniUserInfoToken "eyJ1cmwiOiJodHRwczovL2EtaGJyLXJlc291cmNlLWhhbmd6aG91Lm9zcy1jbi1oYW5nemhvdS1pbnRlcm5hbC5hbGl5dW5jcy5jb20vY2xpZW50L2luc3RhbGwvZGJhY2t1cF9hZ2VudC9saW51eDY0LzguMC4yOTI5Mi0xLjAyODU3NzYuZGJnLyIsImhvc3QiOiIxMDAuMTAzLjguMTE2IiwicG9ydCI6NjAzMDUsIm15c3FsQWdlbnQiOiJObyIsIm1zc3FsQWdlbnQiOiJObyIsIm9yYWNsZUFnZW50IjoiWWVzIiwidmVyc2lvbiI6IjguMC4yOTI5Mi0xLjAyODU3NzYuZGJnIiwiYWNjZXNzS2V5IjoiMzI1OGE3NDJmNzU4ZmFjNmVhMGRhMjEwZDRiZjA5NjAiLCJ1c2VTc2wiOiJZZXMiLCJhZ2VudCI6Im9yYWNsZSIsInVzZXJUb2tlbiI6IjA1UDlHU0pUIiwicmVnaW9uSWQiOiJjbi1oYW5nemhvdSIsInNvdXJjZVR5cGUiOiJPUkFDTEUifQ=="

    After you register the Oracle database, Cloud Backup installs a client for ECS backup on each node of the Oracle database. On the Local Database Instance tab, you can view the installation status of the Cloud Backup client on each node of the Oracle database. You can also upgrade a Cloud Backup client based on your business requirements.

Related operations

  • Create a 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 Local Database Instance tab, select your database. Click Create Cluster, select the databases that belong to the cluster, and then click OK.

  • To delete a registered database, perform the following steps:

    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.

What to do next

Back up an Oracle database