Installing

 1. verify that you have the prerequisites installed
      + perl
        the software has been tested with 5.6.1 and should work with anything
        more recent as well.
        Find perl at www.perl.org
       
        Note: there are issues with 5.6.0 and 5.8.0 on some operating systems,
        see bugs.html for additional details.
       
      + sendmail and qpage are recommended. either or both can be used to send
        notifications.
        Find sendmail at www.sendmail.org
        Find qpage at www.qpage.org
       
        Note: this does not need to be the real sendmail, as long as it looks
        and smells like sendmail. ie. qmail's sendmail compatible sendmail
        program will be just fine.
       
      + fping is used by the Ping Monitoring module for ping tests. While this
        is not required, it is highly recommended.
        Find fping at www.fping.org
       
      + a cgi capable web server, such as apache.
        and optionally, mod_perl.
        Find apache at httpd.apache.org
        Find mod_perl at perl.apache.org
       
      + Berkeley DB and perl DB_File
        Find DB at www.sleepycat.org
        DB_File ships with perl.
       
        Alternatively, ndbm, odbm, sdbm, or gdbm can be used, but they have not
        been extensively tested.
       
      + optionally, Socket6.pm, an IPv6 capable fping, and an OS that supports
        it are required for IPv6 support.
        Find Socket6 at CPAN
        IPv6 support is available only in version 3.2 and later
       
      + optionally, GD.pm and its various dependencies are required for
        graphing support.
        Find GD.pm at stein.cshl.org
        Graphing support is available only in version 3.2 and later
       
      + an understanding of UNIX file permissions and how to use and operate
        your web server.
       
 2. unbundle the tarball
 3. run ./Configure
 4. answer any questions it asks
 5. run make
 6. run make install
 7. create 2 files in the data directory:
     1. config
     2. users
    in addition to the documentation, the tarball contains examples in the
    'examples' directory.
 8. configure your web server
      + be sure that $datadir is writable by the www user (or whatever uid your
        web werver runs as)
      + copy icons to somewhere accessible by your web server (these locations
        get specified in config file, above) or feel free to replace them with
        your own icons, or no icons at all.
      + create a symlink in your cgi-bin directory to the arguscgi program
      + optionally, adjust your httpd.conf to provide an alias or a virtual
        server, some suggestions:
          o alias /argus -> /cgi-bin/arguscgi
            access it as: www.example.com/argus
          o create virt server,
            alias / -> /cgi-bin/arguscgi, or use redirect, etc
            access it as argus.example.com/
      + optionally set up mod_perl
        exact configuration details will vary, but something like:
                        PerlRequire /.../arguscgi
                        <Location /argus>
                            SetHandler   perl-script
                            PerlHandler  Argus::Web
                            allow from all
                        </Location>
                        
        You might like to know that the author swears by combining a virtual
        server along with mod_perl:
                        <VirtualHost *>
                            ServerName  argus.example.com
                            <Location />
                                SetHandler   perl-script 
                                PerlHandler  Argus::Web
                                allow from all
                            </Location>
                        </VirtualHost>
                        
 9. start the server by running argusd
    or install the rc.argusd script as appropriate for your system.
10. you are finished, sing a happy song, or, optionally, send in a bug report
    or survey report

