Cloud Backup:Register an on-premises Oracle database

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.

   

3. In the Add Client panel, install 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.

     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=="

   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.exe and click Next.

      

      Select File and Oracle and click Next.

      

      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.

      

   3. When the installation is complete, use PowerShell to run the command obtained from the Cloud Backup console in the decompressed directory.

      

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

      

   4. 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, enter your database username and password, and click OK.

         

   After you register and activate the on-premises database, you can check that Status of the Oracle database is Online on the Local Database Instance tab.

   

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.