New in version 3.0.0.
The agent_upgrade program allows you to list outdated agents and upgrade them.
In case of having a multi-node Wazuh cluster, agent_upgrade must be executed on the node where the agent is connected.
||Display the help message.|
||Generates a list with all outdated agents.|
||Agent ID to upgrade.|
||Allows reinstall same version and downgrade version.|
||Do not show output.|
||Version to install.|
||Specify a repository URL.|
||Custom WPK filename.|
||Executable filename in the WPK custom file. By default it will try to launch upgrade.sh.|
||Timeout where the agent cannot restart while updating.|
||Chunk size sending WPK file. Allowed values: [1 - 64000]|
By default, the timeout will be the maximum allowed by the agent with the
execd.max_restart_lock option in internal_options.conf.
- List outdated agents:
# agent_upgrade -l
ID Name Version 002 VM_Debian9 Wazuh v3.0.0 003 VM_Debian8 Wazuh v3.0.0 009 VM_WinServ2016 Wazuh v3.0.0 Total outdated agents: 3
- Upgrade agent:
# agent_upgrade -a 002
Sending WPK: [=========================] 100% Upgrade procedure started... Please wait. Agent upgraded: Wazuh v3.0.0 -> Wazuh v3.1.0
- Downgrade agent using a custom repository:
# agent_upgrade -a 002 -dF -v v3.0.0 -r http://mycompany.wpkrepo.com/ -t 500
Manager version: v3.1.0 Agent version: v3.1.0 Agent new version: v3.0.0 Downloading WPK file from: http://mycompany.wpkrepo.com/debian/9/x86_64/wazuh_agent_v3.0.0_debian_9_x86_64.wpk WPK file downloaded: /var/ossec/var/upgrade/wazuh_agent_v3.0.0_debian_9_x86_64.wpk - SHA1SUM: d6f6855b65839d8ce75cc6977ab8b492174699f6 Upgrade PKG: wazuh_agent_v3.0.0_debian_9_x86_64.wpk (4151 KB) MSG SENT: 002 com open wb wazuh_agent_v3.0.0_debian_9_x86_64.wpk RESPONSE: ok MSG SENT: 002 com lock_restart 500 RESPONSE: ok Sending: /var/ossec/var/upgrade/wazuh_agent_v3.0.0_debian_9_x86_64.wpk MSG SENT: 002 com close wazuh_agent_v3.0.0_debian_9_x86_64.wpk RESPONSE: ok MSG SENT: 002 com sha1 wazuh_agent_v3.0.0_debian_9_x86_64.wpk RESPONSE: ok d6f6855b65839d8ce75cc6977ab8b492174699f6 WPK file sent MSG SENT: 002 com upgrade wazuh_agent_v3.0.0_debian_9_x86_64.wpk upgrade.sh RESPONSE: ok 0 Upgrade procedure started MSG SENT: 002 com upgrade_result RESPONSE: ok 0 Agent upgraded successfully
- Install custom WPK file:
# agent_upgrade -a 002 -d -f /root/upgrade_openscap_debian.wpk -x install.sh
Custom WPK file: upgrade_openscap_debian.wpk (852 KB) MSG SENT: 002 com open w upgrade_openscap_debian.wpk RESPONSE: ok MSG SENT: 002 com lock_restart -1 RESPONSE: ok FILE SHA1: b47bb9807a1bb4ffea8d0528c81ff8fa64fa6355 MSG SENT: 002 com close upgrade_openscap_debian.wpk RESPONSE: ok MSG SENT: 002 com sha1 upgrade_openscap_debian.wpk RESPONSE: ok b47bb9807a1bb4ffea8d0528c81ff8fa64fa6355 WPK file sent MSG SENT: 002 com upgrade upgrade_openscap_debian.wpk install.sh RESPONSE: ok 0 Installation started MSG SENT: 002 com upgrade_result RESPONSE: ok 0 Agent upgraded successfully
When the agent finishes updating, it is automatically restarted to apply the new configuration.