summaryrefslogtreecommitdiff
path: root/network/zabbix_server/README.SLACKWARE
diff options
context:
space:
mode:
Diffstat (limited to 'network/zabbix_server/README.SLACKWARE')
-rw-r--r--network/zabbix_server/README.SLACKWARE131
1 files changed, 131 insertions, 0 deletions
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.