From 6c4ec6e689ca33b6e8026211a5f847cffe655ded Mon Sep 17 00:00:00 2001
From: Niels Horn <niels.horn@gmail.com>
Date: Thu, 13 May 2010 01:00:27 +0200
Subject: network/zabbix_server: Added to 13.0 repository

---
 network/zabbix_server/README.SLACKWARE | 131 +++++++++++++++++++++++++++++++++
 1 file changed, 131 insertions(+)
 create mode 100644 network/zabbix_server/README.SLACKWARE

(limited to 'network/zabbix_server/README.SLACKWARE')

diff --git a/network/zabbix_server/README.SLACKWARE b/network/zabbix_server/README.SLACKWARE
new file mode 100644
index 0000000000..c2865e8fbb
--- /dev/null
+++ b/network/zabbix_server/README.SLACKWARE
@@ -0,0 +1,131 @@
+README.Slackware
+================
+
+This file contains some specific instructions to complete the
+installation of zabbix_server on Slackware.
+
+You will need to have a working installation of httpd and MySQL (*) for
+zabbix_server to run. MySQL server does not have to be on the same box as your
+zabbix_server, but they need to be able to communicate and you will need at 
+least the MySQL client on the box that will run zabbix_server.
+
+(*) zabbix can work with MySQL, Oracle, PostgreSQL and SQLite databases,
+    but these instructions are for MySQL, as it is included with Slackware.
+
+0) Before running the SlackBuild script
+---------------------------------------
+
+0.1) zabbix group & user
+
+Before running the zabbix_server.SlackBuild script, you will need to create
+the 'zabbix' user and group. The script won't run if these do not
+exist.
+
+The suggested UID and GID is 228, but you can change this as needed:
+
+  # groupadd -g 228 zabbix
+  # useradd -u 228 -g zabbix -d /dev/null -s /bin/false zabbix
+
+1) Configuring zabbix_server
+----------------------------
+
+A very complete (320 pages) PDF manual is included and installed in
+the /usr/doc/zabbix_server-<version>/ directory.
+For those in a hurry, here are some basic steps to get zabbix up &
+running:
+
+1.1) Create initial database
+
+On your MySQL server, connect with full privileges:
+
+  # mysql -u <your_user> -p <your_password>
+
+Create the zabbix database & user:
+
+  mysql> create database zabbix;
+  mysql> use mysql;
+  mysql> grant all on zabbix.* to zabbix@<your_zabbix_server> identified by '<your_password>';
+  mysql> flush privileges;
+  mysql> quit
+
+(note: if your MySQL server and zabbix server are the same, use "localhost"
+ for <your_zabbix_server>)
+
+On your zabbix server, connect to the new database:
+
+  # cd /usr/share/zabbix_server/create
+  # mysql -h <your_mysql_server> -u zabbix -p<your_password> zabbix
+
+In MySQL, create the schema & add initial data:
+
+  mysql> source schema/mysql.sql;
+  mysql> source data/data.sql;
+  mysql> source data/images_mysql.sql;
+  mysql> quit
+
+1.2) Configure PHP
+
+zabbix requires some parameters in /etc/httpd/php.ini to be altered:
+
+  - date.timezone		Needs to be set (default = blank)
+  - max_execution_time = 300	Default = 30
+
+After changing the php.ini file, you'll need to restart httpd for the
+changes to have effect:
+
+  # /etc/rc.d/rc.httpd restart
+
+1.3) zabbix_server configuration file
+
+A standard configuration file is installed as /etc/zabbix/zabbix_server.conf
+
+You will need to change at least the following lines:
+
+  DBHost=<your_mysql_server>		(Change if MySQL is not on localhost)
+  DBUser=zabbix				("root" doesn't sound like a good idea)
+  DBPassword=<your_password>		(Change as defined above)
+
+2) Start & Stop scripts for zabbix server
+-----------------------------------------
+
+2.1) Automatic startup and shutdown
+
+If you want to start zabbix_server on system bootup, include these lines in
+your /etc/rc.d/rc.local:
+
+  # Start zabbix_server
+  if [ -x /etc/rc.d/rc.zabbix_server ]; then
+    echo "Starting zabbix server..."
+    /etc/rc.d/rc.zabbix_server start
+  fi
+
+To guarantee a clean shutdown of zabbix_server, include this in 
+/etc/rc.d/rc.local_shutdown:
+
+  # Stop zabbix_server
+  if [ -x /etc/rc.d/rc.zabbix_server ]; then
+    echo "Stopping zabbix server..."
+    /etc/rc.d/rc.zabbix_server stop
+  fi
+
+2.2) Make /etc/rc.d/rc.zabbix_server executable
+
+Additionally, you'll have to set the rc script to be executable just like 
+any other Slackware rc script:
+
+  # chmod +x /etc/rc.d/rc.zabbix_server
+
+4) Starting zabbix server
+-------------------------
+
+Now you are ready to start zabbix_server by calling the startup script:
+
+  # /etc/rc.d/rc.zabbix_server start
+
+Once zabbix_server has started and configured correctly, you should be able
+to access it by pointing your browser at:
+
+  http://(ip-of-your-zabbix-server)/zabbix/
+
+From here on, you can follow the manual to start the initial configuration 
+and set up all the items to monitor.
-- 
cgit v1.2.3