    
         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 Server Agents - Linux

                              Version 4.90
                            November 7, 2000

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

1.  Introduction

2.  Documentation Updates and Corrections

3.  Known Issues

4.  Installation
    4.1  Before installation
    4.2  Installing the Server Agents
    4.3  Afert installation

5.  New Features

6.  Supported Products


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


1.  Introduction

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

2.  Documentation Updates and Corrections
This section contains information on known errors and omissions in the
"Compaq Management Agents - Linux" User Guide.  The information in 
this section is more up-to-date than that in the User Guide.


3.  Known Issues

    3.1 The cmasm2d RILO agent does not report the RILO IP address,
        IP mask and IP Gateway information correctly.

    3.2 There are updates to the cmastdeqd agent that are required for
        the newer DL and ML SMBIOS servers in order to report the following
        MIBs correctly:
         3.2.1 cpqSiSecurity MIBs - This can be correctly viewed in F10 Setup
                1) 1.3.6.1.4.1.232.2.2.3.1 
                2) 1.3.6.1.4.1.232.2.2.3.2 
                3) 1.3.6.1.4.1.232.2.2.3.3 
                4) 1.3.6.1.4.1.232.2.2.3.4 
                5) 1.3.6.1.4.1.232.2.2.3.5 
                6) 1.3.6.1.4.1.232.2.2.3.6 
                7) 1.3.6.1.4.1.232.2.2.3.7 
                8) 1.3.6.1.4.1.232.2.2.3.8 
                9) 1.3.6.1.4.1.232.2.2.3.9 
               10) 1.3.6.1.4.1.232.2.2.3.10 
               11) 1.3.6.1.4.1.232.2.2.3.11
               12) 1.3.6.1.4.1.232.2.2.3.12
               13) 1.3.6.1.4.1.232.2.2.3.13
               14) 1.3.6.1.4.1.232.2.2.3.14
         3.2.2 cpqHeIRC MIB - Integrated Remot Console status
                1) 1.3.6.1.4.1.232.6.2.1.0.1

      3.3 For those systems with Remote Insight Board installed, ignore the
          following message in the Agents log file (/var/spool/compaq/cma.log):
          "do_snmp_trap: send trap over Remote Insight Board failed."

4.  Installation

    4.1 Before installation

        1) "Compaq Server Agents - Linux" requires following RPMs:

               UCD SNMP RPM (ucd-snmp): version 4.1.1 for Redhat 6.2
                                        version 4.1.2 for Redhat 7.0
               Compaq Foundation Agent (cmafdtn-4.9.0-1.i386.rpm)
               Compaq Health Driver RPM (cpqhealth) version 1.1.2
               Compaq RILO Driver RPM (crid) version 1.0.0

        2) 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
           /etc/inittab configuration(see "man inittab").

    4.2 Installing the Server Agents

        Use following command to install Server Agents:

        %rpm -Uvh cmasvr-4.90-1.i386.rpm

    4.3 After installation

        a. SNMP configuration files ("snmpd.conf") need to be configured properly.
           An example snmpd.conf can be found as /opt/compaq/foundation/src/snmpd.conf.cma.

        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).

           Log in as "root".

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

           You can down load and install the UCD SNMP source RPM from following URLs:
           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"

           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"

           % cd /usr/src/redhat/SOURCES/ucd-snmp-4.1.x  (where x is "1" or "2")
           % mv ./agent/mibgroup/mibII/interfaces.c ./agent/mibgroup/mibII/interfaces.c.orig
           % cp /opt/compaq/foundation/src/interfaces.c.4.1.x ./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

           Note: if your snmpd also include other extensions, you need to include all
                 the extensions in the "--with-mib-modules" flag of "./configure"
                 command above.

        c. Manually start the Server agents

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


        d. Install other Compaq Management Agents for Servers packages (if any).

           Compaq Storage Agents - Linux   (cmastor)
           Compaq Nic Agents - Linux       (cmanic)

5.  New Features

    This is the initial release.

6.  Supported Products

The "Compaq Server 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 Compaq Computer Corporation. All rights reserved.

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