[Pkg-nagios-devel] nagios NEWS,1.5,1.6 README.Debian,1.4,1.5 changelog,1.50,1.51
seanius@haydn.debian.org
seanius@haydn.debian.org
Update of /cvsroot/pkg-nagios/nagios
In directory haydn:/org/alioth.debian.org/chroot/home/users/seanius/tmp/cvs-serv3590
Modified Files:
NEWS README.Debian changelog
Log Message:
lots of documentation updates.
Index: NEWS
===================================================================
RCS file: /cvsroot/pkg-nagios/nagios/NEWS,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- NEWS 8 Mar 2005 23:07:50 -0000 1.5
+++ NEWS 3 Apr 2005 00:34:28 -0000 1.6
@@ -1,3 +1,10 @@
+nagios (2:1.3-cvs.20050402-1) unstable; urgency=low
+
+ if you're using nagios in a virtualhost and the latest version breaks
+ somethinng for you, please see README.Debian.
+
+ -- sean finney <seanius@debian.org> Sat, 02 Apr 2005 19:31:07 -0500
+
nagios (2:1.3-cvs.20050116-4) unstable; urgency=medium
update-nagios is now gone, as nagios has this whole time
Index: README.Debian
===================================================================
RCS file: /cvsroot/pkg-nagios/nagios/README.Debian,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- README.Debian 16 Mar 2005 14:21:45 -0000 1.4
+++ README.Debian 3 Apr 2005 00:34:28 -0000 1.5
@@ -1,136 +1,93 @@
+================================================================================
nagios for Debian
-----------------------
-
-1. General Information.
-2. Compile options
-3. nagios for netsaint Users
-4. Nagios and Databases and "Cgi and init.d script can't read status info"
-5. Performance issues on heavily loaded servers
-
-1. General Information.
-
-Nagios is the replacement and coninuation of the Netsaint project.
-It will install as a totaly separate software package, but will replace
-Netsaint. Where I can, I'll preserve configuration choices from Netsaint.
-
-Configuration of the web server should work automatically if you are running
-apache. If not you will have to to it yourself. Read the docs to find out more.
-
-In the Apache httpd.conf, a include will be made. This includes the file
-/etc/nagios/apache.conf which does the configuration of Aliases etc.
-
-The standard configuration puts the web page at http://localhost/nagios/ but
-for a limited time (specially upgrading from Netsaint) it will also be possible
-to use http://localhost/netsaint/.
-
-You will need to generate an account to access it. Under apache, use:
- htpasswd /etc/nagios/htpasswd.users nagiosadmin
-If upgrading, I will convert the 'netsaintadmin' user to be 'nagiosadmin'.
-
-
-You may also want to consider altering the access list to prevent other hosts
-accessing the site. Edit /etc/apache/srm.conf (or your web server's equivelant)
-for this.
-
-To configure the system, read the docs and edit the files in /etc/nagios
-especially hosts.cfg.
+================================================================================
+last edited:
+ -- sean finney <seanius@debian.org> Sat, 02 Apr 2005 19:18:40 -0500
+================================================================================
-----------------------
+================================================================================
+Table of Contents
+================================================================================
+1. Nagios, Apache, VirtualHosts
2. Compile options
+3. Nagios and Databases and "Cgi and init.d script can't read status info"
+4. Performance issues on heavily loaded servers
+================================================================================
-This version has been compiled to use pngs and jpgs in the statusmap.cgi
-whereever you would normally use a GD2.
-
-Nagios is compiled with support for both MySQL and PostgreSQL.
+================================================================================
+1. Nagios, Apache, VirtualHosts
-By request from David Kempe, I'm including the full configure line(s), so
-those that know Netsaint/Nagios by heart can figure out if something is
-amiss from this.
-The base configure line is as follows. This is what is used
-to compile the 'nagios-text' package:
+To configure nagios, first log into your new nagios site and read
+the online docs. They're very good and quite extensive. Then take a
+look under /etc/nagios. Note that there may still be sections in the
+documentation that refer to stuff like "/usr/local/nagios", which will
+not be where things are. It shouldn't be too hard to find the actual
+location of the file though.
- CONFIGURE=./configure --prefix=/usr \
- --mandir=/usr/share/man \
- --with-nagios-user=nagios \
- --with-nagios-grp=nagios \
- --bindir=/usr/sbin \
- --sbindir=/usr/lib/cgi-bin/nagios \
- --datadir=/usr/share/nagios/htdocs \
- --libexecdir=/usr/lib/nagios/plugins \
- --sysconfdir=/etc/nagios \
- --mandir=/usr/share/man \
- --infodir=/usr/share/info \
- --localstatedir=/var/log/nagios \
- --with-ping-command="/bin/ping -n %s -c %d" \
- --with-template-extinfo \
- --with-template-objects \
- --with-perlcache
+Apache is configured for nagios by dropping a symlink to the nagios apache.conf
+file in the appropriate conf.d sub-directory, so things should pretty much
+just work on their own.
-To compile the two SQL enabled Nagios packages, I added the follwoing.
-For the PostgreSQL enabled package:
+If you are using virtual hosts, you will need to customize the apache.conf
+shipped in /etc/nagios to suit your particular configuration. All links
+throughout your nagios site should be relative to where they are rooted,
+for example, all the cgi links will be to cgi-bin/ (no leading slash),
+which should let you put nagios just about wherever you want. I've found
+the following configuration excerpt works for me for a simple top-level
+nagios virtualhost:
- $CONFIGURE --with-pgsql-comments \
- --with-pgsql-downtime \
- --with-pgsql-extinfo \
- --with-pgsql-retention \
- --with-pgsql-status \
- --with-pgsql-xdata
+ScriptAlias /cgi-bin /usr/lib/cgi-bin/nagios
+Alias / /usr/share/nagios/htdocs/
-And for the mySQL enabled package, the command line looked like:
+which should go inside the virtualhost block. there may be a few more
+things like this you'll probably have to do for anything else aliased.
+the important thing is that all of the aliases and scriptaliases have
+to go before the "alias /".
- $CONFIGURE --with-mysql-comments \
- --with-mysql-downtime \
- --with-mysql-extinfo \
- --with-mysql-retention \
- --with-mysql-status \
- --with-mysql-xdata
+================================================================================
-----------------------
+2. Compile options
-3. nagios for netsaint Users
+for anyone who's curious:
-A note about upgrading Netsaint to Nagios if I may. I created a quite simple
-shell script (installed as /usr/sbin/upgrade-netsaint2nagios). This works
-for me, but don't take my word for it. My Nagios setup is quite simple at
-the moment, and I have not been able to get reports how it works on a big
-complicated Netsaint/Nagios setup.
+# shared config options
+CFLAGS += -O2
+CONFIGURE = CFLAGS='$(CFLAGS)' ./configure --prefix=/usr \
+ --mandir=/usr/share/man \
+ --bindir=/usr/sbin \
+ --sbindir=/usr/lib/cgi-bin/nagios \
+ --datadir=/usr/share/nagios/htdocs \
+ --sysconfdir=/etc/nagios \
+ --infodir=/usr/share/info \
+ --libexecdir=/usr/lib/nagios/plugins \
+ --localstatedir=/var/log/nagios \
+ --with-ping-command="/bin/ping -n %s -c %d" \
+ --with-mail=/usr/bin/mail --with-perlcache \
+ --with-nagios-user=nagios \
+ --with-nagios-grp=nagios \
+ --with-template-objects \
+ --build=$(DEB_BUILD_GNU_TYPE) \
+ --host=$(DEB_HOST_GNU_TYPE)
-You will have to run this script manually after installing Nagios. IF I get
-good feedback, and the script really works good, I'll run it in the post
-installation script(s) of Nagios. I'll give it a few months to 'grow', so
-we'll see what happens.
+# nagios-pgsql
+CONFIGUREPG = $(CONFIGURE) --with-pgsql-xdata
+# nagios-mysql
+CONFIGUREMY = $(CONFIGURE) --with-mysql-xdata
+# nagios-text
+CONFIGUREFI = $(CONFIGURE) --with-template-extinfo
- -- Turbo Fredriksson <turbo@debian.org>, Thu, 20 Jun 2002 08:28:44 +0200
+================================================================================
-4. Nagios and Databases and "Cgi and init.d script can't read status
+3. Nagios and Databases and "Cgi and init.d script can't read status
info"
-First read the normal nagios documentation to setup nagios for the
-database access.
-Then you want the cgi-script and the init.d script to correctly know the
-status of nagios. You need the check_nagios_db file from
-/usr/doc/nagios-common/, put it where you like but adjust the pathes in
-the following examples. I REALLY suggest /etc/nagios/check_nagios_db as
-the init-script now already looks if it is there and will use it
-automagically.
-If you use PostgreSQL you need to change the line
-my $driver = "mysql"; in the script to
-my $driver = "Pg";
-
-Make it executable:
-sudo chmod +x /etc/nagios/check_nagios_db
-
-Now edit the /etc/nagios/cgi.cfg and put a # in front of the line
-nagios_check_command=/usr/lib/nagios/plugins/check_nagios /var/log/nagios/status.log 5 'nagios'
-
-and remove the # in front of the line
-nagios_check_command=/etc/nagios/check_nagios_db
+See README.mysql and README.pgsql.
-Restart nagios and you are done.
+================================================================================
-5. Performance issues for heavily loaded servers
+4. Performance issues for heavily loaded servers
if your server is having trouble keeping up with load, host and service
checks may periodically fail with confusing statuses. to work around this,
@@ -141,4 +98,4 @@
- setting normal_check_interval to a higher value in your service definitions
- upgrading to a faster machine ;p
- -- sean finney <seanius@debian.org> Wed, 16 Mar 2005 09:10:19 -0500
+================================================================================
Index: changelog
===================================================================
RCS file: /cvsroot/pkg-nagios/nagios/changelog,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -d -r1.50 -r1.51
--- changelog 3 Apr 2005 00:02:07 -0000 1.50
+++ changelog 3 Apr 2005 00:34:28 -0000 1.51
@@ -20,6 +20,11 @@
(closes: #299613).
- added a note about heavily loaded servers in README.Debian
(closes: #283947, #292473). thanks to Cyril Bouthors <cyb@debian.org>.
+ - updated README.Debian, removing various out-of-date info, and putting
+ in a little more about virtual hosts with apache.
+ - also updated NEWS, as it looks like the recent side.html change broke
+ the configs of some people who were using nagios in a virtualhost. note
+ that a simple fix exists, see README.Debian :)
-- sean finney <seanius@debian.org> Sat, 02 Apr 2005 18:42:39 -0500