View source for Zabbix - cgi and mysql

[[Category:monitoring]]


== Zabbix Monitoring Solution ==

The purpose of this document is to assist in installing the Zabbix server software and Zabbix agent on the Alpine Linux operating system. Instructions on how to configure and use Zabbix - as well as many useful tutorials - can be found at http://www.zabbix.com.

{{Note|Currently, Zabbix will only work as expected when running on an Alpine Linux system updated from the latest snapshots of the Edge repository. It will be properly supported with the next major version stable release (Alpine 2.2).}}

== Install Lighttpd, and PHP ==

{{:Setting Up Lighttpd With FastCGI}}

== Configure PostgreSQL ==

Setup and configure PostgreSQL:

 apk add postgresql postgresql-client 
 /etc/init.d/postgresql setup
 /etc/init.d/postgresql start
 rc-update add postgresql

== Install Zabbix ==

 apk add zabbix

Now we need to set up the zabbix database. Substitute '*********' in the example below for a real password:

<pre>
psql –U postgres
postgres=# create user zabbix with password '*********';
postgres=# create database zabbix owner zabbix;
postgres=# \q
cd /usr/share/zabbix/dbms/create/
cat postgresql.sql | psql -U zabbix zabbix
cd data/
cat data.sql | psql -U zabbix zabbix
cat images_pgsql.sql | psql -U zabbix zabbix
</pre>

Create a softlink for the Zabbix web-frontend files:

 ln -s /usr/share/webapps/zabbix /var/www/localhost/htdocs/zabbix

Edit PHP configuration to satisfy some zabbix requirements. Edit /etc/php/php.ini and configure the following values at least:

<pre>
Max_execution_time = 600
Expose_php = off
Date.timezone = <insert your timezone here>
post_max_size = 32M
upload_max_filesize = 16M
max_input_time = 600
memory_limit = 256M
</pre>

Configure the following entries in /etc/zabbix/zabbix_server.conf, where DBPassword is the password chosen for the database above:

<pre>
DBName=zabbix

# Database user

DBUser=zabbix

# Database password
# Comment this line if no password used

DBPassword=*********
</pre>

Start Zabbix server:

 rc-update add zabbix-server
 /etc/init.d/zabbix-server start

You should now be able to browse to the Zabbix frontend: http://yourservername/zabbix.

Follow the setup instructions to configure Zabbix, supplying the database information used above.

== Install Zabbix Agent on Monitored Servers ==

Zabbix can monitor almost any operating system, including Alpine Linux hosts. Complete the following steps to install the Zabbix agent on Alpine Linux.

{{Note|Support to allow zabbix-agentd to view running processes on Alpine Linux has been added since linux-grsec-2.6.35.9-r2. Please ensure you have that kernel installed prior to attempting to run zabbix-agentd.}}

Ensure that the readproc group exists (support added since alpine-baselayout-2.0_rc1-r1), by adding the following line to /etc/group:

 readproc:x:30:

Install the agent package:

 apk add zabbix-agent

Edit the /etc/zabbix/zabbix_agentd.conf file and configure at least the following option:

 Server=<ip or hostname of zabbix server>

Start the zabbix-agent:

 rc-update add zabbix-agentd
 /etc/init.d/zabbix-agentd start