Zabbix Documentation 5.2

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


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
Next revision
Previous revision
Next revision Both sides next revision
manual:installation:install_from_packages:rhel_centos [2019/04/02 09:08]
sasha fixed 4.4 links
manual:installation:install_from_packages:rhel_centos [2020/05/26 11:58]
marinagen [ZBX-17640] Removed "agent 2 is only available on RHEL 8"
Line 3: Line 3:
 ==== Overview ==== ==== Overview ====
  
-Official Zabbix packages are available for RHEL 7, CentOS 7 and Oracle Linux 7. In this documentation we will refer to all 3 using the term ''​RHEL''​.+Official Zabbix packages are available for:
  
-Some agent and proxy packages are available for [[https://repo.zabbix.com/​zabbix/3.5/​rhel/​6/​x86_64/​|RHEL 6]] and [[https://repo.zabbix.com/​zabbix/3.5/​rhel/​5/​x86_64|RHEL 5]] as well.+|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]]  |
  
-==== Adding Zabbix repository ====+Packages are available with either MySQL/​PostgreSQL database and Apache/​Nginx webserver support.
  
-Install the repository configuration packageThis package contains yum (software package manager) configuration files.+<note important>​Zabbix 5.2 is not released yetThe download links lead to pre-5.2 packages.</​note>​
  
-RHEL 7:+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.
  
-  # rpm -ivh https://​repo.zabbix.com/​zabbix/4.4/​rhel/​7/​x86_64/​zabbix-release-4.4-1.el7.noarch.rpm+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.
  
-RHEL 6:+==== Notes on installation ====
  
-  # rpm -ivh https://repo.zabbix.com/​zabbix/4.4/​rhel/​6/​x86_64/​zabbix-release-4.4-1.el6.noarch.rpm+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:
  
-RHEL 5:+  * 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]].
  
-  ​rpm -ivh https://repo.zabbix.com/zabbix/​4.4/​rhel/​5/​x86_64/zabbix-release-4.4-1.noarch.rpm+=== 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 === === Frontend installation prerequisites ===
Line 31: Line 45:
   # yum-config-manager --enable rhel-7-server-optional-rpms   # yum-config-manager --enable rhel-7-server-optional-rpms
  
-==== Server/proxy/frontend installation ====+<​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>​
  
