[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
-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
-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
+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