Zabbix Documentation 3.4

Official Zabbix packages are available for:

• Debian 9 (Stretch)
• Debian 8 (Jessie)
• Debian 7 (Wheezy)
• Ubuntu 16.04 (Xenial Xerus) LTS
• Ubuntu 14.04 (Trusty Tahr) LTS

Install the repository configuration package. This package contains apt (software package manager) configuration files.

For Debian 9, run:

# wget http://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
# apt-get update

For Debian 8, substitute 'stretch' with 'jessie'. For Debian 7, substitute 'stretch' with 'wheezy' in the commands.

For Ubuntu 16.04, run:

# wget http://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
# apt-get update

For Ubuntu 14.04, substitute 'xenial' with 'trusty' in the commands.

To install Zabbix server with MySQL support:

# apt-get install zabbix-server-mysql

To install Zabbix proxy with MySQL support:

# apt-get install zabbix-proxy-mysql

To install Zabbix frontend:

# apt-get install zabbix-frontend-php

Substitute 'mysql' in the commands with 'pgsql' to use PostgreSQL, or with 'sqlite3' to use SQLite3 (proxy only).

For Zabbix server and proxy daemons a database is required. It is not needed to run Zabbix agent.

Create the database using the provided instructions for MySQL or PostgreSQL.

Now import initial schema and data for the server with MySQL:

# zcat /usr/share/doc/zabbix-server-mysql/create.sql.gz | mysql -uzabbix -p zabbix

You will be prompted to enter your newly created database password.

With PostgreSQL:

# zcat /usr/share/doc/zabbix-server-pgsql/create.sql.gz | sudo -u <username> psql zabbix

For proxy, import initial schema:

# zcat /usr/share/doc/zabbix-proxy-mysql/schema.sql.gz | mysql -uzabbix -p zabbix

For proxy with PostgreSQL (or SQLite):

# zcat /usr/share/doc/zabbix-proxy-pgsql/schema.sql.gz | sudo -u <username> psql zabbix
# zcat /usr/share/doc/zabbix-proxy-sqlite3/schema.sql.gz | sqlite3 zabbix.db

Configure database for Zabbix server/proxy

Edit zabbix_server.conf or zabbix_proxy.conf to use the created database. For example:

# vi /etc/zabbix/zabbix_server.conf
DBHost=localhost
DBName=zabbix
DBUser=zabbix
DBPassword=<password>

In DBPassword use Zabbix database password for MySQL; PosgreSQL user password for PosgreSQL.

Use DBHost= with PostgreSQL. You might want to keep the default setting DBHost=localhost (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. Refer to the respective section for RHEL/CentOS for instructions.

Starting Zabbix server process

It's time to start Zabbix server process and make it start at system boot:

# service zabbix-server start
# update-rc.d zabbix-server enable

Substitute 'zabbix-server' with 'zabbix-proxy' to start Zabbix proxy process.

PHP configuration for Zabbix frontend

Apache configuration file for Zabbix frontend is located in /etc/apache2/conf-enabled/zabbix.conf. Some PHP settings are already configured. But it's necessary to uncomment the “date.timezone” setting and set the right timezone for you.

php_value max_execution_time 300
php_value memory_limit 128M
php_value post_max_size 16M
php_value upload_max_filesize 2M
php_value max_input_time 300
php_value always_populate_raw_post_data -1
# php_value date.timezone Europe/Riga

Refer to the respective section for RHEL/CentOS.

As frontend and SELinux configuration is done, you need to restart Apache web server:

# service apache2 restart

Now you are ready to proceed with frontend installation steps which will allow you to access your newly installed Zabbix.

To install the agent, run

# apt-get install zabbix-agent

To start the agent, run:

# service zabbix-agent start