This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | |||
manual:installation:install_from_packages:rhel_centos [2017/10/25 15:53] |
manual:installation:install_from_packages:rhel_centos [2021/01/27 21:18] (current) |
||
---|---|---|---|
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.4&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql|Download]] | | ||
+ | |||
+ | Packages are available with either MySQL/PostgreSQL database and Apache/Nginx webserver support. | ||
+ | |||
+ | <note important>Zabbix 5.4 is not released yet. The download links lead to pre-5.4 packages.</note> | ||
+ | |||
+ | //Zabbix agent// packages and utilities //Zabbix get// and //Zabbix sender// are available for [[https://repo.zabbix.com/zabbix/5.4/rhel/7/x86_64/|RHEL 7]], [[https://repo.zabbix.com/zabbix/5.4/rhel/6/x86_64/|RHEL 6]] and [[https://repo.zabbix.com/zabbix/5.4/rhel/5/x86_64|RHEL 5]] as well. | ||
+ | |||
+ | Zabbix official repository provides fping and 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> | ||
+ | |||
+ | |||
+ | === PHP 7.2 === | ||
+ | |||
+ | Zabbix frontend requires PHP version **7.2 or newer**. | ||
+ | |||
+ | === 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: | ||
+ | |||
+ | # dnf 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: | ||
+ | |||
+ | # dnf 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.4/rhel/8/$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. |