This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
manual:installation:install_from_packages:debian_ubuntu [2017/03/27 12:48] martins-v fixing typo |
manual:installation:install_from_packages:debian_ubuntu [2019/09/18 10:14] (current) martins-v fixing link target |
||
---|---|---|---|
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 7 (Wheezy) | + | * Debian 10 (Buster) |
+ | * Debian 9 (Stretch) | ||
* Debian 8 (Jessie) | * Debian 8 (Jessie) | ||
- | * Ubuntu 14.04 (Trusty Tahr) 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 | ||
+ | * Raspbian (Buster) | ||
+ | * Raspbian (Stretch) | ||
- | === Repository installation === | + | ==== 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 **8**, run: | + | For **Debian 10**, run the following commands: |
- | # wget http://repo.zabbix.com/zabbix/3.4/debian/pool/main/z/zabbix-release/zabbix-release_3.4-1+jessie_all.deb | + | **Note!** For Debian 9, substitute 'buster' with 'stretch' in the commands. For Debian 8, substitute 'buster' with 'jessie' in the commands. |
- | # dpkg -i zabbix-release_3.4-1+jessie_all.deb | + | |
- | # apt-get update | + | |
- | For Debian 7, substitute 'jessie' with 'wheezy' in the commands. | + | # wget https://repo.zabbix.com/zabbix/4.2/debian/pool/main/z/zabbix-release/zabbix-release_4.2-2+buster_all.deb |
+ | # dpkg -i zabbix-release_4.2-2+buster_all.deb | ||
+ | # apt update | ||
- | For Ubuntu **16.04**, run: | + | For **Ubuntu 18.04 (bionic)**, run the following commands: |
- | # wget http://repo.zabbix.com/zabbix/3.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_3.4-1+xenial_all.deb | + | # wget https://repo.zabbix.com/zabbix/4.2/ubuntu/pool/main/z/zabbix-release/zabbix-release_4.2-2+bionic_all.deb |
- | # dpkg -i zabbix-release_3.4-1+xenial_all.deb | + | # dpkg -i zabbix-release_4.2-2+bionic_all.deb |
- | # apt-get update | + | # apt update |
- | For Ubuntu 14.04, substitute 'xenial' with 'trusty' in the commands. | + | * For Ubuntu 16.04, substitute 'bionic' with 'xenial' in the commands. |
+ | * For Ubuntu 14.04, substitute 'bionic' with 'trusty' in the commands. | ||
- | === Server/proxy installation === | + | For **Raspbian**, run the following commands: |
- | To install server with MySQL: | + | # wget https://repo.zabbix.com/zabbix/4.2/raspbian/pool/main/z/zabbix-release/zabbix-release_4.2-2+buster_all.deb |
+ | # dpkg -i zabbix-release_4.2-2+buster_all.deb | ||
+ | # apt update | ||
- | # apt-get install zabbix-server-mysql zabbix-frontend-php | + | ==== Server/proxy/frontend installation ==== |
- | To install proxy with MySQL: | + | To install Zabbix server with MySQL support: |
- | # apt-get install zabbix-proxy-mysql | + | # apt install zabbix-server-mysql |
- | Substitute 'mysql' in the commands with 'pgsql' if using PostgreSQL, or with 'sqlite' if using SQLite3 (proxy only). | + | To install Zabbix proxy with MySQL support: |
- | ** Creating database ** | + | # apt install zabbix-proxy-mysql |
+ | |||
+ | To install Zabbix frontend: | ||
+ | |||
+ | # apt install zabbix-frontend-php | ||
+ | |||
+ | Substitute 'mysql' in the commands with 'pgsql' to use PostgreSQL, or with 'sqlite3' to use SQLite3 (proxy only). | ||
+ | |||
+ | === Creating database === | ||
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 [[:manual:appendix:install:db_scripts|database creation scripts]] for MySQL/PostgreSQL. | + | Create the database using the provided instructions for [[manual:appendix:install:db_scripts#mysql|MySQL]] or [[manual:appendix:install:db_scripts#postgresql|PostgreSQL]]. |
- | Now import initial schema and data for the server with MySQL: | + | === Importing data === |
+ | |||
+ | 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 58: | Line 75: | ||
With PostgreSQL: | With PostgreSQL: | ||
- | # zcat /usr/share/doc/zabbix-server-pgsql/create.sql.gz | psql -U <username> 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-proxy-mysql/create.sql.gz | mysql -uzabbix -p zabbix | + | # 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 | ||
For proxy with PostgreSQL (or SQLite): | For proxy with PostgreSQL (or SQLite): | ||
- | # zcat /usr/share/doc/zabbix-proxy-pgsql/create.sql.gz | psql -U <username> zabbix | + | # zcat /usr/share/doc/zabbix-proxy-pgsql/schema.sql.gz | sudo -u <username> psql zabbix |
- | # zcat /usr/share/doc/zabbix-proxy-sqlite/create.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.conf) to use their respective databases. For example: |
# vi /etc/zabbix/zabbix_server.conf | # vi /etc/zabbix/zabbix_server.conf | ||
Line 83: | Line 106: | ||
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. Refer to the [[:manual/installation/install_from_packages/rhel_centos#selinux_configuration|respective section]] for RHEL/CentOS 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. Refer to the [[:manual/installation/install_from_packages/rhel_centos#selinux_configuration|respective section]] for RHEL/CentOS for instructions. | ||
- | ** Starting Zabbix server process ** | + | === Starting Zabbix server process === |
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: | ||
Line 92: | Line 115: | ||
Substitute 'zabbix-server' with 'zabbix-proxy' to start Zabbix proxy process. | Substitute 'zabbix-server' with 'zabbix-proxy' to start Zabbix proxy process. | ||
- | ** PHP configuration for Zabbix frontend ** | + | === SELinux configuration === |
- | Apache configuration file for Zabbix frontend is located in /etc/httpd/conf.d/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. | + | Refer to the [[:manual/installation/install_from_packages/rhel_centos#selinux_configuration|respective section]] for RHEL/CentOS. |
+ | |||
+ | As frontend and SELinux configuration is done, you need to restart Apache web server: | ||
+ | |||
+ | # service apache2 restart | ||
+ | |||
+ | === 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. | ||
php_value max_execution_time 300 | php_value max_execution_time 300 | ||
Line 101: | Line 132: | ||
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 | ||
- | |||
- | == SELinux configuration == | ||
- | |||
- | Refer to the [[:manual/installation/install_from_packages/rhel_centos#selinux_configuration|respective section]] for RHEL/CentOS. | ||
- | |||
- | As frontend and SELinux configuration is done, you need to restart Apache web server: | ||
- | |||
- | # service apache2 restart | ||
- | |||
- | ** Installing frontend ** | ||
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 | ||
- | # apt-get install zabbix-agent | + | # apt install zabbix-agent |
To start the agent, run: | To start the agent, run: | ||
Line 126: | Line 149: | ||
# 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. |