====== Zabbix ======

**Zabbix** is an open source network monitoring application capable of 
monitoring network devices, servers, databases and web services on a wide 
variety of operating systems.

**Website:** [[http://www.zabbix.com/|www.zabbix.com]]

====== Prerequisites =====

  * [[howtos:databases:install_mysql_on_slackware|MySQL]]
  * [[httpd]]

====== Installation ======

**Zabbix** is available at [[http://slackbuilds.org/repository/14.0/network/zabbix_agentd/|zabbix_agentd (SBo)]], [[http://slackbuilds.org/repository/14.0/network/zabbix_proxy/|zabbix_proxy (SBo)]], [[http://slackbuilds.org/repository/14.0/network/zabbix_server/|zabbit_server (SBo)]]

**1)** Create the **zabbix** user and group

<code>
root@darkstar# groupadd -g 228 zabbix
root@darkstar# useradd -d /dev/null -s /bin/false -u 228 -g 228 zabbix
</code>

**3)** Install the necessary version of **Zabbix** from SBOPKG/Slackbuilds

  * [[http://slackbuilds.org/repository/14.0/network/zabbix_agentd/|zabbix_agentd]]
  * [[http://slackbuilds.org/repository/14.0/network/zabbix_proxy/|zabbix_proxy]]
  * [[http://slackbuilds.org/repository/14.0/network/zabbix_server/|zabbit_server]]


**4)** Create the **MySQL** database

**4a)** On your **MySQL** server, connect with full privileges:
<code>
root@darkstar# mysql -u root -p 
</code>

**4b)** Create the zabbix database & user:
<code>
mysql> create database zabbix character set utf8;
mysql> use mysql;
mysql> grant all on zabbix.* to zabbix@localhost identified by
'<zabbix_password>';
mysql> flush privileges;
mysql> quit
</code>

**4c)** On your **Zabbix** server, connect to the new database, create the schema & add initial data:
<code>
root@darkstar# cd /usr/share/zabbix_server/create
root@darkstar# mysql -u zabbix -p <zabbix_password>
mysql> use zabbix;
mysql> source schema/mysql.sql;
mysql> source data/data.sql;
mysql> source data/images_mysql.sql;
mysql> quit
</code>

**5)** Configure **PHP**:

**5a)** Zabbix requires some parameters in **/etc/httpd/php.ini** to be altered:
<file>
post_max_size = 16M               (Default = 8M)
max_execution_time = 300          (Default = 30)
max_input_time = 300              (Default = 60)
date.timezone = America/Chicago   (Default = blank)
***NOTE*** the ";" in front of date.timezone MUST be removed
</file>

**5b)** Enable **PHP** in **/etc/httpd/httpd.conf**:
  * **ADD:** index.php to the  "DirectoryIndex index.html" line. 
  * **UNCOMMENT:** "Include /etc/httpd/mod_php.conf" line.

<note important>
After changing the **php.ini** file, you'll need to restart httpd for the changes to have effect:
</note>
<code>
root@darkstar# /etc/rc.d/rc.httpd restart
</code>

**6)**  Edit the zabbix_server configuration file
(**/etc/zabbix/zabbix_server.conf**):
<file>
DBUser=zabbix                    (Default is "root" and it's not a good idea)
DBPassword=<zabbix_password>     (Change as defined above)
</file>

**7)** Make **/etc/rc.d/rc.zabbix_server** executable:
<code>
root@darkstar# chmod +x /etc/rc.d/rc.zabbix_server
</code>

**8)** Start the **Zabbix** server
<code>
root@darkstar# /etc/rc.d/rc.zabbix_server start
</code>

The **Zabbix** server can be accessed via a web browser at <nowiki>http://your_server/zabbix/</nowiki>

Follow the setup instructions.

<note>
Default login is:
     USER: Admin
     PASS: zabbix
</note>


====== Sources ======

 * Originally written by [[wiki:user:arfon | arfon]] \\
 * Contributions by [[wiki:user:mfillpot | mfillpot]]
 * Contributions by [[wiki:user:markand | markand]]

{{tag>howtos software zabbix network_monitoring author_arfon}}