Skip to main content
Version Next

Apache Ambari Upgrade

Prerequisites

Apache Ambari Upgrade​

Package Repository​

Execute the following procedures on all Cluster machines to define a new package repository for Apache Ambari:

  • Access the directory where the Ambari package repository file (repo file) is located:

    Terminal input
    cd /etc/yum.repos.d/

  • Run the command below to download the ambari.repo file and save it to the local directory /etc/yum.repos.d/, to be used by the YUM package manager.

    Terminal input
    wget -O /etc/yum.repos.d/ambari.repo https://repo.tecnisys.com.br/repository/public/tdp/3.0/el-9-x86_64/ambari.repo
    Terminal input
    curl -o /etc/yum.repos.d/ambari.repo https://repo.tecnisys.com.br/repository/public/tdp/3.0/el-9-x86_64/ambari.repo
    warning

    The commands suggested below overwrite the /etc/yum.repos.d/ambari.repo file, if it already exists in the directory. If necessary, make a backup of the file with the current definitions first.

  • In the ambari.repo file, replace the USER and PASS variables, present in the URLs of the baseurl and gpgkey properties, respectively, with your username and password registered on the Tecnisys Website. If you are using a local repository, adjust these URLs.

  • After defining the new TDP version package repository, we recommend updating the yum/dnf cache:

    Terminal input
    yum clean all; yum makecache timer;

Ambari Agent Upgrade​

With the new package repository defined, start the Ambari upgrade by updating the Ambari Agent component.

warning

Communication between the Ambari Agent and the Ambari Server is suspended during the upgrade. However, the services of the other Cluster components continue running.

Figure 1 * Service status during the Ambari Agent upgrade
Figure 1 * Service status during the Ambari Agent upgrade

To upgrade the Ambari Agent, execute the following procedure on all Cluster machines:

  • Stop the Ambari Agent service:

    Terminal input
        ambari-agent stop

  • Upgrade the Ambari Agent binaries:

    Terminal input
        yum upgrade ambari-agent -y
    note

    Any customizations to the ambari-agent.ini file can be recovered from the generated backup file: ambari-agent.ini.old

  • Start the Ambari Agent service:

    Terminal input
        ambari-agent start

Ambari Server Upgrade​

After upgrading the Ambari Agent on all Cluster machines, perform the Ambari Server upgrade.

warning

This operation requires stopping the Ambari Server service.

warning

It is recommended to perform a backup of the Ambari metadata database before starting this operation.

Execute the following procedure only on the machine where the Ambari Server is installed:

  • Stop the Ambari Server service:

    Terminal input
        ambari-server stop

  • Upgrade the Ambari Server binaries:

    Terminal input
        yum upgrade ambari-server -y
    Figure 2 - Ambari Server binary upgrade
    Figure 2 - Ambari Server binary upgrade

  • Upgrade the Ambari Server metadata:

    Terminal input
        ambari-server upgrade
    note

    Basically, this command performs the following operations:

    • Ambari property adjustments.
    • Metadata database schema update.
    • Check for new TDP stack versions.
    Figure 3 - Ambari Server Upgrade
    Figure 3 - Ambari Server Upgrade

  • Start the Ambari Server:

    Terminal input
        ambari-server start

  • Check the new Ambari version in the web interface by clicking the user button, located in the upper right corner of the page, and then the About option.

    Figure 4 - Ambari Version
    Figure 4 - Ambari Version

  • Check the new TDP stack version in the web interface by clicking the Stack and Versions option in the side menu, and then the VERSIONS tab.

    important

    If the 'Host component out of sync' alert is displayed in the VERSIONS tab, execute the procedure defined in Current Stack Version Update to correct this inconsistency.