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.90 December 11, 2000 ------------------------------------------------------------------------ 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 caused 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. Every time snmpd is restarted, the following message will be added to Agents log file (/var/spool/compaq/cma.log): "Restarting snmpd. Current size = nnnK. size captured earlier = 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. b. While viewing the Web agent, AutoRefresh feature does not function properly for NetScape browser running under Linux. AutoRefresh does work for browsers running under Windows. 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.90-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 Foundation Agents: %rpm -Uvh cmafdtn-4.90-1.i386.rpm 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. Compaq will provide the fix back to UCD SNMP development team. % 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 c. Manually start the Foundation agents % /etc/rc.d/init.d/cmafdtn start d. Optionally, install other Compaq Management Agents for Servers packages Compaq Server Agents - Linux (cmasvr) Compaq Storage Agents - Linux (cmastor) Compaq NIC Agents - Linux (cmanic) 6. New Features This is the initial release. 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 Compaq Computer Corporation. All rights reserved. Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.