FILE NAME: cmafdtn-5.30.0-8.i386.rpm TITLE: Compaq Foundation Agents for Servers - Linux VERSION: 5.30.0-8 LANGUAGE: English CATEGORY: Management Agents DIVISIONS: Systems PRODUCTS AFFECTED: Compaq ProLiant 8000 Compaq ProLiant 8500 Compaq ProLiant DL320 Compaq ProLiant DL360 Compaq ProLiant DL360 G2 Compaq ProLiant DL380 Compaq ProLiant DL380 G2 Compaq ProLiant DL580 Compaq ProLiant DL760 Compaq ProLiant ML330 Compaq ProLiant ML330e Compaq ProLiant ML330 G2 Compaq ProLiant ML350 Compaq ProLiant ML350 G2 Compaq ProLiant ML370 Compaq ProLiant ML370 G2 Compaq ProLiant ML530 Compaq ProLiant ML570 Compaq ProLiant ML750 Compaq ProLiant BL10e OPERATING SYSTEM: Red Hat Linux 7.1 Red Hat Linux 7.2 Professional SuSE Linux Enterprise Server 7 (SLES-7) PREREQUISITES: Compaq Health & Wellness Driver ("cpqhealth" RPM) version 2.3.0 UCD SNMP RPMs must be installed before installing the Foundation Agents for Linux. EFFECTIVE DATE: December 7, 2001 SUPERSEDES: cmafdtn-5.20-1.i386.rpm DESCRIPTION: This RPM Package Manager (RPM) package contains the Compaq Foundation Agents for Linux. SUPPORTED FEATURES & DEVICES: The following Linux Installations are supported by this release: 1. Red Hat Linux 7.1 Server default installation. 2. Red Hat Linux 7.2 Professional Server default installation. 4. Suse Linux Enterprise Server 7 (SLES-7) installation. ENHANCEMENTS/FIXES: 1. Added support for Red Hat Linux 7.2 Professional. 2. Added support for SuSE Linux Enterprise Server 7 (SLES-7). HOW TO USE: 1. Download the cmafdtn-5.30.0-8.i386.rpm and cmafdtn-5.30.0-8.i386.txt to a directory on your hard drive and change to that directory. 2. Refer to the README section in cmafdtn-5.30.0-8.i386.txt for installation and configuration instructions. 3. After the RPM is installed, you may delete the previously downloaded RPM file. 4. Refer to the README section in cmafdtn-5.30.0-8.i386.txt for additional information. Copyright 2000-2001, Compaq Computer Corporation. All rights reserved. Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies ==================================README================================== 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 5.30.0 December 7, 2001 ------------------------------------------------------------------------ 1. Introduction 2. Documentation Updates and Corrections 3. Known Issues 4. Supported Linux Installations 5. Installing Foundation Agents for Red Hat Linux 7.1 5.1 Before Installation - Red Hat Linux 7.1 5.2 Installing Foundation Agents from RPM - Red Hat Linux 7.1 5.3 Installing Foundation Agents from Compaq Management CD - Red Hat Linux 7.1 5.4 Post-Installation Configurations - Red Hat 7.1 6. Installing Foundation Agents for Red Hat Linux 7.2 Professional 6.1 Before Installation - Red Hat Linux 7.2 Professional 6.2 Installing Foundation Agents from RPM - Red Hat Linux 7.2 Professional 6.3 Installing Foundation Agents from Compaq Management CD - Red Hat Linux 7.2 Professional 6.4 Post-Installation Configurations - Red Hat 7.2 Professional 7. Installing Foundation Agents for SuSE Linux Enterprise Server 7 (SLES-7) 7.1 Before Installation - SLES-7 7.2 Installing Foundation Agents from RPM - SLES-7 7.3 Installing Foundation Agents from Compaq Management CD - SLES-7 7.4 Post-Installation Configurations - SLES-7 8. Removing Agents RPMs 9. New Features and Fixes 10. 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 7.1, Red Hat Linux 7.2 Professional and SuSE Linux Enterprise Server 7 (SLES-7). 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. While viewing the Web agent, AutoRefresh feature does not function properly for NetScape browsers 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 7.1 Server default installation. b. Red Hat Linux 7.2 Professional Server default installation. Note: If default "High" or "Medium" firewall configuration was selected during the installation of Red Hat Linux 7.1/7.2, Professional external SNMP requests will be "REJECTED" by the system and the server will become unmanageable. There are significant security implications to configuring firewall and the ipfw(4), ipchains(8), ipchains-save(8) and ipchains-restore(8) manpages should be regarded as mandatory reading before making any change to firewall configuration. The system should start "ACCEPT"ing SNMP requests (e.g. from CIM or other management consoles) with following command: #ipchains -I input -s 16.101.168.68/255.255.255.255 \ -d 16.101.169.69/255.255.255.255 161:161 \ -i eth0 -p udp -j ACCEPT Where 1. "16.101.168.68" is the IP Address of remote system running management console (or issuing SNMP requests) 2. "16.101.169.69" is the IP Address of the interface "eth0" of the server running Red Hat Linux 7.1/7.2 Professional. c. SuSE Linux Enterprise Server 7 (SLES-7) installations plus "ucdsnmp" RPMs. 5. Installing Foundation Agents for Red Hat Linux 7.1 5.1 Before Installation - Red Hat Linux 7.1 a. "Compaq Foundation Agents - Linux" requires following binary RPMs: UCD SNMP RPM: Version 4.2 (ucd-snmp-4.2-12.i386.rpm) Available from Red Hat Linux 7.1 CD #1. Compaq Health And Wellness Driver RPM: Version 2.3.0 (cpqhealth-2.3.0-X.Redhat7_1.i386.rpm) Available from http://www.compaq.com/support/files/server/us/index.html. b. The UCD snmpd Start script "/etc/init.d/snmpd" should be turned on under one or more runlevels of 2, 3, 4 and 5. /sbin/chkconfig tool can be used. E.g. "/sbin/chkconfig --level 3 snmpd on". If "snmpd" is not turned on at any runlevel, the Foundation Agents RPM post installation script will automatically turn it on at default boot runlevel based on the /etc/inittab configuration (see "man inittab"). 5.2 Installing Foundation Agents from RPM - Red Hat Linux 7.1 Log in as "root", then use following command to install Foundation Agents from RPM: #rpm -Uvh cmafdtn-5.30.0-X.i386.rpm 5.3 Installing Foundation Agents from Compaq Management CD - Red Hat Linux 7.1 a. Insert the Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount the Compaq Management CD at the directory /mnt/cdrom using following command: #mount /dev/cdrom c. Install Foundation Agents using following command: #rpm -Uvh /mnt/cdrom/agents/linux/eng/compaq/cmafdtn/cmafdtn.rpm d. Un-mount the Compaq Management CD: #cd / #umount /dev/cdrom e. Remove the Compaq Management CD from CD-ROM drive. 5.4 Post-Installation Configurations - Red Hat 7.1 Note: There are significant security implications to configuring "snmpd.conf", and the snmp_config(5) and snmpd.conf(5) manpages should be regarded as mandatory reading before proceeding. 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. Please note that "/usr/share/snmp/snmpd.conf" is the first configuration file to be read by "snmpd". b. Compaq Management Agents will use "rocommunity" and "rwcommunity" entries to obtain community strings. At 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" needs to be re-built to include Compaq Management Agents eXtension (cmaX). UCD SNMP 4.2 (ucd-snmp-4.2-12) is supported under Red Hat Linux 7.1. UCD SNMP "SOURCE" RPMs can be found on the Red Hat Linux 7.1 CD #2 (SRPM CD). Source RPM installation instructions: (Insert Red Hat Linux 7.1 CD #2 (SRPM CD) into CDROM drive) #mount /dev/cdrom #rpm -i /mnt/cdrom/SRPMS/ucd-snmp-4.2-12.src.rpm #umount /dev/cdrom (Remove Red Hat Linux 7.1 CD #2 (SRPM CD) from CDROM drive) To add Compaq Management Agents eXtension (cmaX) to "snmpd", log in as "root" and run "/opt/compaq/foundation/etc/snmpdbld" script (recommended): #/opt/compaq/foundation/etc/snmpdbld or, if you wish to build snmpd 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" commands below. Commands for adding cmaX manually under Red Hat Linux 7.1: # SNMPVER=4.2 # rpm -bp /usr/src/redhat/SPECS/ucd-snmp.spec # cd /usr/src/redhat/BUILD/ucd-snmp-$SNMPVER # cp /opt/compaq/foundation/src/cmaX.[ch] ./agent/mibgroup # ./configure --disable-shared --with-mib-modules=cmaX \ --with-ldflags="-lpthread" --prefix=/usr # make # /etc/init.d/snmpd stop # mv /usr/sbin/snmpd /usr/sbin/snmpd.orig # cp ./agent/snmpd /usr/sbin/snmpd # /etc/init.d/snmpd start d. Start the Foundation agents # /etc/init.d/cmafdtn start If "snmpd" is not running, start it with following command: # /etc/init.d/snmpd start e. 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. Installing Foundation Agents for Red Hat Linux 7.2 Professional 6.1 Before Installation - Red Hat Linux 7.2 Professional a. "Compaq Foundation Agents - Linux" requires following binary RPMs: UCD SNMP RPM: Version 4.2.1 (ucd-snmp-4.2.1-7.i386.rpm) Available from Red Hat Linux 7.2 Professional CD #1. Compaq Health And Wellness Driver RPM: Version 2.3.0 (cpqhealth-2.3.0-X.Redhat7_2.i386.rpm) Available from http://www.compaq.com/support/files/server/us/index.html. b. The UCD snmpd Start script "/etc/init.d/snmpd" should be turned on under one or more runlevels of 2, 3, 4 and 5. /sbin/chkconfig tool can be used. E.g. "/sbin/chkconfig --level 3 snmpd on". If "snmpd" is not turned on at any runlevel, the Foundation Agents RPM post installation script will automatically turn it on at default boot runlevel based on the /etc/inittab configuration (see "man inittab"). 6.2 Installing Foundation Agents from RPM - Red Hat Linux 7.2 Professional Log in as "root", then use following command to install Foundation Agents from RPM: #rpm -Uvh cmafdtn-5.30.0-X.i386.rpm 6.3 Installing Foundation Agents from Compaq Management CD - Red Hat Linux 7.2 Professional a. Insert the Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount the Compaq Management CD at the directory /mnt/cdrom using following command: #mount /dev/cdrom c. Install Foundation Agents using following command: #rpm -Uvh /mnt/cdrom/agents/linux/eng/compaq/cmafdtn/cmafdtn.rpm d. Un-mount the Compaq Management CD: #cd / #umount /dev/cdrom e. Remove the Compaq Management CD from CD-ROM drive. 6.4 Post-Installation Configurations - Red Hat 7.2 Professional Note: There are significant security implications to configuring "snmpd.conf", and the snmp_config(5) and snmpd.conf(5) manpages should be regarded as mandatory reading before proceeding. 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. Please note that "/usr/share/snmp/snmpd.conf" is the first configuration file to be read by "snmpd". b. Compaq Management Agents will use "rocommunity" and "rwcommunity" entries to obtain community strings. At 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" needs to be re-built to include Compaq Management Agents eXtension (cmaX). UCD SNMP 4.2.1 (ucd-snmp-4.2.1-7) is supported under Red Hat Linux 7.2 Professional. UCD SNMP "SOURCE" RPMs can be found on the Red Hat Linux 7.2 Professional CD #4. Source RPM installation instructions: (Insert Red Hat Linux 7.2 Professional CD #4 into CDROM drive) #mount /dev/cdrom #rpm -i /mnt/cdrom/SRPMS/ucd-snmp-4.2.1-7.src.rpm #umount /dev/cdrom (Remove Red Hat Linux 7.2 Professional CD #4 from CDROM drive) To add Compaq Management Agents eXtension (cmaX) to "snmpd", log in as "root" and run "/opt/compaq/foundation/etc/snmpdbld" script (recommended): #/opt/compaq/foundation/etc/snmpdbld or, if you wish to build snmpd 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" commands below. Commands for adding cmaX manually under Red Hat Linux 7.2 Professional: # SNMPVER=4.2.1 # rpm -bp /usr/src/redhat/SPECS/ucd-snmp.spec # cd /usr/src/redhat/BUILD/ucd-snmp-$SNMPVER # cp /opt/compaq/foundation/src/cmaX.[ch] ./agent/mibgroup # ./configure --disable-shared --with-mib-modules=cmaX \ --with-ldflags="-lpthread" --prefix=/usr # make # /etc/init.d/snmpd stop # mv /usr/sbin/snmpd /usr/sbin/snmpd.orig # cp ./agent/snmpd /usr/sbin/snmpd # /etc/init.d/snmpd start d. Start the Foundation agents # /etc/init.d/cmafdtn start If "snmpd" is not running, start it with following command: # /etc/init.d/snmpd start e. Optionally, install other Compaq Management Agents for Servers packages Compaq Server Agents - Linux (cmasvr) Compaq Storage Agents - Linux (cmastor) Compaq NIC Agents - Linux (cmanic) 7. Installing Foundation Agents for SuSE Linux Enterprises Server 7 (SLES-7) 7.1 Before Installation - SLES-7 a. "Compaq Foundation Agents - Linux" requires following binary RPMs: UCD SNMP RPM: Version 4.2.1 (ucdsnmp-4.2.1-47.i386.rpm) Available from SuSE SLES-7 CD #1. Compaq Health And Wellness Driver RPM: Version 2.3.0 (cpqhealth-2.3.0-X.SLES7.i386.rpm) Available from http://www.compaq.com/support/files/server/us/index.html. b. The UCD snmpd Start script "/etc/init.d/snmpd" should be turned on under one or more runlevels of 2, 3, 4 and 5. If "snmpd" is not turned on at any runlevel, the Foundation Agents RPM post installation script will automatically turn it on at default boot runlevel based on the /etc/inittab configuration (see "man inittab"). NOTE: For SuSE SLES-7 with ucdsnmp-4.2.1, the snmpd is NOT configured to start automatically during boot by default. The automatic startup of snmpd can be turned on by editing /etc/rc.config and changing the value of "START_SNMPD" to "yes". The Foundation Agents RPM installation script will turn on the snmpd automatic startup if it had not been done so. 7.2 Installing Foundation Agents from RPM - SLES-7 Log in as "root", then use following command to install Foundation Agents from RPM: #rpm -Uvh cmafdtn-5.30.0-X.i386.rpm 7.3 Installing Foundation Agents from Compaq Management CD - SLES-7 a. Insert the Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount the Compaq Management CD at the directory /cdrom using following command: #mount /dev/cdrom c. Install Foundation Agents using following command: #rpm -Uvh /cdrom/agents/linux/eng/compaq/cmafdtn/cmafdtn.rpm d. Un-mount the Compaq Management CD: #cd / #umount /dev/cdrom e. Remove the Compaq Management CD from CD-ROM drive. 7.4 Post-Installation Configurations - SLES-7 Note: There are significant security implications to configuring "snmpd.conf", and the snmp_config(5) and snmpd.conf(5) manpages should be regarded as mandatory reading before proceeding. 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. Please note that "/usr/share/snmp/snmpd.conf" is the first configuration file to be read by "snmpd". NOTE: For SuSE SLES-7, the /etc/init.d/snmpd will start "snmpd" with following flags: "-c /etc/ucdsnmpd.conf -f -L -A" We recommend that you edit the /etc/init.d/snmpd and remove all flags above. Read "snmpd", "snmp_config" and "snmpd.conf" manpages before making the changes. b. Compaq Management Agents will use "rocommunity" and "rwcommunity" entries to obtain community strings. At 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" needs to be re-built to include Compaq Management Agents eXtension (cmaX). UCD SNMP 4.2.1 (ucdsnmp-4.2.1-47) is supported under SuSE SLES-7. UCD SNMP "SOURCE" RPMs can be found on the SuSE SLES-7 CD #2. Source RPM installation instructions: (Insert SuSE SLES-7 CD #2 into CDROM drive) #mount /dev/cdrom #rpm -i /cdrom/full-names/src/ucdsnmp-4.2.1-47.src.rpm #umount /dev/cdrom (Remove SuSE SLES-7 CD #2 from CDROM drive) To add Compaq Management Agents eXtension (cmaX) to "snmpd", log in as "root" and run "/opt/compaq/foundation/etc/snmpdbld" script (recommended): #/opt/compaq/foundation/etc/snmpdbld or, if you wish to build snmpd 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" commands below. Commands for adding cmaX manually under SuSE SLES-7: # SNMPVER=4.2.1 # rpm -bp /usr/src/packages/SPECS/ucdsnmp.spec # cd /usr/src/packages/BUILD/ucd-snmp-$SNMPVER # cp /opt/compaq/foundation/src/cmaX.[ch] ./agent/mibgroup # ./configure --disable-shared --with-mib-modules=cmaX \ --with-ldflags="-lpthread" --prefix=/usr # make # /etc/init.d/snmpd stop # mv /usr/sbin/snmpd /usr/sbin/snmpd.orig # cp ./agent/snmpd /usr/sbin/snmpd # /etc/init.d/snmpd start d. Start the Foundation agents # /etc/init.d/cmafdtn start If "snmpd" is not running, start it with following command: # /etc/init.d/snmpd start e. Optionally, install other Compaq Management Agents for Servers packages Compaq Server Agents - Linux (cmasvr) Compaq Storage Agents - Linux (cmastor) Compaq NIC Agents - Linux (cmanic) 8. Removing Agents RPMs All Compaq Management Agents RPMs can be removed at the same time using following command: # rpm -e cmafdtn cmasvr cmastor cmanic Note: cmasvr, cmastor and cmanic can be removed individually while cmafdtn can be removed only when all other agents were removed. 9. New Features and Fixes Added support for Red Hat Linux 7.2 Professional. Added support for SuSE Linux Enterprise Server 7 (SLES-7). 10. Supported Products The "Compaq Foundation Agents - Linux" has been tested on the following Compaq Products: Compaq ProLiant 8000 Compaq ProLiant 8500 Compaq ProLiant DL320 Compaq ProLiant DL360 Compaq ProLiant DL360 G2 Compaq ProLiant DL380 Compaq ProLiant DL380 G2 Compaq ProLiant DL580 Compaq ProLiant DL760 Compaq ProLiant ML330 Compaq ProLiant ML330e Compaq ProLiant ML330 G2 Compaq ProLiant ML350 Compaq ProLiant ML350 G2 Compaq ProLiant ML370 Compaq ProLiant ML370 G2 Compaq ProLiant ML530 Compaq ProLiant ML570 Compaq ProLiant ML750 Compaq ProLiant BL10e 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.