#####################
Nagios Contrib README
#####################

This directory contains various programs, scripts, etc. that
have been contributed by various people.  Read the source code
if you want to find who did what.

Here is a description of what you'll find...


Conversion Programs:
--------------------

- convertcfg.c is a program to quickly convert old "host" config
  files to the new template-based object config files.  It can also
  convert extended host information definitions. Type 'make convertcfg'
  to compile the utility.


Additional CGIs:
----------------

- traceroute.cgi is (surprise) a CGI that allows you to do a traceroute
  to a specific IP address.  Simply do a 'chmod +x' to make it executable
  and place it in the CGI directory (i.e. /usr/local/nagios/sbin).
  Requires Perl.

- daemonchk.c is a CGI contributed by Karl DeBisschop that can test to
  see whether or not the Nagios process is running.


Miscellaneous Goodies:
----------------------

- htaccess.sample is a *sample* .htaccess file that can be used with
  Apache to require password authentication for access to the web
  interface.

- Notes about "make rpm" addition, tested on RockyLinux 8
  1. Using 4.4.6 as example, download epel-nagios.spec and epel-patches/* files.
    wget https://download-ib01.fedoraproject.org/pub/epel/8/Everything/SRPMS/Packages/n/nagios-4.4.6-4.el8.src.rpm
    rpm -ivh nagios-4.4.6-4.el8.src.rpm # Install patches into ~/RPMBUILD/SOURCES and nagios into ~/RPMBUILD/SPECS
    cp ~/RPMBUILD/SOURCES/* epel-patches
    cp ~/RPMBUILD/SPECS/nagios ./epel-nagios.spec

  2. Prepare your rpmbuild environment to buuild EPEL8+ RPMs.

  sudo yum install -y rpmdevtools gcc libtool rpmbuild \
  policycoreutils-devel selinux-policy-devel \
  perl-generators gdbm-devel pyparsing systemtap perl-ExtUtils-Manifest \
  libdb perl-ExtUtils-MakeMaker  perl-ExtUtils-Install perl-devel  \
  perl-ExtUtils-ParseXS perl-local-lib  perl-CPAN perl-ExtUtils-AutoInstall \
  perl-Test-Simple perl-ExtUtils-Embed  perl-HTML-Lint

  3. Generate contrib/Makefile from contrib/Makefile.in.

     ../configure      # To generate contrib/Makefile from Makefile.in
     make rpm          # Do the rpm build under ./rpmbuild directory
     make localsrc-rpm # tar up existing src code to create rpm

  4. Testing upgrade Nagioscore 4.4.6 on this build host using RPMs created here.

  sudo rpm -Uvh nagios-common-4.4.6-1el8.x86_64.rpm nagios-contrib-4.4.6-1el8.x86_64.rpm \
       nagios-devel-4.4.6-1el8.x86_64.rpm  nagios-4.4.6-1el8.x86_64.rpm
  sudo systemctl daemon-reload
  sudo systemctl restart nagios

