mirror of
https://github.com/Ponce/slackbuilds
synced 2024-11-24 10:02:29 +01:00
148 lines
4.4 KiB
Text
148 lines
4.4 KiB
Text
README.Slackware
|
|
================
|
|
|
|
This file contains some specific instructions to complete the
|
|
installation of zabbix_server on Slackware.
|
|
|
|
zabbix-java has been moved to a separate package - zabbix-java-gateway
|
|
|
|
You will need to have a working installation of httpd and MariaDB (*) for
|
|
zabbix_server to run. MariaDB server does not have to be on the same box as
|
|
zabbix_server, but they need to be able to communicate and you will need at
|
|
least the MariaDB client on the box that will run zabbix_server.
|
|
|
|
(*) zabbix can work with MySQL and its forks, Oracle, PostgreSQL and IBM DB2
|
|
databases, but these instructions are for MariaDB, 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
|
|
----------------------------
|
|
|
|
Very complete documentation is available online at:
|
|
https://www.zabbix.com/documentation/
|
|
|
|
For those in a hurry, here are some basic steps to get zabbix up &
|
|
running:
|
|
|
|
1.1) Create initial database
|
|
|
|
On your MariaDB server, connect with full privileges:
|
|
|
|
# mysql -u <your_user> -p<your_password>
|
|
|
|
Create the zabbix database & user:
|
|
|
|
mysql> create database zabbix character set utf8 collate utf8_bin;
|
|
mysql> use mysql;
|
|
mysql> grant all privileges on zabbix.* to zabbix@<your_zabbix_server> identified by '<your_password>';
|
|
mysql> flush privileges;
|
|
mysql> quit
|
|
|
|
(note: if your MariaDB 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/database/mysql
|
|
# mysql -h <your_mysql_server> -u zabbix -p<your_password> zabbix
|
|
|
|
In MariaDB, create the schema & add initial data:
|
|
|
|
mysql> source schema.sql;
|
|
mysql> source data.sql;
|
|
mysql> source images.sql;
|
|
mysql> quit
|
|
|
|
1.2) Configure PHP
|
|
|
|
zabbix requires some parameters in /etc/php.ini to be altered:
|
|
|
|
- post_max_size = 16M Default = 8M
|
|
- max_execution_time = 300 Default = 30
|
|
- max_input_time = 300 Default = 60
|
|
- date.timezone Needs to be set (default = blank)
|
|
- always_populate_raw_post_data = -1
|
|
|
|
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) Configure httpd
|
|
|
|
zabbix requires php enabled in /etc/httpd/httpd.conf
|
|
|
|
uncomment the line:
|
|
Include /etc/httpd/mod_php.conf
|
|
|
|
add index.php to the DirectoryIndex parameter
|
|
Directory index.html index.php
|
|
|
|
|
|
1.4) 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_mariadb_server> (Change if MariaDB 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
|
|
|
|
3) 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.
|