Apache Ambari Upgrade
Also available as:

Register and Install Target Version

Before you use Ambari to perform the stack upgrade, you must register the software repositories for the new target version with Ambari and then install the software on all hosts in the cluster.

Register Target Version


  1. Log in to Ambari.

  2. Browse to Admin > Stack and Versions.

  3. Click the Versions tab. You see the version currently running, marked as Current.


    The full version depends on the HDP version you are actually running. For example, if you are currently running the HDP release, you would see something like HDP- as the full version number.

  4. Click Manage Versions.

  5. Proceed to register a new version by clicking + Register Version.

  6. Select the software version and method of delivery for your cluster.

    1. Choose HDP Stack.

      Available HDP minor versions display on tabs. When you click a tab, Ambari displays available maintenance versions for that HDP Stack on a drop-down list. When you click a specific maintenance version, a list of available Services and their version displays in a table.

    2. Choose HDP Version.

      If your Ambari host has internet access, available maintenance versions display as options in a drop-down list. If you have a Version Definition File (VDF) for a version that is not listed, you can click Add Version… and upload the VDF file. In addition, a Default Version Definition is also included in the list if you do not have Internet access or are not sure which specific version to install. If you choose the Default Version Definition, you must enter a "two-digit Version Number" in the Name input field.

    3. Choose Repository Delivery Method.

      • Use private Repository

        Using a private repository requires internet connectivity. To use the private software repositories, see the list of available HDP Repositories for each OS.

      • Use Local Repository

        Using a local repository requires that you have configured the software in a repository available in your network. If you are using a local repository, enter the Base URLs for your local repository.

  7. Click Save.

  8. Click Go To Dashboard, and browse back to Stack and Versions > Versions.

    You will see the version currently running, marked Current, and the target version you just registered, for example HDP- displaying an Install button. A registered Patch upgrade displays a bug fix icon to uniquely identify the patch.

Next Steps

Install Target Version


  1. Log in to Ambari.

  2. Browse to Admin > Stack and Versions.

  3. Click the Versions tab.

  4. On a registered target version, click Install and click OK to confirm.

    The Install version operation starts. This installs the target version on all hosts in the cluster. You can monitor the progress of the install by clicking the Installing link.


    If you have Apache Ranger on your cluster, confirm that the ambari-infra-solr-client package is installed on the Ranger Admin host. The Ambari Infra service contains the default Solr instance used by Apache Ranger.

    When the install completes, the Upgrade button replaces the Install button.

Next Steps

Perform the Upgrade.

More Information

Managing Versions

Using a Local Repository

Ambari Infra