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

Steps

Log in to Ambari.
Browse to Cluster Admin > Stack and Versions.

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

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

Click Manage Versions.
Proceed to register a new version by clicking Register Version.
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.
  Make sure to use the Version Definition File (VDF) option for HDP-3.1.4.
  If you see the VDF option for another version, click Add Version… and upload the VDF file for HDP-3.1.4.
  If you have difficulites, please contact Hortworks Support to obtain the VDF for HDP-3.1.
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 HDP 3.1.4 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.
Click Save.
Click Dashboard.

Install Target Version

Steps

Browse to Cluster Admin > Stack and Versions.
Click the Versions tab.
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.

Next Steps

Upgrading Ambari Metrics System and SmartSense

More Information

Managing Versions

Using a Local Repository

​Register and Install Target Version

Register and Install Target Version