�����IJ�

2 Debian/Ubuntu

Overview

Make sure to read general information about upgrading first.

Upgrade procedure

1 Stop �����IJ� processes

Stop �����IJ� server to make sure that no new data is inserted into database.

# service zabbix-server stop

If upgrading �����IJ� proxy, stop proxy too.

# service zabbix-proxy stop

2 Back up the existing �����IJ� 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 �����IJ� binaries

Make a backup copy of �����IJ� 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 �����IJ� 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.0/debian/pool/main/z/zabbix-release/zabbix-release_3.0-2+stretch_all.deb
       # dpkg -i zabbix-release_3.0-2+stretch_all.deb

On Debian 8 run:

# wget https://repo.zabbix.com/zabbix/3.0/debian/pool/main/z/zabbix-release/zabbix-release_3.0-2+jessie_all.deb
       # dpkg -i zabbix-release_3.0-2+jessie_all.deb

On Debian 7 run:

# wget https://repo.zabbix.com/zabbix/3.0/debian/pool/main/z/zabbix-release/zabbix-release_3.0-2+wheezy_all.deb
       # dpkg -i zabbix-release_3.0-2+wheezy_all.deb

On Ubuntu 18.04 run:

# wget https://repo.zabbix.com/zabbix/3.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_3.0-2+bionic_all.deb
       # dpkg -i zabbix-release_3.0-2+bionic_all.deb

On Ubuntu 16.04 run:

# wget https://repo.zabbix.com/zabbix/3.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_3.0-2+xenial_all.deb
       # dpkg -i zabbix-release_3.0-2+xenial_all.deb

On Ubuntu 14.04 run:

# wget https://repo.zabbix.com/zabbix/3.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_3.0-2+trusty_all.deb
       # dpkg -i zabbix-release_3.0-2+trusty_all.deb

Update the repository information.

# apt-get update

5 Upgrade �����IJ� components

To upgrade �����IJ� 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

The HistoryTextCacheSize parameter has been replaced by a new HistoryIndexCacheSize server/proxy parameter, which must be present for the server/proxy to start.

For other recommended changes and new parameters, see the What's new section.

7 Start �����IJ� processes

Start the updated �����IJ� 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 �����IJ� web interface to work properly.

Upgrade between minor versions

It is possible to upgrade minor versions of 3.0.x (for example, from 3.0.1 to 3.0.3). It is easy.

To upgrade �����IJ� minor version please run:

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

To upgrade �����IJ� server minor version please run:

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

To upgrade �����IJ� agent minor version please run:

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