Áú»¢¶Ä²©

2 Debian/Ubuntu

Overview

Make sure to read general information about upgrading first.

Upgrade procedure

1 Stop Áú»¢¶Ä²© processes

Stop Áú»¢¶Ä²© server to make sure that no new data is inserted into database.

# service zabbix-server stop

If upgrading Áú»¢¶Ä²© proxy, stop proxy too.

# service zabbix-proxy stop

2 Back up the existing Áú»¢¶Ä²© database

This is a very important step. Make sure that you have a backup of your database. It will help if the upgrade procedure fails (lack of disk space, power off, any unexpected problem).

3 Back up configuration files, PHP files and Áú»¢¶Ä²© binaries

Make a backup copy of Áú»¢¶Ä²© binaries, configuration files and the PHP file directory.

Configuration files:

# mkdir /opt/zabbix-backup/
       # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
       # cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

PHP files and Áú»¢¶Ä²© binaries:

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       # cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/

4 Update repository configuration package

To proceed with the update your current repository package has to be uninstalled.

# rm -Rf /etc/apt/sources.list.d/zabbix.list

Then install the new repository configuration package.

On Debian 9 run:

# wget https://repo.zabbix.com/zabbix/3.4/debian/pool/main/z/zabbix-release/zabbix-release_3.4-1+stretch_all.deb
       # dpkg -i zabbix-release_3.4-1+stretch_all.deb

On Debian 8 run:

# wget https://repo.zabbix.com/zabbix/3.4/debian/pool/main/z/zabbix-release/zabbix-release_3.4-1+jessie_all.deb
       # dpkg -i zabbix-release_3.4-1+jessie_all.deb

On Debian 7 run:

# wget https://repo.zabbix.com/zabbix/3.4/debian/pool/main/z/zabbix-release/zabbix-release_3.4-1+wheezy_all.deb
       # dpkg -i zabbix-release_3.4-1+wheezy_all.deb

On Ubuntu 18.04 run:

# wget https://repo.zabbix.com/zabbix/3.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_3.4-1+bionic_all.deb
       # dpkg -i zabbix-release_3.4-1+bionic_all.deb

On Ubuntu 16.04 run:

# wget https://repo.zabbix.com/zabbix/3.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_3.4-1+xenial_all.deb
       # dpkg -i zabbix-release_3.4-1+xenial_all.deb

On Ubuntu 14.04 run:

# wget https://repo.zabbix.com/zabbix/3.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_3.4-1+trusty_all.deb
       # dpkg -i zabbix-release_3.4-1+trusty_all.deb

Update the repository information.

# apt-get update

5 Upgrade Áú»¢¶Ä²© components

To upgrade Áú»¢¶Ä²© components you may run something like:

# apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

If using PostgreSQL, substitute mysql with pgsql in the command. If upgrading the proxy, substitute server with proxy in the command.

6 Review component configuration parameters

See the upgrade notes for details on mandatory changes.

For new optional parameters, see the What's new section.

7 Start Áú»¢¶Ä²© processes

Start the updated Áú»¢¶Ä²© components.

# service zabbix-server start
       # service zabbix-proxy start
       # service zabbix-agent start

8 Clear web browser cookies and cache

After the upgrade you may need to clear web browser cookies and web browser cache for the Áú»¢¶Ä²© web interface to work properly.

Upgrade between minor versions

It is possible to upgrade minor versions of 3.4.x (for example, from 3.4.1 to 3.4.3). It is easy.

To upgrade Áú»¢¶Ä²© minor version please run:

$ sudo apt install --only-upgrade 'zabbix.*'

To upgrade Áú»¢¶Ä²© server minor version please run:

$ sudo apt install --only-upgrade 'zabbix-server.*'

To upgrade Áú»¢¶Ä²© agent minor version please run:

$ sudo apt install --only-upgrade 'zabbix-agent.*'