network/nagios: Updated for version 3.2.1.

1 files changed, 121 insertions, 0 deletions

diff --git a/network/nagios/README.SLACKWARE b/network/nagios/README.SLACKWARE
new file mode 100644
index 0000000000000..fcc3735d2485f
--- /dev/null
+++ b/network/nagios/README.SLACKWARE
@@ -0,0 +1,121 @@
+README.Slackware
+================
+
+This file contains some basic instructions to get nagios installed and 
+running on your computer.
+
+0) Before running the SlackBuild Script
+---------------------------------------
+
+0.1) Create nagios group & user
+
+Before even running the SlackBuild script, create the necessary 'nagios'
+user and group. The SlackBuild script won't run if these do not exist.
+
+The suggested UID and GID is 213, but you can change this as needed:
+
+  # groupadd -g 213 nagios
+  # useradd -u 213 -d /dev/null -s /bin/false -g nagios nagios
+
+0.2) Add 'apache' to 'nagios' group
+
+For several nagios scripts to run without problems, you need to add the 
+'apache' user to the 'nagios' group, so that it can write to the 
+/var/nagios/rw directory:
+
+  # usermod -G nagios apache
+
+0.3) Select DOCROOT
+
+The standard SlackBuild script puts the nagios files in /var/www/htdocs
+This is fine for a stock Slackware installation, but if your 'DOCROOT' 
+lives in another directory, you can specify it when starting the SlackBuild 
+script like this:
+
+# DOCROOT=/your/docroot/dir ./nagios.SlackBuild
+
+1) Post-installation
+--------------------
+
+After building & installing the nagios package, there are some additional 
+steps to take.
+
+1.1) Check /etc/nagios/nagios.cfg & /etc/nagios/cgi.cfg
+
+These are the basic configuration files for the nagios server. Do read the
+documentation to understand what all the different settings mean.
+
+1.2) Edit /etc/httpd/extra/nagios.conf
+
+To be able to view the documentation, edit this file.
+After the "<Directory "/var/www/htdocs/nagios">" line, change:
+
+	Options None
+
+to read:
+
+	Options FollowSymLinks
+
+1.3) Edit /etc/httpd/httpd.conf
+
+Now you need to add the extra/nagios.conf file as an included file. To
+accomplish this, after the "DocumentRoot /srv/httpd/htdocs" line, add:
+
+	Include /etc/httpd/extra/nagios.conf
+
+1.4) Create access file
+
+The /etc/httpd/extra/nagios.conf file defines /etc/nagios/htpasswd.users
+as the file with the authorized users.
+To create this file with a standard user called 'nagiosadmin', type:
+
+  # htpasswd -c /etc/nagios/htpasswd.users nagiosadmin
+
+then type the password you choose twice.
+
+To add other users, delete users, etc., check the man page for htpasswd:
+
+  # man htpasswd
+
+1.5) Restart httpd
+
+  # /etc/rc.d/rc.httpd restart
+
+1.6) Put startup command in /etc/rc.d/rc.local:
+
+	# Start nagios:
+	if [ -x /etc/rc.d/rc.nagios ]; then
+	        echo "Starting nagios..."
+	        /etc/rc.d/rc.nagios start
+	fi
+
+1.7) Put shutdown command in /etc/rc.d/rc.local_shutdown:
+
+	# Stop nagios:
+	if [ -x /etc/rc.d/rc.nagios ]; then
+	        echo "Stopping nagios..."
+	        /etc/rc.d/rc.nagios stop
+	fi
+
+1.8) Make /etc/rc.d/rc.nagios executable:
+
+  # chmod +x /etc/rc.d/rc.nagios
+
+1.9) Start nagios:
+
+  # /etc/rc.d/rc.nagios start
+
+2) Adding hosts, routers, switches, etc.
+----------------------------------------
+
+Lot of documentation is included in this package and should be read to fully
+understand how to add hosts, routers, switches, etc.
+
+To add functionality, build & install the nagios-plugins on your server.
+
+To monitor external Linux hosts, install the nrpe package on them, together
+with the nagios-plugins.
+
+To monitor Windows hosts, install NSClient++ on them.
+
+Do check the http://wiki.nagios.org pages for some useful information.