-To install Zabbix server (available for RHEL 7, [[manual/​installation/​install_from_packages/​rhel_centos#​zabbix_frontend_and_server_on_rhel_6|deprecated on RHEL 6]]) with MySQL support:+=== PHP 7.2 ===
  
-  # yum install zabbix-server-mysql+Zabbix frontend requires PHP version **7.2 or newer** starting with Zabbix 5.0. 
  
-To install Zabbix proxy with MySQL support:+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.
  
-  ​yum install zabbix-proxy-mysql+If you use RHEL 6 please read the section about [[manual/​installation/​install_from_packages/​rhel_centos#zabbix_frontend_and_server_on_rhel_6|using Zabbix frontend on RHEL 6]] on how to configure the frontend.
  
-To install Zabbix frontend (available for RHEL 7, [[manual/​installation/​install_from_packages/​rhel_centos#​zabbix_frontend_and_server_on_rhel_6|deprecated on RHEL 6]]) with MySQL support:+=== SELinux configuration ===
  
-  # yum install zabbix-web-mysql+Having SELinux status enabled in enforcing mode, you need to execute the following commands to enable communication between Zabbix frontend and server:
  
-Substitute ​'mysql' in the commands with '​pgsql'​ to use PostgreSQL, ​or with '​sqlite3' ​to use SQLite3 (proxy only).+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
  
-=== Creating database ===+RHEL prior to 7: 
 +  # setsebool -P httpd_can_network_connect on 
 +  # setsebool -P zabbix_can_network on
  
-For Zabbix [[manual:​concepts:​server|server]] ​and [[manual:​concepts:​proxy|proxy]] daemons a database ​is required. It is not needed to run Zabbix [[manual:​concepts:agent|agent]].+After the frontend ​and SELinux configuration ​is done, restart the Apache web server:
  
-<note warning>​Separate databases are needed for Zabbix server and Zabbix proxy; they cannot use the same database. Therefore, if they are installed on the same host, their databases must be created with different names!</​note>​+  # service httpd restart
  
-Create the database using the provided instructions for [[manual:​appendix:​install:​db_scripts#​mysql|MySQL]] or [[manual:​appendix:​install:​db_scripts#​postgresql|PostgreSQL]].+==== Proxy installation ====
  
-=== Importing data ===+Once the required repository is added, you can install Zabbix proxy by running:
  
-Now import initial schema and data for the **server** with MySQL:+  # yum install zabbix-proxy-mysql
  
-  # zcat /​usr/​share/​doc/​zabbix-server-mysql*/create.sql.gz | mysql -uzabbix -p zabbix+Substitute 'mysql' in the commands with '​pgsql'​ to use PostgreSQL, or with '​sqlite3'​ to use SQLite3 (proxy only).
  
-You will be prompted to enter your newly created ​database ​password.+== Creating ​database ​==
  
-With PostgreSQL:+[[:manual/​appendix/​install/​db_scripts|Create]] a separate database for Zabbix proxy.
  
-  # zcat /​usr/​share/​doc/​zabbix-server-pgsql*/​create.sql.gz | sudo -u <​username>​ psql zabbix+Zabbix ​server ​and Zabbix proxy cannot use the same databaseIf they are installed on the same host, the proxy database must have a different name.
  
-With TimescaleDB,​ in addition to the previous command, also run: +== Importing data ===
- +
-  # zcat /​usr/​share/​doc/​zabbix-server-pgsql*/​timescaledb.sql.gz | sudo -u <​username>​ psql zabbix +
- +
-<note warning>​TimescaleDB is supported with Zabbix server only.</​note>​+
  
-For **proxy**, import ​initial schema:+Import ​initial schema:
  
   # zcat /​usr/​share/​doc/​zabbix-proxy-mysql*/​schema.sql.gz | mysql -uzabbix -p zabbix   # zcat /​usr/​share/​doc/​zabbix-proxy-mysql*/​schema.sql.gz | mysql -uzabbix -p zabbix
Line 79: Line 94:
 For proxy with PostgreSQL (or SQLite): 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-pgsql*/​schema.sql.gz | sudo -u zabbix ​psql zabbix
   # zcat /​usr/​share/​doc/​zabbix-proxy-sqlite3*/​schema.sql.gz | sqlite3 zabbix.db   # zcat /​usr/​share/​doc/​zabbix-proxy-sqlite3*/​schema.sql.gz | sqlite3 zabbix.db
  
-=== Configure database for Zabbix ​server/proxy ===+== Configure database for Zabbix proxy ==
  
-Edit zabbix_server.conf (and zabbix_proxy.conf) to use their respective databases. For example:+Edit zabbix_proxy.conf:​
  
   # vi /​etc/​zabbix/​zabbix_server.conf   # vi /​etc/​zabbix/​zabbix_server.conf
Line 91: Line 106:
   DBUser=zabbix   DBUser=zabbix
   DBPassword=<​password>​   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. 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 **SELinux configuration** below for instructions.+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 ​server ​process ​===+== Starting Zabbix ​proxy process ==
  
-It's time to start Zabbix ​server ​process:+To start Zabbix ​proxy process ​and make it start at system boot:
  
-  # service zabbix-server ​start+  # service zabbix-proxy start 
 +  # systemctl enable zabbix-proxy
  
-and make it start at system boot:+== Frontend configuration ==
  
-RHEL 7 and later: +A Zabbix proxy does not have a frontend; it communicates with Zabbix ​server ​only.
-  # systemctl enable zabbix-server+
  
-RHEL prior to 7: +==== Java gateway installation ====
-  # chkconfig --level 12345 zabbix-server on+
  
-Substitute '​zabbix-server'​ with '​zabbix-proxy' ​if you are installing Zabbix proxy.+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.
  
-=== Zabbix ​frontend configuration ===+Once the required repository is added, you can install ​Zabbix ​Java gateway by running:
  
-For RHEL 7 and later the Apache configuration file for Zabbix frontend is located in /​etc/​httpd/​conf.d/​zabbix.conf.+  # yum install ​zabbix-java-gateway
  
-If you use RHEL 6 please read the section about [[manual/​installation/​install_from_packages/​rhel_centos#​zabbix_frontend_and_server_on_rhel_6|using Zabbix frontend on RHEL 6]] on how to configure the frontend. +Proceed ​to [[:manual/concepts/java/from_rhel_centos|setup]] for more details ​on configuring ​and running Java gateway.
- +
-Some PHP settings are already configured. But it's necessary to uncomment the "​date.timezone"​ setting and [[http://php.net/manual/​en/​timezones.php|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 max_input_vars 10000 +
-  php_value always_populate_raw_post_data -1 +
-  # php_value date.timezone Europe/​Riga +
- +
-Now you are ready to proceed with [[manual/​installation/​install#​installing_frontend|frontend installation steps]] which will allow you to access your newly installed Zabbix. +
- +
-Note that a Zabbix proxy does not have a frontend; it communicates with Zabbix server only. +
- +
-<​note>​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.</​note>​ +
- +
-=== 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 +
- +
-As frontend ​and SELinux configuration is done, you need to restart Apache web server:\\ +
- +
-  # service httpd restart+
  
 === Zabbix frontend and server on RHEL 6 === === Zabbix frontend and server on RHEL 6 ===
Line 174: Line 156:
   $ rpm -ql zabbix-web | grep example.conf   $ rpm -ql zabbix-web | grep example.conf
  
-==== Agent installation ​====+==== Installing debuginfo packages ​====
  
-To install the agentrun +<​note>​ Debuginfo packages are currently available for RHEL/CentOS versions 76 and 5. </​note>​ 
- +To enable debuginfo repository edit ///etc/yum.repos.d/​zabbix.repo//​ file. 
-  # yum install ​zabbix-agent +Change ''​enabled=0''​ to ''​enabled=1''​ for zabbix-debuginfo repository. 
- +  ​[zabbix-debuginfo] 
-To start the agent, run: +  name=Zabbix Official Repository debuginfo - $basearch 
- +  baseurl=http://repo.zabbix.com/​zabbix/​4.5/​rhel/​7/​$basearch/​debuginfo/​ 
-  ​# service ​zabbix-agent start +  ​enabled=0 
- +  ​gpgkey=file:///​etc/​pki/​rpm-gpg/​RPM-GPG-KEY-ZABBIX-A14FE591 
-==== Java gateway installation ==== +  ​gpgcheck=1 
- +This will allow you to install the zabbix-debuginfo package. 
-It is required to install [[:manual/concepts/java|Java gateway]] only if you want to monitor JMX applicationsJava gateway is lightweight and does not require a database+  # yum install zabbix-debuginfo 
- +This single packages contains debug information ​for all binary Zabbix componets.
-Once the required [[#​adding_zabbix_repository|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.+