    
         C O M P A Q (R)  C O M P U T E R  C O R P O R A T I O N

                    Compaq Foundation Agents - Linux

                             Version 4.90b
                           February 15, 2001

------------------------------------------------------------------------

1.  Introduction

2.  Documentation Updates and Corrections

3.  Known Issues

4.  Supported Linux Installations

5.  Installation
    5.1  Before installation
    5.2  Installing the Foundation Agents
    5.3  After installation

6.  New Features

7.  Supported Products


------------------------------------------------------------------------


1.  Introduction

The "Compaq Foundation Agents - Linux" software release contains 
Foundation Agents program and related files for Linux.  
The Compaq Foundation Agents take advantage of the systems management 
capabilities of Compaq servers. This release supports Red Hat Linux 6.2
and Red Hat Linux 7.0.

2.  Documentation Updates and Corrections

This section contains information on known errors and omissions in
other documentation. The information in this section is more up-to-date
than that in other documentation.

3.  Known Issues

    a. SNMP agent (snmpd; versions 4.1.1 and 4.1.2) leaks memory when SNMP
       requests fail the authentication (usually canused by incorrect
       Community String and/or Source of requests). Use "ps -elf |grep snmpd"
       command to view the size of snmpd. A workaround of this issue is
       provided within Host Agent (cmahostd). The workaround is disabled by
       default. The workaround, when enabled, will watch the size of snmpd
       every 30 minutes and restart snmpd when its size doubles.
       Before enabling the workaround, make sure that restarting snmpd will
       not cause any problem on your system. snmpd is restarted using
       "/etc/rc.d/init.d/snmpd restart" command.
       To enable the workaround, you need to add "-z" flag to the cmahostd
       command in /opt/compaq/foundation/etc/cmahostd. For example:
            PFLAGS="-p 15 -s OK -z"
       Restart the cmahostd using "/etc/rc.d/init.d/cmafdtn restart cmahostd"
       command.
       Everytime snmpd is retarted, following message will be added to Agents log
       file (/var/spool/compaq/cma.log):
          "Restarting snmpd. Current size = nnnK. size captured ealier = nnnK"

       Note: This memory leak had been fixed in UCD SNMP version 4.2. Compaq will
             support it after testing it with our management agents.

