Upgrading the Wazuh agent from 2.x to 3.x

The following steps show how to upgrade the Wazuh agent from 2.x to 3.x.

Upgrading the Wazuh agent

To upgrade the Wazuh agent choose the appropriate tab for the desired operating system:

Add the new repository for Wazuh 3.x:

# cat > /etc/yum.repos.d/wazuh.repo <<\EOF
[wazuh_repo]
gpgcheck=1
gpgkey=https://packages.wazuh.com/key/GPG-KEY-WAZUH
enabled=1
name=Wazuh repository
baseurl=https://packages.wazuh.com/4.x/yum/
protect=1
EOF

Upgrade the Wazuh agent:

# yum install wazuh-agent

It is recommended to disable the Wazuh repository in order to avoid undesired upgrades and compatibility issues as the Wazuh agent should always be in the same or lower version than the Wazuh manager:

# sed -i "s/^enabled=1/enabled=0/" /etc/yum.repos.d/wazuh.repo

Add the new repository for Wazuh 3.x:

# echo "deb https://packages.wazuh.com/4.x/apt/ stable main" | tee -a /etc/apt/sources.list.d/wazuh.list

Upgrade the Wazuh agent:

# apt-get update
# apt-get install wazuh-agent

It is recommended to disable the Wazuh repository in order to avoid undesired upgrades and compatibility issues as the Wazuh agent should always be in the same or lower version than the Wazuh manager:

# sed -i "s/^deb/#deb/" /etc/apt/sources.list.d/wazuh.list
# apt-get update

Alternatively, the user can set the package state to hold, which will stop updates. It will be still possible to upgrade it manually using apt-get install:

# echo "wazuh-agent hold" | sudo dpkg --set-selections

Add the new repository for Wazuh 3.x:

# rpm --import https://packages.wazuh.com/key/GPG-KEY-WAZUH
# cat > /etc/zypp/repos.d/wazuh.repo <<\EOF
[wazuh_repo]
gpgcheck=1
gpgkey=https://packages.wazuh.com/key/GPG-KEY-WAZUH
enabled=1
autorefresh=1
name=Wazuh repository
baseurl=https://packages.wazuh.com/4.x/yum/
protect=1
EOF

Upgrade the Wazuh agent:

# zypper update wazuh-agent

It is recommended to disable the Wazuh repository in order to avoid undesired upgrades and compatibility issues as the Wazuh agent should always be in the same or lower version than the Wazuh manager:

# sed -i "s/^enabled=1/enabled=0/" /etc/zypp/repos.d/wazuh.repo

The Wazuh agent upgrade process for Windows systems requires to download the latest available installer from the packages list. There are two ways of using it, both require administrator rights:

  • Using the GUI installer:

    Open the installer and follow the instructions to upgrade the Wazuh agent:

    ../../../_images/windows.png
  • Using the command line:

    To upgrade the Wazuh agent from the command line, run the installer using Windows PowerShell or the command prompt. The /q argument is used for unattended installations:

    # wazuh-agent-4.2.4-1.msi /q
    

    Note

    To learn more about the unattended installation process, please read the Windows installation guide.

On MacOS X system the Wazuh agent upgrade can be done by deleting the previous version and installing the newest version of the Wazuh agent from scratch. As the Wazuh agent’s ossec.conf configuration file will be overwritten it is recommended to backup the old configuration file and import previous settings where needed.

More information about the process can be found in the Wazuh agent installation and deployment on MacOS X section.

On the Unix based systems the Wazuh agent upgrade can be done by deleting the previous version and installing the newest version of the Wazuh agent from scratch. As the Wazuh agent’s ossec.conf configuration file will be overwritten it is recommended to backup the old configuration file and import previous settings where needed.

More information about the process can be found following the appropriate link for the desired operating system: