Zabbix Documentation 4.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: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
manual:installation:install_from_packages:rhel_centos [2018/10/02 05:50]
martins-v 3.5 -> 4.0
manual:installation:install_from_packages:rhel_centos [2020/01/29 14:43] (current)
martins-v explicitly stating zabbix user in commands
Line 5: Line 5:
 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 RHEL 7, CentOS 7 and Oracle Linux 7. In this documentation we will refer to all 3 using the term ''​RHEL''​.
  
-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.+Some agent and proxy packages are available for [[https://​repo.zabbix.com/​zabbix/​4.0/​rhel/​6/​x86_64/​|RHEL 6]] and [[https://​repo.zabbix.com/​zabbix/​4.0/​rhel/​5/​x86_64|RHEL 5]] as well.
  
 ==== Adding Zabbix repository ==== ==== Adding Zabbix repository ====
Line 13: Line 13:
 RHEL 7: RHEL 7:
  
-  # rpm -ivh https://​repo.zabbix.com/​zabbix/​4.0/​rhel/​7/​x86_64/​zabbix-release-3.5-1.el7.noarch.rpm+  # rpm -Uvh https://​repo.zabbix.com/​zabbix/​4.0/​rhel/​7/​x86_64/​zabbix-release-4.0-1.el7.noarch.rpm
  
 RHEL 6: RHEL 6:
  
-  # rpm -ivh https://​repo.zabbix.com/​zabbix/​4.0/​rhel/​6/​x86_64/​zabbix-release-3.5-1.el6.noarch.rpm+  # rpm -Uvh https://​repo.zabbix.com/​zabbix/​4.0/​rhel/​6/​x86_64/​zabbix-release-4.0-1.el6.noarch.rpm
  
 RHEL 5: RHEL 5:
  
-  # rpm -ivh https://​repo.zabbix.com/​zabbix/​4.0/​rhel/​5/​x86_64/​zabbix-release-3.5-1.noarch.rpm+  # rpm -Uvh https://​repo.zabbix.com/​zabbix/​4.0/​rhel/​5/​x86_64/​zabbix-release-4.0-1.noarch.rpm
  
 === Frontend installation prerequisites === === Frontend installation prerequisites ===
Line 51: Line 51:
 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]]. ​ 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]]. ​
  
-<note warning>If Zabbix server and proxy are installed on the same host, their databases must be created with different names!</​note>​+<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>​
  
 Create the database using the provided instructions for [[manual:​appendix:​install:​db_scripts#​mysql|MySQL]] or [[manual:​appendix:​install:​db_scripts#​postgresql|PostgreSQL]]. Create the database using the provided instructions for [[manual:​appendix:​install:​db_scripts#​mysql|MySQL]] or [[manual:​appendix:​install:​db_scripts#​postgresql|PostgreSQL]].
Line 65: Line 65:
 With PostgreSQL: With PostgreSQL:
  
-  # zcat /​usr/​share/​doc/​zabbix-server-pgsql*/​create.sql.gz | sudo -u <​username> ​psql zabbix+  # zcat /​usr/​share/​doc/​zabbix-server-pgsql*/​create.sql.gz | sudo -u zabbix ​psql zabbix
  
 For proxy, import initial schema: For proxy, import initial schema:
Line 73: Line 73:
 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 server/​proxy ===
  
-Edit zabbix_server.conf ​or zabbix_proxy.conf to use the created database. For example:+Edit zabbix_server.conf ​(and zabbix_proxy.confto use their respective databases. For example:
  
   # vi /​etc/​zabbix/​zabbix_server.conf   # vi /​etc/​zabbix/​zabbix_server.conf
Line 124: Line 124:
  
 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. 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>​ <​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>​
Line 176: Line 178:
   # service zabbix-agent start   # service zabbix-agent start
  
 +If you want to run Zabbix agent as root, see [[manual/​appendix/​install/​run_agent_as_root|here]].
 ==== Java gateway installation ==== ==== Java gateway installation ====
  
-It is required to install [[:​manual/​concepts/​java|Java gateway]] if you want to monitor JMX applications. Java gateway is lightweight and does not require a database.+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 [[#​adding_zabbix_repository|repository]] is added, you can install Zabbix Java gateway by running: Once the required [[#​adding_zabbix_repository|repository]] is added, you can install Zabbix Java gateway by running:
Line 184: Line 187:
   # yum install zabbix-java-gateway   # yum install zabbix-java-gateway
  
-Configuration parameters of Zabbix Java gateway may be tuned in the file: +Proceed to [[:​manual/​concepts/​java/​from_rhel_centos|setup]] for more details ​on configuring ​and running ​Java gateway.
- +
-  /​etc/​zabbix/​zabbix_java_gateway.conf +
- +
-For more details, see Zabbix Java gateway configuration [[:​manual:​appendix:​config:​zabbix_java|parameters]]. +
- +
-To start Zabbix Java gateway: +
- +
-  # service zabbix-java-gateway restart +
- +
-<note important>​Note that Zabbix server ​[[:​manual/​concepts/​java#​configuring_server_for_use_with_java_gateway|must be configured]] to work with Java gateway.</​note>​ +
- +
-To automatically start Zabbix Java gateway ​on boot: +
- +
-RHEL 7 and later: +
-  # systemctl enable zabbix-java-gateway +
- +
-RHEL prior to 7: +
-  # chkconfig --level 12345 zabbix-java-gateway on +
- +
-Zabbix ​Java gateway ​log file is: +
- +
-  /​var/​log/​zabbix/​zabbix_java_gateway.log +
- +
-If you like to increase the logging, edit the file: +
- +
-  /​etc/​zabbix/​zabbix_java_gateway_logback.xml +
- +
-and change ''​level=%%"​%%info%%"​%%''​ to %%"​%%debug%%"​%% or even %%"​%%trace%%"​%% (for deep troubleshooting):​+
  
-  <​configuration scan="​true"​ scanPeriod="15 seconds">​ +==== Installing debuginfo packages ====
-  [...] +
-        <root level="​info">​ +
-                <​appender-ref ref="​FILE"​ /> +
-        </​root>​ +
-   +
-  </​configuration>​+
  
 +<​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/​4.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.