Apache Ambari Upgrade
Also available as:

Register and Install Target Version

This section describes the steps to register the software repositories with Ambari for the new target version (i.e. the version you will be upgrading to) and how to install the software on all hosts before performing the upgrade.

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.

      The available HDP versions are shown in TABs. When you select a TAB, Ambari attempts to discover what specific version of that HDP Stack is available. That list is shown in a DROPDOWN. For that specific version, the available Services are displayed, with their Versions shown in the TABLE.

    2. Choose HDP Version.

      If Ambari has access to the Internet, the specific Versions will be listed as options in the DROPDOWN. If you have a Version Definition File 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.

      Using a Private Repository requires Internet connectivity. Using a Local Repository requires you have configured the software in a repository available in your network. To use the private software repositories, see the list of available HDP Repositories for each OS. Or, if you are using a local repository, enter the Base URLs for the local repository you have created.

  7. Click Save.

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

  9. You will see the version currently running, marked Current, and the version you just registered HDP- displaying an Install button.

Next Steps

Install Target Version


  1. Log in to Ambari.

  2. Browse to Admin > Stack and Versions.

  3. Click the Versions tab.

  4. 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