Zabbix Documentation 2.0

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


manual:installation:install_from_packages

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

manual:installation:install_from_packages [2017/03/27 11:21]
manual:installation:install_from_packages [2014/09/26 11:32] (current)
sasha Links adapted because of a move operation
Line 1: Line 1:
 +==== 3 Installation from packages ====
  
 +=== Overview ===
 +
 +Zabbix SIA provides official RPM and DEB packages for Red Hat Enterprise Linux, Debian and Ubuntu LTS. 
 +
 +Package files are available at //​repo.zabbix.com//​. yum and apt repositories are also available on the server. A step-by-step tutorial for installing Zabbix from packages is provided here.
 +
 +==== Red Hat Enterprise Linux / CentOS ====
 +
 +Supported for versions: RHEL5 and RHEL6
 +
 +=== Installing repository configuration package ===
 +
 +Install the repository configuration package. This package contains yum configuration files.
 +
 +Zabbix 2.0 for RHEL5:
 +
 +  # rpm -ivh http://​repo.zabbix.com/​zabbix/​2.0/​rhel/​5/​x86_64/​zabbix-release-2.0-1.el5.noarch.rpm
 +
 +Zabbix 2.0 for RHEL6:
 +
 +  # rpm -ivh http://​repo.zabbix.com/​zabbix/​2.0/​rhel/​6/​x86_64/​zabbix-release-2.0-1.el6.noarch.rpm
 +
 +=== Installing Zabbix packages ===
 +
 +Install Zabbix packages. Example for Zabbix server and web frontend with mysql database.
 +
 +<​note>​Zabbix official repository provides fping, iksemel, libssh2 packages as well. These packages are located in the //​non-supported//​ directory.</​note>​
 +
 +  # yum install zabbix-server-mysql zabbix-web-mysql
 +
 +Example for installing Zabbix agent only.
 +
 +  # yum install zabbix-agent
 +
 +=== Creating initial database ===
 +
 +Create zabbix database and user on MySQL.
 +
 +  # mysql -uroot
 +  mysql> create database zabbix character set utf8 collate utf8_bin;
 +  mysql> grant all privileges on zabbix.* to [email protected] identified by '​zabbix';​
 +  mysql> exit
 +
 +Import initial schema and data.
 +
 +  # cd /​usr/​share/​doc/​zabbix-server-mysql-2.0.4/​create
 +  # mysql -uroot zabbix < schema.sql
 +  # mysql -uroot zabbix < images.sql
 +  # mysql -uroot zabbix < data.sql
 +
 +=== Starting Zabbix server process ===
 +
 +Edit database configuration in zabbix_server.conf
 +
 +  # vi /​etc/​zabbix/​zabbix_server.conf
 +  DBHost=localhost
 +  DBName=zabbix
 +  DBUser=zabbix
 +  DBPassword=zabbix
 +
 +Start Zabbix server process.
 +
 +  # service zabbix-server start
 +
 +=== Editing PHP configuration for Zabbix frontend ===
 +
 +Apache configuration file for Zabbix frontend is located in /​etc/​httpd/​conf.d/​zabbix.conf. Some PHP settings are already configured.
 +
 +  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 date.timezone Europe/Riga
 +
 +It's necessary to uncomment the "​date.timezone"​ setting and set the right timezone for you. After changing the configuration file restart the apache web server.
 +
 +  # service httpd restart
 +
 +Zabbix frontend is available at http://​zabbix-frontend-hostname/​zabbix in the browser. Default username/​password is Admin/​zabbix.
 +
 +
 +==== Debian / Ubuntu ====
 +
 +Supported for version: Debian 6 (Squeeze), Debian 7 (Wheezy), Ubuntu 10.04 LTS (Lucid Lynx), Ubuntu 12.04 LTS (Precise Pangolin)
 +
 +=== Installing repository configuration package ===
 +
 +Install the repository configuration package. This package contains apt configuration files.
 +
 +Zabbix 2.0 for Debian 6:
 +
 +  # wget http://​repo.zabbix.com/​zabbix/​2.0/​debian/​pool/​main/​z/​zabbix-release/​zabbix-release_2.0-1squeeze_all.deb
 +  # dpkg -i zabbix-release_2.0-1squeeze_all.deb
 +  # apt-get update
 +
 +Zabbix 2.0 for Debian 7:
 +
 +  # wget http://​repo.zabbix.com/​zabbix/​2.0/​debian/​pool/​main/​z/​zabbix-release/​zabbix-release_2.0-1wheezy_all.deb
 +  # dpkg -i zabbix-release_2.0-1wheezy_all.deb
 +  # apt-get update
 +
 +Zabbix 2.0 for Ubuntu 10.04 LTS:
 +
 +  # wget http://​repo.zabbix.com/​zabbix/​2.0/​ubuntu/​pool/​main/​z/​zabbix-release/​zabbix-release_2.0-1lucid_all.deb
 +  # dpkg -i zabbix-release_2.0-1lucid_all.deb
 +  # apt-get update
 +
 +Zabbix 2.0 for Ubuntu 12.04 LTS:
 +
 +  # wget http://​repo.zabbix.com/​zabbix/​2.0/​ubuntu/​pool/​main/​z/​zabbix-release/​zabbix-release_2.0-1precise_all.deb
 +  # dpkg -i zabbix-release_2.0-1precise_all.deb
 +  # apt-get update
 +
 +=== Installing and configuring MySQL database ===
 +
 +<​note>​This step is for Debian 6 and Ubuntu 10.04 with MySQL database only.</​note>​
 +
 +dbconfig-common on Debian 6 and Ubuntu 10.04 cannot create database with utf-8 encoding. It is necessary to install mysql-server package and configure mysql configuration to use utf-8 in advance.
 +
 +For Debian 7 and Ubuntu, this step is not necessary.
 +
 +Install MySQL server package:
 +
 +  # apt-get install mysql-server
 +
 +Set character encoding parameter in /​etc/​mysql/​my.cnf
 +
 +  [mysqld]
 +  default-character-set=utf8
 +  ​
 +<​note>​The encoding setting above is for MySQL 5.1. If you use MySQL 5.5 or later, please use "​character-set-server=utf-8"​ instead.</​note>​
 +
 +Then start mysqld
 +
 +  # service mysql start
 +
 +=== Installing Zabbix packages ===
 +
 +Install Zabbix packages. dbconfig-common will create the database and populate the initial schema and data automatically. If backend db is located on a different server, please set dbc_remote_questions_default='​true'​ in /​etc/​dbconfig-common/​config.
 +
 +Example for Zabbix server and web frontend with mysql database.
 +
 +  # apt-get install zabbix-server-mysql zabbix-frontend-php
 +
 +<note tip>The zabbix-frontend-php package, during installation,​ will configure a font, which is used on generated images. If you updated the package from any other repository and text is empty on graphs or maps, please check if a "​ttf-dejavu-core"​ package is installed and try to execute "​dpkg-reconfigure zabbix-frontend-php"​ command.</​note>​
 +
 +Example for installing Zabbix agent only.
 +
 +  # apt-get install zabbix-agent
 +
 +=== Editing PHP configuration for Zabbix frontend ===
 +
 +Apache configuration file for Zabbix frontend is located in /​etc/​apache2/​conf.d/​zabbix. Some PHP settings are already configured.
 +
 +  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 date.timezone Europe/Riga
 +
 +It's necessary to uncomment the "​date.timezone"​ setting and set the correct timezone for you. After changing the configuration file restart the apache web server.
 +
 +  # service apache2 restart
 +
 +Zabbix frontend is available at http://​zabbix-frontend-hostname/​zabbix in the browser. Default username/​password is Admin/​zabbix.
 +
 +==== Troubleshooting ====
 +
 +See the section on [[manual:​appendix:​install:​troubleshooting|installation-specific issue troubleshooting]].