Upgrade Ambari
If you are running Ambari Metrics service in your cluster, stop the service. From Ambari Web, browse to Services > Ambari Metrics and select Stop from the Service Actions menu.
Stop the Ambari Server. On the host running Ambari Server:
ambari-server stop
Stop all Ambari Agents. On each host in your cluster running an Ambari Agent:
ambari-agent stop
Fetch the new Ambari repo and replace the old repository file with the new repository file on all hosts in your cluster.
Important Check your current directory before you download the new repository file to make sure that there are no previous versions of the
ambari.repo
file. If you do not, and a previous version exists, the new download will be saved with a numeric extension, such asambari.repo.1
. Make sure that the version you copy is the new version.Select the repository appropriate for your environment from the following list:
For RHEL/CentOS/Oracle Linux 6:
wget -nv https://username:password@archive.cloudera.com/p/ambari/2.x/2.6.1.21/centos6/ambari.repo -O /etc/yum.repos.d/ambari.repo
For RHEL/CentOS/Oracle Linux 7:
wget -nv https://username:password@archive.cloudera.com/p/ambari/2.x/2.6.1.21/centos7/ambari.repo -O /etc/yum.repos.d/ambari.repo
For SLES 11:
wget -nv https://username:password@archive.cloudera.com/p/ambari/2.x/2.6.1.21/suse11/ambari.repo -O /etc/zypp/repos.d/ambari.repo
For SLES 12:
wget -nv https://username:password@archive.cloudera.com/p/ambari/2.x/2.6.1.21/sles12/ambari.repo -O /etc/zypp/repos.d/ambari.repo
For Ubuntu 14:
wget -nv https://username:password@archive.cloudera.com/p/ambari/2.x/2.6.1.21/ubuntu14/ambari.list -O /etc/apt/sources.list.d/ambari.list
For Ubuntu 16:
wget -nv https://username:password@archive.cloudera.com/p/ambari/2.x/2.6.1.21/ubuntu16/ambari.list -O /etc/apt/sources.list.d/ambari.list
Note If your cluster does not have access to the Internet, set up a local repository with this data before you continue.
Note Ambari Server does not automatically turn off
iptables
. Check that your installation setup does not depend oniptables
being disabled. After upgrading the server, you must either disableiptables
manually or make sure that you have appropriate ports available on all cluster hosts.Upgrade Ambari Server. On the host running Ambari Server:
For RHEL/CentOS/Oracle Linux:
yum clean all
yum info ambari-server
In the info output, visually validate that there is an available version containing "2.6"
yum upgrade ambari-server
For SLES:
zypper clean
zypper info ambari-server
In the info output, visually validate that there is an available version containing "2.6"
zypper up ambari-server
For Ubuntu/Debian:
apt-get clean all
apt-get update
apt-cache show ambari-server | grep Version
In the info output, visually validate that there is an available version containing "2.6"
apt-get install ambari-server
Important When performing upgrade on SLES, you will see a message "There is an update candidate for 'ambari-server', but it is from different vendor. Use 'zypper install ambari-server-2.6.1-143.noarch' to install this candidate". You will need to to use yast to update the package, as follows:
From the command line run: > yast.
> yast
You will see command line UI for YaST program.
Choose Software > Software Management, then click the Enter button.
In the Search Phrase field, enter
ambari-server
, then click the Enter button.On the right side you will see the search result
ambari-server 2.6
. Click Actions, choose Update, then click the Enter button.Go to Accept, and click enter.
Check for upgrade success by noting progress during the Ambari Server installation process you started in Step 5.
As the process runs, the console displays output similar, although not identical, to the following:
Setting up Upgrade Process Resolving Dependencies --> Running transaction check
If the upgrade fails, the console displays output similar to the following:
Setting up Upgrade Process No Packages marked for Update
A successful upgrade displays output similar to the following:
Updated: ambari-server.noarch 0:2.6.1.21 >>>>>>> 03fbfcf1a... Ambari 2.6.x Paywall changes Complete!
Note Confirm there is only one ambari-server*.jar file in
/usr/lib/ambari-server
. If there is more than one JAR file with name ambari-server*.jar, move all JARs except ambari-server-2.6.*.jar to/tmp
before proceeding with upgrade.Upgrade all Ambari Agents. On each host in your cluster running an Ambari Agent:
For RHEL/CentOS/Oracle Linux:
yum upgrade ambari-agent
For SLES:
zypper up ambari-agent
Note Ignore the warning that begins with "There are some running programs that use files deleted by recent upgrade".
Important When performing upgrade on SLES, you will see a message "There is an update candidate for 'ambari-agent', but it is from different vendor. Use 'zypper install ambari-agent-2.6-143.noarch' to install this candidate". You will need to to use yast to update the package, as follows:
From the command line run: > yast
> yast
You will see command line UI for YaST program.
Choose Software > Software Management, then click the Enter button.
In the Search Phrase field, enter ambari-agent, then click the Enter button.
On the right side you will see the search result
ambari-agent 2.6
. Click Actions, choose Update, then click the Enter button.Go to Accept, and click enter.
For Ubuntu/Debian:
apt-get update apt-get install ambari-agent
After the upgrade process completes, check each host to make sure the new files have been installed:
- For RHEL/CentOS/Oracle Linux 6:
rpm -qa | grep ambari-agent
- For RHEL/CentOS/Oracle Linux 7:
rpm -qa | grep ambari-agent
- For SLES 11:
rpm -qa | grep ambari-agent
- For SLES 12:
rpm -qa | grep ambari-agent
- For Ubuntu 14:
dpkg -l ambari-agent
- For Ubuntu 16:
dpkg -l ambari-agent
- For Debian 7:
dpkg -l ambari-agent
Upgrade Ambari Server database schema. On the host running Ambari Server:
ambari-server upgrade
Start the Ambari Server. On the host running Ambari Server:
ambari-server start
Start all Ambari Agents. On each host in your cluster running an Ambari Agent:
ambari-agent start
Open Ambari Web.
Point your browser to
http://<your.ambari.server>:8080
where <your.ambari.server> is the name of your ambari server host. For example, c6401.ambari.apache.org.
Important Refresh your browser so that it loads the new version of the Ambari Web code. If you have problems, clear your browser cache manually, then restart Ambari Server.
Log in, using the Ambari administrator credentials that you have set up.
For example, the default name/password is admin/admin.
You will see a Restart indicator next to each service after upgrading. Ambari upgrade has added to/adjusted the configuration properties of your cluster based on new configuration types and properties being made available for each service with this release of Ambari. Review these changes by comparing the previous configuration with the latest version created by "ambari-upgrade".
If you have configured Ambari to authenticate against an external LDAP or Active Directory, you must re-run
ambari-server setup-ldap
If you have configured your cluster for Hive or Oozie with an external database (Oracle, MySQL or PostgreSQL), you must re-run
ambari-server setup --jdbc-db and --jdbc-driver
to get the JDBC driver .jar file in place.
If you are running Ambari Metrics service in your cluster, you must upgrade Ambari Metrics System and add the Grafana component.
If your cluster includes the SmartSense service, you must upgrade SmartSense along with Ambari.
Perform any other post-upgrade tasks, as necessary.
Important | |
---|---|
Completing post-upgrade tasks is mandatory. |
Next Steps
Post-Upgrade Tasks Mandatory
More Information
Configuring Network Port Numbers
Set Up LDAP or Active Directory Authentication
Using New and Existing Databases - Hive