Apache Ambari Minor 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 Cluster 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 Dashboard.

Install Target Version


  1. Browse to Cluster Admin > Stack and Versions.

  2. Click the Versions tab.

  3. On a registered target version, click Install Packages 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.

    When the installation completes, the Upgrade button replaces the Install Packages button.

More Information

Managing Versions

Using a Local Repository