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:

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

Add new configs to ambari-agent.ini file if not already present:

Under the [agent] section, add command_file_retention_policy=remove_on_success
under the [security] section, add agent_secret=HT/kjN2ou6EVo29OEO0LuueisFD5ZznlWORt+s2Kmj8=

⚠️ Placeholder secret — must be identical across all Ambari agents. Can be updated by the user to a secure value.

Start Ambari Agents:

Bash
    
 
ambari-agent start
Copy

Last updated on Jan 29, 2026

Was this page helpful?