Cloudera Docs

Performing a Cloudera operating system upgrade [Technical Preview]

Learn how to perform a rolling and a non-rolling Operating System (OS) upgrade for your existing Cloudera Operational Database (COD) in the CDP environment.

  • You need to use the CDP Beta CLI and run the upgrade-database command to upgrade your database.
  • Currently, the rolling upgrade is supported for COD clusters whose storage is selected as HDFS or cloud without ephemeral storage.
  • Zero downtime upgrade or rolling upgrade is not supported on Micro COD clusters.
  • It is recommended not to perform backups or run YARN jobs during COD upgrade operations.
  • You must have the ODAdmin rights to make changes to the COD database.
  • In the Cloudera Manager, increase the Region Mover Threads property for the HBase service to 30 for a faster rolling upgrade.
  • In the Cloudera Manager, increase the Omid Max Heapsize property for the Omid service to at least 3GB.
  • You must download and install the latest CDP CLI beta version.
  1. Launch the CDP CLI tool.
  2. Run the following command to perform a rolling OS upgrade for the database.
    This command upgrades the OS for the operational database using the rolling restart mode that ensures continuous service availability.

    cdp opdb upgrade-database --environment <environment-name> --database <database-name> [--runtime <runtime-version> | --image <imageId>] --os-upgrade-only --rolling-upgrade

    Option Description
    --environment (string) The name or CRN of the environment.
    --database <value> The name or CRN of the database.
    --os-upgrade-only Requests OS upgrade.
    --runtime <value> The 3-digit runtime version to upgrade to. Alternatively, specify the --image option.
    --image <value> The image ID to upgrade to. Alternatively, specify the --runtime option.
    --rolling-upgrade Controls whether to perform a rolling upgrade for the COD.
    --edge-upgrade-strategy <type> Controls the upgrade strategy for the edge nodes in the cluster. Following are the supported values:
    • ALL: Upgrades all the edge nodes together.
    • ONE_BY_ONE: Upgrades the edge nodes, one by one.

    Run the following command to perform a non-rolling OS upgrade for the database.

    cdp opdb upgrade-database --environment <environment-name> --database <database-name> [--runtime <runtime-version> | --image <imageId>] --os-upgrade-only

COD is upgraded to the provided operating system version in a rolling mode.