Managing Exadata Cloud Service Software Images Using the Dbaascli Utility

Note

You can create custom database software images for your Exadata Cloud Service instances using the Console or API. These images are stored in Object Storage, and can be used to provision a Database Home in your Exadata instance. See Oracle Database Software Images more information.

You can control the version of Oracle binaries that is installed when you provision a new database on an Exadata Cloud Service instance by maintaining the software images on the system. Oracle provides a library of cloud software images that you can view and download onto your instance by using the dbaascli utility.

When you create a new database with a new Oracle Home (Database Home) directory location, the Oracle Database binaries are sourced from a software image that is stored on your Exadata Cloud Service instance. Over time, the software images on your instance become outdated if they are not maintained. Using an outdated software image makes it necessary for you to apply patches to newly installed binaries to bring them up to date. Oracle recommends that you maintain your instance with up-to-date software images to avoid this extra patching step which can be time-consuming and error prone.

Viewing Information About Available Software Images

You can view information about Oracle Database software images that are available to download to your Exadata Cloud Service instance by using the cswlib list subcommand of the dbaascli utility.

To view information about available software images
  1. Connect to a compute node as the opc user.

    For detailed instructions, see Connecting to a Compute Node with SSH.

  2. Start a root-user command shell:

    $ sudo -s
    #
  3. Execute the dbaascli command with the cswlib list subcommand:

    # dbaascli cswlib list

    The command displays a list of available software images, including version and bundle patch information that you can use to download the software image.

  4. Exit the root-user command shell:

    # exit
    $

Downloading Software Images

You can download available software images onto your Exadata Cloud Service instance by using the cswlib download subcommand of the dbaascli utility.

To downloaded a software image
  1. Connect to a compute node as the opc user.

    For detailed instructions, see Connecting to a Compute Node with SSH.

  2. Start a root-user command shell:

    $ sudo -s
    #
  3. Execute the dbaascli command with the cswlib download subcommand:

    # dbaascli cswlib download [--version <software_version>] [--bp <software_bundle_patch>]

    The command displays a list of software images that are downloaded to your Exadata Cloud Service environment, including version and bundle patch information.

    The optional parameters are:

    • version: specifies an Oracle Database software version. For example, 19000, 18000, or 12201.
    • bp: identifies a bundle patch release. For example, APR2021, JAN2021, or OCT2020.

    If you do not include the optional parameters, the dbaascli cswlib download command downloads the latest available software image for all available Oracle Database software versions.

  4. Exit the root-user command shell:

    # exit
    $