Zabbix Documentation 4.4

3.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.22.43.23.4

User Tools

Site Tools


manual:installation:install_from_packages:debian_ubuntu

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:debian_ubuntu [2018/07/13 06:00]
martins-v http -> https
manual:installation:install_from_packages:debian_ubuntu [2019/09/13 06:15] (current)
yuriii [Frontend configuration]
Line 1: Line 1:
-==== 2 Debian/​Ubuntu ====+==== 2 Debian/​Ubuntu/​Raspbian ​====
  
-=== Overview ===+==== Overview ​====
  
 Official Zabbix packages are available for:  Official Zabbix packages are available for: 
  
 +  * Debian 10 (Buster)
   * Debian 9 (Stretch)   * Debian 9 (Stretch)
   * Debian 8 (Jessie)   * Debian 8 (Jessie)
-  * Debian 7 (Wheezy) ​ 
   * Ubuntu 18.04 (Bionic Beaver) LTS   * Ubuntu 18.04 (Bionic Beaver) LTS
   * Ubuntu 16.04 (Xenial Xerus) LTS   * Ubuntu 16.04 (Xenial Xerus) LTS
   * Ubuntu 14.04 (Trusty Tahr) LTS   * Ubuntu 14.04 (Trusty Tahr) LTS
 +  * Raspbian (Buster)
 +  * Raspbian (Stretch)
  
-=== Adding Zabbix repository ===+==== Adding Zabbix repository ​====
  
 Install the repository configuration package. This package contains apt (software package manager) configuration files. ​ Install the repository configuration package. This package contains apt (software package manager) configuration files. ​
  
-For **Debian ​9**, run the following commands:+For **Debian ​10**, run the following commands:
  
-**Note!** For Debian ​8, substitute 'stretch' with 'jessie' in the commands. For Debian ​7, substitute 'stretch' with 'wheezy' in the commands.+**Note!** For Debian ​9, substitute 'buster' with 'stretch' in the commands. For Debian ​8, substitute 'buster' with 'jessie' in the commands.
  
-  # wget https://​repo.zabbix.com/​zabbix/​3.5/​debian/​pool/​main/​z/​zabbix-release/​zabbix-release_3.5-1+stretch_all.deb +  # wget https://​repo.zabbix.com/​zabbix/​4.4/​debian/​pool/​main/​z/​zabbix-release/​zabbix-release_4.4-1+buster_all.deb 
-  # dpkg -i zabbix-release_3.5-1+stretch_all.deb+  # dpkg -i zabbix-release_4.4-1+buster_all.deb
   # apt update   # apt update
  
 For **Ubuntu 18.04 (bionic)**, run the following commands: For **Ubuntu 18.04 (bionic)**, run the following commands:
  
-  # wget https://​repo.zabbix.com/​zabbix/​3.5/​ubuntu/​pool/​main/​z/​zabbix-release/​zabbix-release_3.5-1+bionic_all.deb +  # wget https://​repo.zabbix.com/​zabbix/​4.4/​ubuntu/​pool/​main/​z/​zabbix-release/​zabbix-release_4.4-1+bionic_all.deb 
-  # dpkg -i zabbix-release_3.5-1+bionic_all.deb+  # dpkg -i zabbix-release_4.4-1+bionic_all.deb
   # apt update   # apt update
  
Line 33: Line 35:
   * For Ubuntu 14.04, substitute '​bionic'​ with '​trusty'​ in the commands.   * For Ubuntu 14.04, substitute '​bionic'​ with '​trusty'​ in the commands.
  
-=== Server/​proxy/​frontend installation ===+For **Raspbian**,​ run the following commands: 
 + 
 +  # wget https://​repo.zabbix.com/​zabbix/​4.4/​raspbian/​pool/​main/​z/​zabbix-release/​zabbix-release_4.4-1+buster_all.deb 
 +  # dpkg -i zabbix-release_4.4-1+buster_all.deb 
 +  # apt update 
 +==== Server/​proxy/​frontend installation ​====
  
 To install Zabbix server with MySQL support: To install Zabbix server with MySQL support:
