Upgrade Ambari Agents

Before proceeding with the Ambari Agent Upgrade on all nodes where Ambari Agents are installed, ensure that you have stopped both the Ambari Server and Agents during the Ambari Server Upgrade. Before the upgrade, make sure to back up the file located at /etc/ambari-agent/conf/ambari-agent.ini.

Erase Ambari Agent: From the Ambari agents node, remove the installed packages before upgrading.

For RHEL:

Bash
    
 
yum remove ambari-agent -y
Copy

For Ubuntu:

Bash
    
 
apt remove ambari-agent -y
Copy

Update Repository Files: Update ambari.repo (RedHat) or ambari.list (Ubuntu). For repositories, refer Ambari Repositories.
Install Updated Agents:

If you are upgrading from any Python 2 based ODP version, make sure to perform the below additional steps to install Python 3.11 and its dependencies on all the hosts before proceeding with the next step.

For Ubuntu 20/22:

Bash
    
 
apt install software-properties-commonadd-apt-repository ppa:deadsnakes/ppaapt updateapt-get install python3.11 curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py/usr/bin/python3.11 get-pip.pypip3.11 install distro lxml rpm
Copy

For RHEL 8/9:

Bash
    
 
yum install python3.11 python3.11-pip pip3.11 install distro lxml rpm
Copy

Proceed with the Agent installation.

For RHEL:

Bash
    
 
yum clean allyum install ambari-agent -y
Copy

For Ubuntu:

Bash
    
 
apt cleanapt updateapt install ambari-agent -y
Copy

Restore Configuration Files: Backup /etc/ambari-agent/conf/ambari-agent.ini and restore /etc/ambari-agent/conf/ambari-agent.ini
Start Ambari Agents:

Before starting the Ambari server, make sure to set the Python and Python3 alternatives.

Bash
    
 
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.11 1
Copy

Bash
    
 
ambari-agent start
Copy

Last updated on Jan 13, 2026

Was this page helpful?