Instructions for installing SNMP in Apache
==========================================

Requirements:
        Apache 1.3 or Apache 2.0.
                Apache 1.3 must be a version greater than 1.3.14
                Apache 2.0 must be a version greater than 2.0.36
                Any Covalent product will work, regardless of Apache version
        Mod_so must be enabled in your Apache build
        Apxs must be installed
        Perl must be installed and in your path
        make must be installed

Instructions:

        untar snmp-X.tgz file.
        cd snmp-X

        ./build_apache_snmp.sh [apache_version] [/path/to/apxs]

        apache_version should be either 1.3 or 2.0 and defines if you 
are building snmp for Apache 1.3 or Apache 2.0.
        /path/to/apxs is the full path to your apxs program.  You must 
have apxs installed for this script to work.

        This will create a new directory, snmp_module_[apache_version] with
the layout:
                snmp_module_[apache_version]/
                               module
                               tools
                               conf

Copy the files in module to /path/to/apache/libexec (for Apache 1.3) or
/path/to/apache/modules (for Apache 2.0).
Create a new directory /path/to/apache/var

Copy the files in conf to /path/to/apache/conf

NOTE:  The default port for SNMP is 1610.
The port can be changed in /path/to/apache/conf/snmpd.conf.

Edit /path/to/apache/conf/http[s]d.conf (apache 1.3)
        1) At the top of the file add:
        LoadModule snmp_agt_module libexec/libsnmp_agt.so

        2) If ClearModuleList is already in your config file, then after 
           that directive add:
        AddModule covalent-snmp-v13.c

        3) Move the MaxClients directive to underneath the AddModule line you
        just added.

        4) At the bottom of the file add:
        SNMPConf conf
        SNMPVar var

Edit /path/to/apache/conf/http[s]d.conf (apache 2.0)
        1) At the top of the file add:
        LoadModule snmpcommon_module modules/libsnmpcommon.so
        LoadModule snmpagt_module modules/libsnmpmonagt.so

        2) At the bottom of the file add:
        SNMPConf conf
        SNMPVar var

Restart Apache.

Test snmp with the command:
        snmp_module_[apache_version]/tools/snmpwalk -p 1610 -M snmp_module_[apache_version]/mibs localhost public

This should return all of the current information about your running Apache.
The command will only work on localhost because of the default SNMP 
configuration.  Because this only works on localhost, you must use 127.0.0.1
when answering the question:  IP address of the server hosting the snmp agent.