Line 42: Line 49:
  
   # apt install zabbix-proxy-mysql   # apt install zabbix-proxy-mysql
 +
 +Substitute '​mysql'​ in the commands with '​pgsql'​ to use PostgreSQL, or with '​sqlite3'​ to use SQLite3 (proxy only).
  
 To install Zabbix frontend: To install Zabbix frontend:
  
-  # apt install zabbix-frontend-php+  # apt install zabbix-frontend-php ​zabbix-apache-conf
  
-Substitute 'mysql' in the commands ​with 'pgsql' ​to use PostgreSQL, or with '​sqlite3'​ to use SQLite3 (proxy only).+Substitute 'apache' in the command ​with 'nginx' ​if using the Nginx web server.
  
 === Creating database === === Creating database ===
Line 53: Line 62:
 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 59: Line 68:
 === Importing data === === Importing data ===
  
-Now import initial schema and data for the server with MySQL:+Now import initial schema and data for the **server** with MySQL:
  
   # zcat /​usr/​share/​doc/​zabbix-server-mysql/​create.sql.gz | mysql -uzabbix -p zabbix   # zcat /​usr/​share/​doc/​zabbix-server-mysql/​create.sql.gz | mysql -uzabbix -p zabbix
Line 69: Line 78:
   # 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 <​username>​ psql zabbix
  
-For proxy, import initial schema:+With TimescaleDB,​ in addition to the previous command, also run: 
 + 
 +  # 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:
  
   # 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 80: Line 95:
 === 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 96: Line 111:
 It's time to start Zabbix server process and make it start at system boot: It's time to start Zabbix server process and make it start at system boot:
  
-  # service zabbix-server start +  # service zabbix-server ​apache2 php-fpm ​start 
-  # update-rc.d zabbix-server enable+  # update-rc.d zabbix-server ​apache2 php-fpm ​enable
  
-Substitute '​zabbix-server'​ with '​zabbix-proxy'​ to start Zabbix proxy process.+Substitute '​zabbix-server'​ with '​zabbix-proxy'​ to start Zabbix proxy process. Substitute '​apache2'​ with '​nginx'​ for Nginx web server.
  
 === SELinux configuration === === SELinux configuration ===
Line 111: Line 126:
 === Frontend configuration === === Frontend configuration ===
  
-Apache configuration file for Zabbix frontend is located in /etc/​apache2/​conf-enabled/​zabbix.conf. 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.+Depending on the web server used (Apache/Nginx) edit the corresponding ​configuration file for Zabbix frontend
 + 
 +  * For Apache the configuration file is located in ''​/etc/zabbix/apache.conf''​. 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 max_execution_time 300
Line 118: Line 135:
   php_value upload_max_filesize 2M   php_value upload_max_filesize 2M
   php_value max_input_time 300   php_value max_input_time 300
 +  php_value max_input_vars 10000
   php_value always_populate_raw_post_data -1   php_value always_populate_raw_post_data -1
   # php_value date.timezone Europe/Riga   # php_value date.timezone Europe/Riga
 +
 +  * The zabbix-nginx-conf package installs a separate Nginx server for Zabbix frontend. Its configuration file is located in ''/​etc/​zabbix/​nginx.conf''​. For Zabbix frontend to work, it's necessary to uncomment and set ''​listen''​ and/or ''​server_name''​ directives.
 +
 +  # listen 80;
 +  # server_name example.com;​
 +
 +  * Zabbix uses its own dedicated php-fpm connection pool with Nginx:
 +
 +Its configuration file is located in ''/​etc/​zabbix/​php-fpm.conf''​. Some PHP settings are already configured. But it's necessary to set the right [[http://​php.net/​manual/​en/​timezones.php|date.timezone]] setting 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[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. 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.
  
-=== Agent installation ===+Note that a Zabbix proxy does not have a frontend; it communicates with Zabbix server only. 
 +==== Agent installation ​====
  
 To install the agent, run To install the agent, run
Line 133: Line 169:
   # service zabbix-agent start   # service zabbix-agent start
  
 +==== 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 [[#​adding_zabbix_repository|repository]] is added, you can install Zabbix Java gateway by running:
 +
 +  # apt install zabbix-java-gateway
 +
 +Proceed to [[:​manual/​concepts/​java/​from_debian_ubuntu|setup]] for more details on configuring and running Java gateway.