6 Upgrade procedure

Overview

This section provides the steps required for a successful upgrade from Zabbix 1.8.x to 2.0.

Database upgrade to version 2.0 may take a long time, as all the historical data tables have to be upgraded.

1 Stop Zabbix server

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

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

Make a backup copy of Zabbix binaries, configuration files and PHP files.

4 Install new server binaries

You may use pre-compiled binaries or compile your own.

5 Review server configuration parameters

Some parameters of zabbix_server.conf might have changed from 1.8, new parameters added. You may want to review them.

6 Upgrade the database

Before you upgrade:

• Make sure the database user has enough permissions (create table, drop table, create index, drop index)
• Make sure you have enough free disk space.

Database upgrade scripts are located in the upgrades/dbpatches/2.0/<db engine> directory. Run the scripts:

• MySQL: upgrades/dbpatches/2.0/mysql/patch.sql
• PostgreSQL: upgrades/dbpatches/2.0/postgresql/patch.sql
• Oracle: upgrades/dbpatches/2.0/oracle/patch.sql
• IBM DB2: upgrades/dbpatches/2.0/ibm_db2/patch.sql

These scripts are only for upgrading Zabbix 1.8.x to 2.0! For upgrading from earlier versions first use upgrade scripts from Zabbix 1.6.x or Zabbix 1.8.x.

7 Install new Zabbix web interface

Follow installation instructions.

8 Start new Zabbix binaries

Start new binaries. Check log files to see if the binaries have started successfully.