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.
- The operating system rolling upgrade is currently 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.
-
Launch the CDP CLI tool.
-
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.
