manual:installation:install_from_packages:rhel_centos

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Previous revision
Last revision Both sides next revision
manual:installation:install_from_packages:rhel_centos [2017/10/24 15:28]
manual:installation:install_from_packages:rhel_centos [2020/07/10 08:26]
marinagen removing mention of frontend on RHEL 6 (no longer supported)
Line 1: Line 1:
 +==== 1 Red Hat Enterprise Linux/​CentOS ====
  
 +==== Overview ====
 +
 +Official Zabbix packages are available for:
 +
 +|RHEL 8, CentOS 8 and Oracle Linux 8  |[[https://​www.zabbix.com/​download?​zabbix=5.0&​os_distribution=red_hat_enterprise_linux&​os_version=8&​db=mysql|Download]] ​ |
 +|RHEL 7, CentOS 7 and Oracle Linux 7  |[[https://​www.zabbix.com/​download?​zabbix=5.0&​os_distribution=red_hat_enterprise_linux&​os_version=7&​db=mysql|Download]] ​ |
 +
 +Packages are available with either MySQL/​PostgreSQL database and Apache/​Nginx webserver support.
 +
 +Some agent and proxy packages are available for [[https://​repo.zabbix.com/​zabbix/​5.0/​rhel/​6/​x86_64/​|RHEL 6]] and [[https://​repo.zabbix.com/​zabbix/​5.0/​rhel/​5/​x86_64|RHEL 5]] as well.
 +
 +Zabbix official repository provides fping, iksemel, libssh2 packages as well. These packages are located in the [[https://​repo.zabbix.com/​non-supported/​|non-supported]] directory.
 +
 +==== Notes on installation ====
 +
 +See [[https://​www.zabbix.com/​download?​zabbix=5.0&​os_distribution=red_hat_enterprise_linux&​os_version=8&​db=mysql|installation instructions]] per platform in the download page for:
 +
 +  * installing the repository
 +  * installing server/​agent/​frontend
 +  * creating initial database, importing initial data
 +  * configuring database for Zabbix server
 +  * configuring PHP for Zabbix frontend
 +  * starting server/​agent processes
 +  * configuring Zabbix frontend
 +If you want to run Zabbix agent as root, see [[https://​www.zabbix.com/​documentation/​5.0/​manual/​appendix/​install/​run_agent_as_root|Running agent as root]].
 +
 +=== Importing data with Timescale DB ===
 +
 +With TimescaleDB,​ in addition to the import command for PostgreSQL, also run:
 +
 +  # zcat /​usr/​share/​doc/​zabbix-server-pgsql*/​timescaledb.sql.gz | sudo -u zabbix psql zabbix
 +
 +<note warning>​TimescaleDB is supported with Zabbix server only.</​note>​
 +
 +=== Frontend installation prerequisites ===
 +
 +Zabbix frontend requires additional packages not available in basic installation. You need to enable repository of optional rpms in the system you will run Zabbix frontend on:
 +
 +RHEL 7:
 +
 +  # yum-config-manager --enable rhel-7-server-optional-rpms
 +
 +<​note>​ Note that Nginx for RHEL is available in Red Hat Software Collections and in [[https://​fedoraproject.org/​wiki/​EPEL|EPEL]]. If Red Hat Software Collections are used, simply install zabbix-nginx-conf-scl package. </​note>​
 +
 +=== PHP 7.2 ===
 +
 +Zabbix frontend requires PHP version **7.2 or newer** starting with Zabbix 5.0. 
 +
 +Note that RHEL/CentOS 7 only provide PHP 5.4. See [[:​manual/​installation/​install_from_packages/​frontend_on_rhel7|instructions]] for installing Zabbix frontend on Red Hat Enterprise Linux/​CentOS 7.
 +
 +=== SELinux configuration ===
 +
 +Having SELinux status enabled in enforcing mode, you need to execute the following commands to enable communication between Zabbix frontend and server:
 +
 +RHEL 7 and later:
 +  # setsebool -P httpd_can_connect_zabbix on
 +
 +If the database is accessible over network (including '​localhost'​ in case of PostgreSQL),​ you need to allow Zabbix frontend to connect to the database too:
 +  # setsebool -P httpd_can_network_connect_db on
 +
 +RHEL prior to 7:
 +  # setsebool -P httpd_can_network_connect on
 +  # setsebool -P zabbix_can_network on
 +
 +After the frontend and SELinux configuration is done, restart the Apache web server:
 +
 +  # service httpd restart
 +
 +==== Proxy installation ====
 +
 +Once the required repository is added, you can install Zabbix proxy by running:
 +
 +  # yum install zabbix-proxy-mysql
 +
 +Substitute '​mysql'​ in the commands with '​pgsql'​ to use PostgreSQL, or with '​sqlite3'​ to use SQLite3 (proxy only).
 +
 +== Creating database ==
 +
 +[[:​manual/​appendix/​install/​db_scripts|Create]] a separate database for Zabbix proxy.
 +
 +Zabbix server and Zabbix proxy cannot use the same database. If they are installed on the same host, the proxy database must have a different name.
 +
 +== Importing data ===
 +
 +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 zabbix psql zabbix
 +  # zcat /​usr/​share/​doc/​zabbix-proxy-sqlite3*/​schema.sql.gz | sqlite3 zabbix.db
 +
 +== Configure database for Zabbix proxy ==
 +
 +Edit zabbix_proxy.conf:​
 +
 +  # vi /​etc/​zabbix/​zabbix_server.conf
 +  DBHost=localhost
 +  DBName=zabbix
 +  DBUser=zabbix
 +  DBPassword=<​password>​
 +
 +In DBName for Zabbix proxy use a separate database from Zabbix server.
 +
 +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. See [[:​manual/​installation/​install_from_packages/​rhel_centos#​selinux_configuration|SELinux configuration]] for instructions.
 +
 +== Starting Zabbix proxy process ==
 +
 +To start a Zabbix proxy process and make it start at system boot:
 +
 +  # service zabbix-proxy start
 +  # systemctl enable zabbix-proxy
 +
 +== Frontend configuration ==
 +
 +A Zabbix proxy does not have a frontend; it communicates with Zabbix server only.
 +
 +==== Java gateway installation ====
 +
 +It is required to install [[:​manual/​concepts/​java|Java gateway]] only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database.
 +
 +Once the required repository is added, you can install Zabbix Java gateway by running:
 +
 +  # yum install zabbix-java-gateway
 +
 +Proceed to [[:​manual/​concepts/​java/​from_rhel_centos|setup]] for more details on configuring and running Java gateway.
 +
 +==== Installing debuginfo packages ====
 +
 +<​note>​ Debuginfo packages are currently available for RHEL/CentOS versions 7, 6 and 5. </​note>​
 +To enable debuginfo repository edit ///​etc/​yum.repos.d/​zabbix.repo//​ file.
 +Change ''​enabled=0''​ to ''​enabled=1''​ for zabbix-debuginfo repository.
 +  [zabbix-debuginfo]
 +  name=Zabbix Official Repository debuginfo - $basearch
 +  baseurl=http://​repo.zabbix.com/​zabbix/​5.0/​rhel/​7/​$basearch/​debuginfo/​
 +  enabled=0
 +  gpgkey=file:///​etc/​pki/​rpm-gpg/​RPM-GPG-KEY-ZABBIX-A14FE591
 +  gpgcheck=1
 +This will allow you to install the zabbix-debuginfo package.
 +  # yum install zabbix-debuginfo
 +This single packages contains debug information for all binary Zabbix componets.