Apache Ambari Upgrade
Also available as:

Chapter 2. Getting Ready to Upgrade Ambari and HDP

When preparing to upgrade Ambari and the HDP Cluster, we strongly recommend you review this checklist of items to confirm your cluster operation is healthy. Attempting to upgrade a cluster that is operating in an unhealthy state can produce unexpected results.


As of January 31, 2021, all downloads of HDP and Ambari require a username and password and use a modified URL. You must use the modified URL, including the username and password when downloading the repository content.


If you are on Ambari 2.5.x.x version, it is recommended to upgrade to Ambari HotFix version.


If planning to upgrade Ambari and upgrade to a new HDP minor version (for example: moving from HDP 2.2 to HDP 2.3), upgrade Ambari to the latest version before upgrading the cluster.

  • Ensure all services in the cluster are running.

  • Run each Service Check (found under the Service Actions menu) and confirm they execute successfully.

  • Clear all alerts, or understand why they are being generated. Remediate as necessary.

  • Confirm start and stop for all services are executing successfully.

  • Time service start and stops. The time to start and stop services is a big contributor to overall upgrade time so having this information handy is useful.

  • Download the software packages prior to the upgrade. Place them in a local repository and/or consider using a storage proxy since multi-gigabyte downloads will be required on all nodes in the cluster.

  • Ensure point-in-time backups are taken of all databases that support the cluster. This includes (among others) Ambari, Hive Metastore, Ranger and Oozie.


    If you are upgrading to Ambari 2.4, you must make sure that the Ranger db root password is NOT set to blank before performing any HDP upgrade. Ambari requires that the Ranger db root password has a value. If you upgrade Ambari to 2.2 and upgrade HDP without setting a value for the Ranger db root password, Ranger Admin will fail to start after the upgrade.

    To prepare Ranger for upgrades, set the password for the Ranger DB root user to a non-blank value. Then, set the Ranger db root password field in Ambari Web to match this value. Finally, restart Ranger Admin using Ambari Web.

    For Ambari Upgrades

    • This (Ambari 2.5) Upgrade Guide will help you upgrade your existing Ambari server to version 2.5. If you are upgrading to another Ambari version, please be sure to use the Ambari Upgrade Guide for that version.

    • Be sure to review the Known Issues and Behavioral Changes for this, Ambari- release.

    For HDP Cluster Upgrades

    • Ensure sufficient disk space on /usr/hdp/<version> (roughly 3GB for each additional HDP release).

    • If you plan to add new services available with HDP to your cluster, the new services might include new service accounts. Any operational procedures required to support these new service accounts should be performed prior to the upgrade. The accounts will typically be required on all nodes in the cluster.

    • If your cluster includes Storm, document any running Storm topologies.

More Information

Hortonworks Support Matrix

Using a Local Repository

Ambari 2.6.2 Release Notes

Preparing to Upgrade