# Upgrading Cloudera Base on premises to a higher version > Canonical URL: https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/ Product: cdp-private-cloud-upgrade latest ## [Overview](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-cdpdc.html) ## [About using this online Upgrade Guide](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cdpdc-on-line-upgrade-guide.html) How to fill in forms to customize the documentation for your upgrade. ## [How much time should I plan for to complete my upgrade?](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-time-planning.html) An in-place upgrade can take a variable amount of time to complete. Learn about how to plan for and shorten the amount of time required for your upgrade. ## [Upgrading the Operating System](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-os-upgrade.html) This guide provides comprehensive instructions for upgrading the operating system on hosts managed by Cloudera Manager. It outlines critical version compatibility checks, Java dependency requirements, and detailed procedures for both rolling and offline upgrade methods. Following these steps ensures a stable transition while maintaining cluster integrity and minimizing potential service disruptions. ### [Preparing for the Operating System Upgrade](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-prepare-os-upgrade.html) Before initiating an operating system upgrade, you must complete several prerequisite operations to ensure environmental readiness. These steps apply to both offline and rolling upgrade strategies and focus on validating software compatibility and infrastructure access. Neglecting these preparations can lead to significant service disruptions, incompatible software configurations, or extended cluster downtime during the migration process. ### [Method 1: Rolling Upgrade](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-rolling-os-upgrade.html) This topic describes the rolling upgrade process, which allows you to update host operating systems in sequential batches. This method maintains cluster availability and prevents downtime during migration. ### [Method 2: Offline Upgrade](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-offline-os-upgrade.html) This topic describes the offline upgrade process, which requires a full cluster shutdown to update all host operating systems simultaneously. This method is faster but causes significant downtime. ## [Cloudera JDK upgrade path options](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_jdk8-cdp.html) Before the upgrade can commence, the administrator must first understand the starting point and the target environment of Cloudera release, so the matching JDK release could be used accordingly. ## [Python Guidelines](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/upgrade-python-cdp.html) Identify the correct Python version for your specific combination of Cloudera Manager and Cloudera Runtime on supported operating systems. Cloudera recommends using Python 3.11 or higher across all deployments. Learn how to migrate Python for different combinations of Cloudera Manager and Cloudera Runtime on the supported operating systems. ## [Upgrading Cloudera Manager 7](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade.html) Steps to upgrade Cloudera Manager. ### [Step 1: Getting Started Upgrading Cloudera Manager 7](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_before-cdp.html) ### [Step 2: Backing Up](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup.html) Cloudera recommends that you backup Cloudera Manager before upgrading. - [Collect Information](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_collect_info.html): Information you should collect before backing up Cloudera Manager. - [Back Up Cloudera Manager Agent](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_agent.html) - [Back Up the Cloudera Management Service](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_management_service.html) - [Stop Cloudera Manager Server & Cloudera Management Service](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_stop_management_service.html) - [Back Up the Databases](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_databases.html): During the upgrade, Cloudera Manager modifies the schema of the Cloudera Manager database. In case of failures during the upgrade, it may be necessary to rollback to the previous version of Cloudera Manager while addressing the upgrade failures. - [Back Up Cloudera Manager Server](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_server.html) - [(Optional) Start Cloudera Manager Server & Cloudera Management Service](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_start_management_service-cdp.html) ### [Step 3: Upgrading the Server](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_server-cdp.html) ### [Step 4: Upgrading the Agents](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_agent-cdp.html) ### [Step 5: After You Upgrade](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_after-cdp.html) - [Upgrading Cloudera Navigator Key Trustee Server 7.1.x](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/security-kts-upgrade-cm-cdp.html): How to upgrade Cloudera Navigator Key Trustee Server 7.1.x. - [Upgrading Cloudera Navigator Key HSM](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/navigator_key_hsm_upgrade.html): Learn how to upgrade Navigator Key HSM. - [Upgrading Cloudera Navigator Encrypt](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/navigator_encrypt_upgrade_7_x.html) ### [Troubleshooting](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_ts.html) ### [Reverting a Failed Upgrade](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_downgrade-cdp.html) ## [Installing dependencies for Hue](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-install-hue-dependencies.html) You must install the psycopg2 Python package for PostgreSQL-backed Hue and MySQL clients for MariaDB and MySQL databases depending on your operating systems. ### [Installing the psycopg2 Python package for PostgreSQL database](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cdpdc-installing-psycopg2-package.html) If you are using PostgreSQL as a backend database for Data Explorer on Cloudera Base on premises 7.3.x, then you must install a version of the psycopg2 package to be at least 2.9.6 on all Data Explorer hosts. The psycopg2 package is automatically installed as a dependency of Cloudera Manager Agent, but the version installed is often lower than 2.9.3. ### [Installing MySQL client for MySQL databases](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/hue-install-mysql-client-mysql-db.html) To use MySQL as a backend database for Data Explorer, you must install the MySQL client and other required dependencies on all the Data Explorer hosts based on your operating system. ### [Installing MySQL client for MariaDB databases](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/hue-install-mysql-client-mariadb-db.html) To use MariaDB as a backend database for Data Explorer, you must install the MySQL client and other required dependencies on all the Hue hosts based on your operating system. ## [Getting started with Zero Downtime Upgrade (ZDU)](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/zdu-getting-started.html) Understand what ZDU process is and when you can use this process to upgrade your existing Cloudera Runtime cluster to the latest version. Also, review the high-level steps involved in completing a Zero Downtime upgrade. ### [Software Requirements](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/zdu-software-requirements.html) - [Configuring components before starting ZDU](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/zdu-software-requirements.html) - [Check and enable High Availability service for your components](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/zdu-software-requirements.html) ### [ZDU Component Support](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/zdu-supported-components.html) The following components are supported when upgrading to Cloudera Runtime 7.1.9 and higher. ### [Service components limitations](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/zdu-considerations-limitations.html) You should be aware of certain limitations and considerations related to service components such as Atlas, Kudu, and YARN, to ensure that your cluster can successfully complete the Zero Downtime Upgrade (ZDU) process. ### [Glossary of terminologies](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/zdu-terminologies.html) Review and understand the ZDU terminologies before performing the cluster upgrade. ## [Upgrading a Cloudera Runtime Cluster](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrading_top.html) ### [Step 1: Getting Started](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_before-cdp.html) Tasks you should perform before starting the upgrade. ### [Step 2: Review Notes and Warnings](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_review-notes.html) Notes and warnings to consider before upgrading to Cloudera Base on premises. ### [Step 3: Backing Up the Cluster](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_backup.html) Steps to back up your cluster before the upgrade. - [Prerequisites for external database](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cdpdc-prerequisites-database.html): This topic describes the external database prerequisites for Cloudera Base on premises. Before you upgrade your cluster, you must review the prerequisites for the external database and then perform the cluster upgrade. - [Oozie database prerequisites](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cdpdc-prerequisites-oozie.html): This topic describes the prerequisites for configuring an external database for Oozie in Cloudera Base on premises. - [Ranger database prerequisites](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cdpdc-prerequisites-database-ranger.html): This topic describes the prerequisites for configuring an external database for Ranger in Cloudera Base on premises. - [Backing up ranger_audits Solr collection](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-cdp-upgrade-backup-rangeraudits-solr-collection.html): Perform a critical pre-upgrade step for Cloudera 7.3.2.0 or higher releases, focusing on the Ranger Audits Solr collection. This includes the process of backing up the existing ranger_audits collection and schema. ### [Step 4: Back Up Cloudera Manager](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_backup_cloudera-manager.html) After upgrading Cloudera Manager and before upgrading a cluster, you should backup Cloudera Manager again. - [Collect Information](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_collect_info_cluster.html): Information you should collect before backing up Cloudera Manager. - [Back Up Cloudera Manager Agent](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_agent_cluster.html) - [Back Up the Cloudera Management Service](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_management_service_cluster.html) - [Stop Cloudera Manager Server & Cloudera Management Service](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_stop_management_service_cluster.html) - [Back Up the Databases](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_databases_cluster.html): During the upgrade, Cloudera Manager modifies the schema of the Cloudera Manager database. In case of failures during the upgrade, it may be necessary to rollback to the previous version of Cloudera Manager while addressing the upgrade failures. - [Back Up Cloudera Manager Server](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_server_cluster.html) - [(Optional) Start Cloudera Manager Server & Cloudera Management Service](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cm_upgrade_backup_start_management_service_cluster.html) ### [Step 5: Access Parcels](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_parcels.html) Steps to access the Parcels required to install Cloudera Runtime. ### [Step 6: Enter Maintenance Mode](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_enter_maintenance.html) You can enable Maintenance Mode to avoid unnecessary alerts during the upgrade. ### [Step 7: Run the Upgrade Cluster Wizard](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_wizard.html) The Upgrade Wizard manages the upgrade of your Cloudera Runtime software. The Upgrade Wizard is not used for upgrades to Service Packs or Hotfixes. ### [Step 8: Finalize the HDFS or Ozone Upgrade](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_hdfs_finalize.html) Steps to finalize the HDFS or Ozone upgrade. This step is required only when Apache Hadoop version changes. ### [Step 9: Complete Post-Upgrade steps for upgrades to Cloudera Base on premises](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_cdp2cdp_post.html) Steps to perform after upgrading a cluster. ### [Step 10: Exit Maintenance Mode](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdp_upgrade_exit_maintenance.html) If you enabled Maintenance Mode before the upgrade, you must exit Maintenance Mode to complete the upgrade. ## [ZDU known issues](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/zdu-troubleshooting.html) If the ZDU process fails, the upgrade is not aborted but paused. You must review the issues to fix the cause of failure and resume with the upgrade. ## [Applying a Service Pack](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_runtime_service_pack.html) Applying a Service Pack is completed without running the Upgrade Wizard. ## [How to Install Cumulative Hotfix (CHF)](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cdp-upgrade-chf.html) You can upgrade CDP Private Cloud Base 7.1.7, CDP Private Cloud Base 7.1.7 SP1, CDP Private Cloud Base 7.1.7.SP2, CDP Private Cloud Base 7.1.7.SP3, CDP Private Cloud Base 7.1.8, CDP Private Cloud Base 7.1.9 SP1, Cloudera Base on premises 7.3.1 CHF1 (7.3.1.100) and so on with the CHFs available. Cumulative Hotfix is a collection of hotfixes. You can use the same procedure to install hotfixes as well. ## [Manual upgrade to Cloudera Base on premises](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cdh-cdp-manual-upgrade.html) Manual steps to follow for upgrading a Cloudera Runtime cluster to a higher version of Cloudera Runtime if the Upgrade Wizard fails. ## [Troubleshooting](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug_cdh_upgrade_troubleshooting.html) ### [Ranger database upgrade failure](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-cdp-upgrade-troubleshooting-rangerdb.html) This section includes error messages and troubleshooting for issues noticed during Ranger upgrade. ### [Restoring Ranger Audit Solr schema and collection](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/ug-cdp-upgrade-troubleshooting-restore-rangeraudit-solrschema-collection.html) If you encounter any failure during the upgrade, you must restore the Ranger audits Solr schema and collection to their previous state. ## [Configuring a Local Package Repository](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cm_ig_create_local_package_repo.html) ## [Configuring a Local Parcel Repository](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cm_ig_create_local_parcel_repo.html) ## [Applications Upgrade](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/upgrade-applications-upgrade.html) After you upgrade, you must test all the services that run on your platform. ## [Rollback and Downgrade Cloudera Base on premises](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/cdp-rollback-downgrade-overview.html) Depending up the Cloudera Base on premises version, you can perform the rollback or downgrade steps. ### [Downgrade or Rollback from Cloudera Base on premises 7.3.2 or 7.3.1](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/downgrade_rollback_731.html) You can rollback an upgrade from Cloudera Base on premises 7.3.2 or 7.3.1 to 7.3.1, 7.1.9 SP1, 7.1.9, CDP 7.1.8 cumulative hotfix 17, or 7.1.7 SP3. You can downgrade an upgrade from Cloudera Base on premises 7.3.2 or 7.3.1 to 7.3.1, 7.1.9 SP1, 7.1.9, CDP 7.1.8 cumulative hotfix 17, or 7.1.7 SP3. Before you downgrade or rollback, inspect each supported component to ensure that your intended process works seamlessly. - [Downgrade from Cloudera Base on premises 7.3.2 or 7.3.1](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/downgrade_731.html): Perform the below procedure to downgrade your cluster from Cloudera Base on premises 7.3.2 or 7.3.1 to 7.3.1, 7.1.9 SP1, 7.1.9, CDP 7.1.8 cumulative hotfix 17, or 7.1.7 SP3. - [Rollback from Cloudera Base on premises 7.3.1 or 7.3.2](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/rollback_731.html): Perform the following instructions to rollback a Cloudera Runtime cluster from versions 7.3.2 or 7.3.1 to a previous stable release (such as 7.3.1, 7.1.9 SP1, 7.1.9, CDP 7.1.8 cumulative hotfix 17, or 7.1.7 SP3). The process involves reverting the Cloudera Manager and Cloudera Management Services, stopping cluster services, activating the prior Runtime parcel, and restoring service-specific databases from pre-upgrade backups. ### [Downgrade or Rollback from CDP Private Cloud Base 7.1.9](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/downgrade_rollback_719.html) You can rollback an upgrade from CDP Private Cloud Base 7.1.9 to CDP Private Cloud Base 7.1.8 or 7.1.7 SP3. You can downgrade an upgrade from CDP Private Cloud Base 7.1.9 to CDP Private Cloud Base 7.1.8 or 7.1.7 SP3. Before you downgrade or rollback, make sure that you inspect each supported component to ensure that your intended process works in a seamless manner. - [Downgrade from CDP Private Cloud Base 7.1.9](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/downgrade_719.html): Perform the below procedure to downgrade your cluster from CDP Private Cloud Base 7.1.9 to CDP Private Cloud Base 7.1.8 or 7.1.7 SP3. - [Rollback from CDP Private Cloud Base 7.1.9 and associated Service Packs](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/rollback_719.html): Use the following procedure to rollback your cluster from CDP Private Cloud Base 7.1.9, 7.1.9 SP1, or 7.1.9 SP2 to an earlier supported version, such as CDP Private Cloud Base 7.1.8 or 7.1.7 SP3. ### [Rollback between SP or CHF releases](https://docs.cloudera.com/cdp-private-cloud-upgrade/latest/upgrade-cdp/topics/rollback-cloudera-base-on-premises-sps-chfs.html) You can perform a rollback from a just installed CHF (Cumulative Hotfix) or SP (Service Pack) release to the previously installed CHF or SP release, provided both releases belong to the same Cloudera Base on premises release line.