Updating the Cloud Tooling by Using the dbpatchm Subcommand

You use the dbpatchm subcommand of the dbaascli utility to update the cloud tooling on database deployments hosting a single-instance database or an Oracle Data Guard configuration of single-instance databases.

Note:

When updating the cloud tooling on database deployments hosting a Data Guard configuration, you must perform the following steps on both nodes; that is, on the one hosting the primary database and on the one hosting the standby database.
  1. Connect as the opc user to the compute node.

    See Connecting to a Compute Node Through Secure Shell (SSH).

  2. Start a root-user command shell:

    $ sudo -s
    #
  3. Check whether any cloud tooling updates are available:

    # dbaascli dbpatchm --run -list_tools

    If you receive an error message stating that the -list_tools option is not supported, the cloud tooling on the compute node is too old to support this method of updating cloud tooling. In this case, follow the instructions in I can’t use dbaascli to update my cloud tooling.

  4. In the command response, locate the patch ID of the cloud tooling update.

    The patch ID is listed as the "Patchid" value. If multiple patches are listed, choose the latest one.

  5. Check your current version of cloud tooling:

    # rpm -qa|grep -i dbaastools
    dbaastools-version_number-release_number
  6. After confirming that the latest update is newer than your current version, download and apply the patch containing the cloud tooling update:

    # dbaascli dbpatchm --run -toolsinst -rpmversion=patch-id

    where patch-id is the patch ID you located earlier.

    Note: if you get a warning message indicating that the toolsinst parameter is invalid, you can ignore the message.

  7. Reset the backup configuration:

    # /var/opt/oracle/ocde/assistants/bkup/bkup
  8. Exit the root-user command shell and disconnect from the compute node:

    # exit
    $ exit
  9. If you are updating cloud tooling on a database deployment hosting a Data Guard configuration, repeat the preceding steps on the other compute node of the deployment.