manual:installation:install

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
Last revision Both sides next revision
manual:installation:install [2014/09/25 14:42]
sasha Page moved from 2.4:manual:installation:install to manual:installation:install
manual:installation:install [2016/10/14 09:54]
martins-v adding optional path to mysql_conf file
Line 11: Line 11:
 Go to the [[http://​www.zabbix.com/​download.php|Zabbix download page]] and download the source archive. Once downloaded, extract the sources, by running: Go to the [[http://​www.zabbix.com/​download.php|Zabbix download page]] and download the source archive. Once downloaded, extract the sources, by running:
  
-  $ tar -zxvf zabbix-2.2.0.tar.gz+  $ tar -zxvf zabbix-2.4.0.tar.gz
    
 <note tip>​Enter the correct Zabbix version in the command. It must match the name of the downloaded archive.</​note>​ <note tip>​Enter the correct Zabbix version in the command. It must match the name of the downloaded archive.</​note>​
Line 26: Line 26:
 A separate user account is not required for Zabbix frontend installation. A separate user account is not required for Zabbix frontend installation.
  
-If Zabbix [[:2.4/manual/concepts/server|server]] and [[:2.4/manual/concepts/agent|agent]] are run on the same machine it is recommended to use a different user for running the server than for running the agent. Otherwise, if both are run as the same user, the agent can access the server configuration file and any Admin level user in Zabbix can quite easily retrieve, for example, the database password.+If Zabbix [[manual:concepts:server|server]] and [[manual:concepts:agent|agent]] are run on the same machine it is recommended to use a different user for running the server than for running the agent. Otherwise, if both are run as the same user, the agent can access the server configuration file and any Admin level user in Zabbix can quite easily retrieve, for example, the database password.
  
 <note important>​Running Zabbix as ''​root'',​ ''​bin'',​ or any other account with special rights is a security risk.</​note>​ <note important>​Running Zabbix as ''​root'',​ ''​bin'',​ or any other account with special rights is a security risk.</​note>​
Line 32: Line 32:
 == 3 Create Zabbix database == == 3 Create Zabbix database ==
  
-For Zabbix [[:2.4/manual/concepts/server|server]] and [[:2.4/manual/concepts/proxy|proxy]] daemons, as well as Zabbix frontend, a database is required. It is not needed to run Zabbix [[:2.4/manual/concepts/agent|agent]].+For Zabbix [[manual:concepts:server|server]] and [[manual:concepts:proxy|proxy]] daemons, as well as Zabbix frontend, a database is required. It is not needed to run Zabbix [[manual:concepts:agent|agent]].
  
-SQL [[:2.4/manual/appendix/install/db_scripts|scripts are provided]] for creating database schema and inserting the dataset. Zabbix proxy database needs only the schema while Zabbix server database requires also the dataset on top of the schema.+SQL [[manual:appendix:install:db_scripts|scripts are provided]] for creating database schema and inserting the dataset. Zabbix proxy database needs only the schema while Zabbix server database requires also the dataset on top of the schema.
  
 Having created a Zabbix database, proceed to the following steps of compiling Zabbix. Having created a Zabbix database, proceed to the following steps of compiling Zabbix.
Line 50: Line 50:
   ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2   ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2
  
-<​note>​--with-libxml2 configuration option is required for virtual machine monitoring, supported since Zabbix 2.2.0.</​note>​+<note><​nowiki>​--with-libxml2</​nowiki> ​configuration option is required for virtual machine monitoring, supported since Zabbix 2.2.0.</​note>​
  
 To configure the sources for a Zabbix server (with PostgreSQL etc.), you may run: To configure the sources for a Zabbix server (with PostgreSQL etc.), you may run:
Line 64: Line 64:
   ./configure --enable-agent   ./configure --enable-agent
  
-Use can add <​nowiki>​--enable-static</​nowiki>​ flag to statically link libraries. If you plan to distribute compiled binaries among different servers, you must use this flag to make these binaries work without required libraries. Note that <​nowiki>​--enable-static</​nowiki>​ [[http://​blogs.sun.com/​rie/​entry/​static_linking_where_did_it|does not work under Solaris]].+You may use the <​nowiki>​--enable-static</​nowiki>​ flag to statically link libraries. If you plan to distribute compiled binaries among different servers, you must use this flag to make these binaries work without required libraries. Note that <​nowiki>​--enable-static</​nowiki>​ [[http://​blogs.sun.com/​rie/​entry/​static_linking_where_did_it|does not work under Solaris]].
  
 <note important>​ <note important>​
Line 73: Line 73:
  
 <​note>​Command-line utilities zabbix_get and zabbix_sender are compiled if %%--enable-agent%% option is used.</​note>​ <​note>​Command-line utilities zabbix_get and zabbix_sender are compiled if %%--enable-agent%% option is used.</​note>​
 +
 +<​note>​
 +Add optional path to the MySQL configuration file <​nowiki>​--with-mysql=/<​path_to_the_file>/​mysql_conf</​nowiki>​ to select the desired
 +MySQL client library when there is a need to use one that is not located in the default location.
 +
 +It is useful when there are several versions of MySQL installed or MariaDB installed alongside MySQL on the same system.
 +</​note>​
  
 <​note>​Use <​nowiki>​--with-ibm-db2</​nowiki>​ flag to specify location of the CLI API.\\ Use <​nowiki>​--with-oracle</​nowiki>​ flag to specify location of the OCI API.</​note>​ <​note>​Use <​nowiki>​--with-ibm-db2</​nowiki>​ flag to specify location of the CLI API.\\ Use <​nowiki>​--with-oracle</​nowiki>​ flag to specify location of the OCI API.</​note>​
Line 104: Line 111:
 <​note>​With SQLite the full path to database file must be specified; DB user and password are not required.</​note>​ <​note>​With SQLite the full path to database file must be specified; DB user and password are not required.</​note>​
  
-The rest of the parameters will suit you with their defaults if you have a small installation (up to ten monitored hosts). You should change the default parameters if you want to maximize the performance of Zabbix server (or proxy) though. See the [[:2.4/manual/appendix/performance_tuning|performance tuning]] section for more details.+The rest of the parameters will suit you with their defaults if you have a small installation (up to ten monitored hosts). You should change the default parameters if you want to maximize the performance of Zabbix server (or proxy) though. See the [[manual:appendix:performance_tuning|performance tuning]] section for more details.
  
   * if you have installed a Zabbix proxy, edit the proxy configuration file **/​usr/​local/​etc/​zabbix_proxy.conf**   * if you have installed a Zabbix proxy, edit the proxy configuration file **/​usr/​local/​etc/​zabbix_proxy.conf**
Line 155: Line 162:
 ''​msgfmt''​ utility from gettext package is required. ​ ''​msgfmt''​ utility from gettext package is required. ​
  
-<​note>​Additionally,​ to use any other language than English, its locale should be installed on the web server. See the [[:2.4/manual/web_interface/user_profile#​see_also|"​See also"​]] section in the "User profile"​ page to find out how to install it if required.</​note>​+<​note>​Additionally,​ to use any other language than English, its locale should be installed on the web server. See the [[manual:web_interface:user_profile#​see_also|"​See also"​]] section in the "User profile"​ page to find out how to install it if required.</​note>​
  
 == Installing frontend == == Installing frontend ==
Line 165: Line 172:
 You should see the first screen of the frontend installation wizard. You should see the first screen of the frontend installation wizard.
  
-{{:​2.4/​manual/​installation/​install_1.png?​550|}}+{{install_1.png?​550|}}
  
 == Step 2 == == Step 2 ==
Line 171: Line 178:
 Make sure that all software prerequisites are met. Make sure that all software prerequisites are met.
  
-{{:​2.4/​manual/​installation/​install_2.png?​550|}}+{{install_2.png?​550|}}
  
 ^Pre-requisite^Minimum value^Description^ ^Pre-requisite^Minimum value^Description^
Line 185: Line 192:
 |//​mbstring// ​ |  |php-mbstring ​ | |//​mbstring// ​ |  |php-mbstring ​ |
 |//PHP mbstring.func_overload option// ​ |must be disabled ​ |In php.ini:\\ mbstring.func_overload = 0.  | |//PHP mbstring.func_overload option// ​ |must be disabled ​ |In php.ini:\\ mbstring.func_overload = 0.  |
 +|//PHP always_populate_raw_post_data option// ​ |must be disabled ​ |Required only for PHP versions 5.6.0 or newer.\\ In php.ini:\\ always_populate_raw_post_data = -1 |
 |//​sockets// ​ |  |php-net-socket. Required for user script support. ​  | |//​sockets// ​ |  |php-net-socket. Required for user script support. ​  |
 |//​gd// ​ |2.0 or higher ​ |php-gd. PHP GD extension must support PNG images (//<​nowiki>​--with-png-dir</​nowiki>//​),​ JPEG (//<​nowiki>​--with-jpeg-dir</​nowiki>//​) images and FreeType 2 (//<​nowiki>​--with-freetype-dir</​nowiki>//​). | |//​gd// ​ |2.0 or higher ​ |php-gd. PHP GD extension must support PNG images (//<​nowiki>​--with-png-dir</​nowiki>//​),​ JPEG (//<​nowiki>​--with-jpeg-dir</​nowiki>//​) images and FreeType 2 (//<​nowiki>​--with-freetype-dir</​nowiki>//​). |
Line 196: Line 204:
 Optional pre-requisites may also be present in the list. A failed optional prerequisite is displayed in orange and has a //Warning// status. With a failed optional pre-requisite,​ the setup may continue. Optional pre-requisites may also be present in the list. A failed optional prerequisite is displayed in orange and has a //Warning// status. With a failed optional pre-requisite,​ the setup may continue.
  
 +<note important>​If there is a need to change the Apache user or user group, permissions to the session folder must be verified. Otherwise Zabbix setup may be unable to continue.</​note>​
 == Step 3 == == Step 3 ==
  
 Enter details for connecting to the database. Zabbix database must already be created. Enter details for connecting to the database. Zabbix database must already be created.
  
-{{:​2.4/​manual/​installation/​install_3.png?​550|}}+{{install_3.png?​550|}}
  
 == Step 4 == == Step 4 ==
Line 206: Line 215:
 Enter Zabbix server details. Enter Zabbix server details.
  
-{{:​2.4/​manual/​installation/​install_4.png?​550|}}+{{install_4.png?​550|}}
  
 == Step 5 == == Step 5 ==
Line 212: Line 221:
 Review a summary of settings. Review a summary of settings.
  
-{{:​2.4/​manual/​installation/​install_5.png?​550|}}+{{install_5.png?​550|}}
  
 == Step 6 == == Step 6 ==
Line 218: Line 227:
 Download the configuration file and place it under conf/. Download the configuration file and place it under conf/.
  
-{{:​2.4/​manual/​installation/​install_6.png?​550|}}+{{install_6.png?​550|}}
  
-{{:​2.4/​manual/​installation/​saving_zabbix.conf.png|}}+{{saving_zabbix.conf.png|}}
  
 <note tip>​Providing the webserver user has write access to conf/ directory the configuration file would be saved automatically and it would be possible to proceed to the next step right away.</​note>​ <note tip>​Providing the webserver user has write access to conf/ directory the configuration file would be saved automatically and it would be possible to proceed to the next step right away.</​note>​
Line 227: Line 236:
 Finish the installation. Finish the installation.
  
-{{:​2.4/​manual/​installation/​install_7.png?​550|}}+{{install_7.png?​550|}}
  
 == Step 8 == == Step 8 ==
Line 233: Line 242:
 Zabbix frontend is ready! The default user name is **Admin**, password **zabbix**. Zabbix frontend is ready! The default user name is **Admin**, password **zabbix**.
  
-{{:2.4/manual/quickstart/login.png?​550|}}+{{manual:quickstart:login.png?​550|}}
  
-Proceed to [[:2.4/manual/quickstart/login|getting started with Zabbix]].+Proceed to [[manual:quickstart:login|getting started with Zabbix]].
  
 ==== Troubleshooting ==== ==== Troubleshooting ====
  
-See the section on [[:2.4/manual/appendix/install/troubleshooting|installation-specific issue troubleshooting]].+See the section on [[manual:appendix:install:troubleshooting|installation-specific issue troubleshooting]].
  
 ==== See also ==== ==== See also ====
   - [[http://​www.zabbix.org/​wiki/​How_to/​configure_shared_memory|How to configure shared memory for Zabbix daemons]]   - [[http://​www.zabbix.org/​wiki/​How_to/​configure_shared_memory|How to configure shared memory for Zabbix daemons]]