4.  Supported Linux Installations

    Following Linux installations are supported by this release:

    a. Red Hat Linux 6.2 Server default installation.

    b. Red Hat Linux 7.0 Server default installation plus "compat-libstdc++"
       RPM (from Red Hat CD #1). Following error message will be displayed
       during installation if "compat-libstdc++" is not installed:

            error: failed dependencies:
            	libstdc++-libc6.1-1.so.2 is needed by cmafdtn-4.90b-1

5.  Installation

    5.1 Before installation

        a. "Compaq Foundation Agents - Linux" requires following RPMs:

               UCD SNMP RPM (ucd-snmp): version 4.1.1 for Red Hat 6.2
                                        version 4.1.2 for Red Hat 7.0
               Compaq Health Driver RPM (cpqhealth) version 1.2.0

        b. The UCD snmpd Start script "snmpd" (under /etc/rc.d) should be turned on
           under one or more runlevels of 2, 3, 4 and 5. /sbin/chkconfig or other
           tools can be used. E.g. "/sbin/chkconfig --level 3 snmpd on".
           If "snmpd" is not turned on at any runlevel, the post installation script
           will automatically turn it on at default boot runlevel based on the
           /etc/inittab configuration(see "man inittab").

    5.2 Installing the Foundation Agents

        Use following command to install or upgrade Foundation Agents:

        %rpm -Uvh cmafdtn-4.90b-1.i386.rpm

        Note: Use command "%rpm -Uvh --nodeps cmafdtn-4.90b-1.i386.rpm" to install
              Foundation Agents if following message is displayed:

                  error: failed dependencies:
                          cmafdtn = 4.90 is needed by cmastor-4.90-1

    5.3 After installation

        a. SNMP configuration files ("snmpd.conf") need to be configured properly.
           An example snmpd.conf can be found at /opt/compaq/foundation/etc/snmpd.conf.cma.
           Read the comments in "snmpd.conf.cma" for more information on customization and
           installation.

        b. Compaq Management Agents will use "rocommunity" and "rwcommunity" entries
           to obtain community strings. As a minimum, localhost SNMP READ privilege is
           required.  For example,

               rocommunity YourReadStr 127.0.0.1

           Localhost SNMP WRITE(SET) privilege is required if you like to enable
           Web agent with SET capability or to perform SETs through Remote Insight
           Board. For example,

               rwcommunity YourWriteStr 127.0.0.1

           Compaq Management Agents will refer to "trapcommunity" and "trapsink" entries
           for Trap destinations and community string. For examples:

               trapcommunity defaulttrapcomm
               trapsink 127.0.0.1 mytrapcomm
               trapsink 131.168.11.2 

        c. "/usr/sbin/snmpd" need to be re-built to include Compaq Management Agents
           Extension (cmaX).

           UCD SNMP 4.1.1 is supported under Red Hat Linux 6.2 and
           UCD SNMP 4.1.2 is supported under Red Hat Linux 7.0.

           UCD SNMP source RPMs can be found on the Red Hat SRPM CD or can be downloaded
           from following URLs:

           For UCD SNMP 4.1.1:
           ftp://rpmfind.net/linux/redhat/redhat-6.2/SRPMS/i386/SRPMS/ucd-snmp-4.1.1-2.src.rpm
           Installation commands: "rpm -i ucd-snmp-4.1.1-2.src.rpm"
                               "cd /usr/src/redhat/SOURCES"
                               "tar xvzf ucd-snmp-4.1.1.tar.gz"

           For UCD SNMP 4.1.2:
           ftp://rpmfind.net/linux/redhat/redhat-7.0/SRPMS/i386/SRPMS/ucd-snmp-4.1.2-8.src.rpm
           Installation commands: "rpm -i ucd-snmp-4.1.2-8.src.rpm"
                                  "cd /usr/src/redhat/SOURCES"
                                  "tar xvzf ucd-snmp-4.1.2.tar.gz"
                                  "patch -p0 < ucd-snmp-4.1.2-rpm40.patch"

           To add cmaX to "snmpd", log in as "root" and run "/opt/compaq/foundation/etc/snmpdbld"
           script. If you wish to do the build manually, follow the instructions below:

           Note: if your snmpd also includes other extensions, you can't use "snmpdbld" script
                 and you need to include all the extensions in the "--with-mib-modules" flag
                 of "./configure" command below.

           Note: a fix for UCD SNMP's "interfaces.c" is also included in Foundation Agents RPM.
                 (This issue had been fixed in UCD SNMP 4.2)

           % SNMPVER=4.1.x  (where x is "1" or "2")
           % cd /usr/src/redhat/SOURCES/ucd-snmp-$SNMPVER
           % mv ./agent/mibgroup/mibII/interfaces.c ./agent/mibgroup/mibII/interfaces.c.orig
           % cp /opt/compaq/foundation/src/interfaces.c.$SNMPVER ./agent/mibgroup/mibII/interfaces.c
           % cp /opt/compaq/foundation/src/cmaX.[ch] ./agent/mibgroup
           % ./configure --with-mib-modules=cmaX --with-ldflags="-lpthread" --prefix=/usr
           % make
           % /etc/rc.d/init.d/snmpd stop
           % mv /usr/sbin/snmpd /usr/sbin/snmpd.orig
           % cp ./agent/snmpd /usr/sbin/snmpd
           % /etc/rc.d/init.d/snmpd start

        d. Manually start the Foundation agents

           % /etc/rc.d/init.d/cmafdtn start


        e. Optionally, install other Compaq Management Agents for Servers packages

           Compaq Server Agents - Linux (cmasvr) Version 4.90
           Compaq Storage Agents - Linux (cmastor) Version 4.90
           Compaq NIC Agents - Linux (cmanic) Version 4.90

           Note: Use command "%rpm -ivh --nodeps cmastor-4.90-1.i386.rpm" to install
                 Storage Agents if following message is displayed:

                     error: failed dependencies:
                             cmafdtn = 4.90 is needed by cmastor-4.90-1

6.  New Features

    Fixed a potential security issue in Web agent.

7.  Supported Products

The "Compaq Foundation Agents - Linux" has been tested on the
following Compaq Products:

   Compaq Proliant DL320
   Compaq Proliant DL360
   Compaq Proliant DL380
   Compaq Proliant DL580
   Compaq Proliant ML330
   Compaq Proliant ML350
   Compaq Proliant ML370
   Compaq Proliant ML530
   Compaq Proliant ML570

Use of this software on equipment not specifically tested by Compaq may
produce unreliable or undesirable results.  Compaq does not warrant the
fitness or compatibility of this software on untested hardware.


------------------------------------------------------------------------
Copyright 2000-2001 Compaq Computer Corporation. All rights reserved.

Product names mentioned herein may be trademarks and/or registered
trademarks of their respective companies.
