FILE NAME: cmafdtn-5.40.0-14.i386.rpm TITLE: Compaq Foundation Agents for Servers - Linux VERSION: 5.40.0-14 LANGUAGE: English CATEGORY: Management Agents DIVISIONS: Systems PRODUCTS AFFECTED: Compaq ProLiant DL320 Compaq ProLiant DL360 Compaq ProLiant DL360 G2 Compaq ProLiant DL380 Compaq ProLiant DL380 G2 Compaq ProLiant DL580 Compaq ProLiant DL580 G2 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 ML530 G2 Compaq ProLiant ML570 Compaq ProLiant ML570 G2 Compaq ProLiant ML750 Compaq ProLiant BL10e Compaq ProLiant BL20e (?) OPERATING SYSTEM: Red Hat Linux 7.2 Professional SuSE Linux Enterprise Server 7 (SLES-7) PREREQUISITES: Compaq Health & Wellness Driver ("cpqhealth" RPM) version 2.4.0 UCD SNMP RPMs must be installed before installing the Foundation Agents for Linux. EFFECTIVE DATE: April 25, 2002 SUPERSEDES: cmafdtn-5.30-8.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.2 Professional Server default installation. 2. Suse Linux Enterprise Server 7 (SLES-7) installation. ENHANCEMENTS/FIXES: 1. Added UCD SNMP RPMs from Compaq. 2. Added agents and snmpd configurations during RPM installation. HOW TO USE: 1. Download the cmafdtn-5.40.0-14.i386.rpm and cmafdtn-5.40.0-14.i386.txt to a directory on your hard drive and change to that directory. 2. Refer to the README section in cmafdtn-5.40.0-14.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.40.0-14.i386.txt for additional information. Copyright 2000-2002, 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.40.0 April 25, 2002 ------------------------------------------------------------------------ 1. Introduction 2. Documentation Updates and Corrections 3. Known Issues 4. Supported Linux Installations 5. Installing Foundation Agents for Red Hat Linux 7.2 5.1 Before Installation - Red Hat Linux 7.2 5.2 Installing UCD SNMP RPMs and all agents RPMs - Red Hat Linux 7.2 5.3 Installing UCD SNMP RPMs from Compaq - Red Hat Linux 7.2 5.3.1 Installing from Compaq Management CD version 5.40 5.3.2 Installing from RPMs 5.4 Installing Foundation Agents - Red Hat Linux 7.2 5.4.1 Installing from Compaq Management CD version 5.40 5.4.2 Installing from RPM 5.5 Post-Installation Configurations - Red Hat 7.2 6. Installing Foundation Agents for SuSE Linux Enterprises Server 7 (SLES-7) 6.1 Before Installation - SLES-7 6.2 Installing UCD SNMP RPM and all agents RPMs - SLES-7 6.3 Installing UCD SNMP RPMs from Compaq - SLES-7 6.3.1 Installing from Compaq Management CD version 5.40 6.3.2 Installing from RPMs 6.4 Installing Foundation Agents - SLES-7 6.4.1 Installing from Compaq Management CD version 5.40 6.4.2 Installing from RPM 6.5 Post-Installation Configurations - SLES-7 7. Removing Agents RPMs 8. New Features and Fixes 9. 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.2 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.2 Server default installation plus "ucd-snmp" and "ucd-snmp-utils" RPMs from Compaq. Note: If default "High" or "Medium" firewall configuration was selected during the installation of Red Hat Linux 7.2 . 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.2. b. SuSE Linux Enterprise Server 7 (SLES-7) installations plus "ucdsnmp" RPM from Compaq. 5. Installing Foundation Agents for Red Hat Linux 7.2 5.1 Before Installation - Red Hat Linux 7.2 a. "Compaq Foundation Agents - Linux" requires following binary RPMs: Compaq Health And Wellness Driver RPM: Version 2.4.0 (cpqhealth-2.4.0-x.Redhat7_2.i386.rpm) Available from http://www.compaq.com/support/files/server/us/index.html. UCD SNMP RPMs from Compaq: Version 4.2.3-1.7.2.3cmaX.x of ucd-snmp and ucd-snmp-utils RPMs. Available from Compaq Management CD version 5.40: /mnt/cdrom/agents/linux/eng/compaq/ucdsnmp/rh72/snmp.rpm /mnt/cdrom/agents/linux/eng/compaq/ucdsnmp/rh72/snmputil.rpm Also available from http://www.compaq.com/support/files/server/us/index.html: ucd-snmp-4.2.3-1.7.2.3cmaX.x.i386.rpm ucd-snmp-utils-4.2.3-1.7.2.3cmaX.x.i386.rpm Note: x is an integer which is part of the "release" number. 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 UCD SNMP RPMs and all agents RPMs - Red Hat Linux 7.2 With Management CD version 5.40, UCD SNMP RPMs (ucd-snmp and ucd-snmp-utils) and all four agents RPMs can be installed with one convenient command. a. Insert Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount Compaq Management CD at directory /mnt/cdrom using following command: #mount /dev/cdrom c. Install UCD SNMP RPMs and all agents RPMs using following command: #sh /mnt/cdrom/agents/linux/eng/compaq/install 5.3 Installing UCD SNMP RPMs from Compaq - Red Hat Linux 7.2 5.3.1 Installing from Compaq Management CD version 5.40 a. Insert Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount Compaq Management CD at directory /mnt/cdrom using following command: #mount /dev/cdrom c. Install UCD SNMP RPMs using following command: #rpm -Uvh /mnt/cdrom/agents/linux/eng/compaq/ucdsnmp/rh72/snmp.rpm \ /mnt/cdrom/agents/linux/eng/compaq/ucdsnmp/rh72/snmputil.rpm d. Un-mount the Compaq Management CD: #cd / #umount /dev/cdrom e. Remove the Compaq Management CD from CD-ROM drive. 5.3.2 Installing from RPMs Download "ucd-snmp-4.2.3-1.7.2.3cmaX.x.i386.rpm" and "ucd-snmp-utils-4.2.3-1.7.2.3cmaX.x.i386.rpm" from http://www.compaq.com/support/files/server/us/index.html. Log in as "root", then use following command to install downloaded RPMs: #rpm -Uvh ucd-snmp-4.2.3-1.7.2.3cmaX.x.i386.rpm \ ucd-snmp-utils-4.2.3-1.7.2.3cmaX.x.i386.rpm Note: x is an integer which is part of the "release" number. 5.4 Installing Foundation Agents - Red Hat Linux 7.2 During the Foundation Agents RPM installation, the post installation script will try to complete the snmpd and agents configurations. The script will prompt user for the values of those missing configuration parameters. Some parameters are optional so they can be skipped with no (blank) input. When environment variable "CMAFDTNSILENT" is set to "yes" and is exported prior to the installation, the installation script will NOT prompt user for input. In this situation, only minimum configuration will be performed. Minimum configuration includes "Read/Write SNMP Community String for Localhost" only. No action will be taken if the system already contains minimum configuration. Otherwise, a "random" community string will be generated, based on the data collected on the server being installed, and used for minimum configuration. A message, containing snmpd.conf filename and "random" community string, will be displayed. "random" community string can be changed later. If "snmpd" is running at the time of installation, it will be restarted. 5.4.1 Installing from Compaq Management CD version 5.40 a. Insert Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount Compaq Management CD at directory /mnt/cdrom using following command: #mount /dev/cdrom c. Optionally, set and export "CMAFDTNSILENT" environment variable: #export CMAFDTNSILENT=yes d. Install Compaq Foundation Agent RPM using following commands: #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.2 Installing from RPM Download "cmafdtn-5.40.0-x.i386.rpm" from http://www.compaq.com/support/files/server/us/index.html. Log in as "root", then use following command to install downloaded RPM: #rpm -Uvh cmafdtn-5.40.0-x.i386.rpm Note: x is the "release" number. 5.5 Post-Installation Configurations - Red Hat 7.2 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 "/etc/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. (Note: this is the Minimum configuratin that is performed during RPM installation) 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. Start the Foundation agents # /etc/init.d/cmafdtn start If "snmpd" is not running, start it with following command: # /etc/init.d/snmpd 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. Installing Foundation Agents for SuSE Linux Enterprises Server 7 (SLES-7) 6.1 Before Installation - SLES-7 a. "Compaq Foundation Agents - Linux" requires following binary RPMs: Compaq Health And Wellness Driver RPM: Version 2.4.0 (cpqhealth-2.4.0-x.SLES7.i386.rpm) Available from http://www.compaq.com/support/files/server/us/index.html. UCD SNMP RPMs from Compaq: Version 4.2.3-57cmaX.x of ucdsnmp RPM. Available from Compaq Management CD version 5.40: /cdrom/agents/linux/eng/compaq/ucdsnmp/sles7/snmp.rpm Also available from http://www.compaq.com/support/files/server/us/index.html: ucdsnmp-4.2.3-57cmaX.x.i386.rpm 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"). 6.2 Installing UCD SNMP RPM and all agents RPMs - SLES-7 With Management CD version 5.40, UCD SNMP RPM (ucdsnmp) and all four agents RPMs can be installed with one convenient command. a. Insert Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount Compaq Management CD at directory /cdrom using following command: #mount /dev/cdrom c. Install UCD SNMP RPMs and all agents RPMs using following command: #sh /cdrom/agents/linux/eng/compaq/install 6.3 Installing UCD SNMP RPMs from Compaq - SLES-7 6.3.1 Installing from Compaq Management CD version 5.40 a. Insert Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount Compaq Management CD at directory /cdrom using following command: #mount /dev/cdrom c. Install UCD SNMP RPM using following commands: #rpm -Uvh /cdrom/agents/linux/eng/compaq/ucdsnmp/sles7/snmp.rpm d. Un-mount the Compaq Management CD: #cd / #umount /dev/cdrom e. Remove the Compaq Management CD from CD-ROM drive. 6.3.2 Installing from RPMs Download "ucdsnmp-4.2.3-57cmaX.x.i386.rpm" from http://www.compaq.com/support/files/server/us/index.html. Log in as "root", then use following command to install downloaded RPMs: #rpm -Uvh ucdsnmp-4.2.3-57cmaX.x.i386.rpm 6.4 Installing Foundation Agents - SLES-7 During the Foundation Agents RPM installation, the post installation script will try to complete the snmpd and agents configurations. The script will prompt user for the values of those missing configuration parameters. Some parameters are optional so they can be skipped with no (blank) input. When environment variable "CMAFDTNSILENT" is set to "yes" and is exported prior to the installation, the installation script will NOT prompt user for input. In this situation, only minimum configuration will be performed. Minimum configuration includes "Read/Write SNMP Community String for Localhost" only. No action will be taken if the system already contains minimum configuration. Otherwise, a "random" community string will be generated, based on the data collected on the server being installed, and used for minimum configuration. A message, containing snmpd.conf filename and "random" community string, will be displayed. "random" community string can be changed later. If "snmpd" is running at the time of installation, it will be restarted. 6.4.1 Installing from Compaq Management CD version 5.40 a. Insert Compaq Management CD into CD-ROM drive and log in as "root" user. b. Mount Compaq Management CD at directory /cdrom using following command: #mount /dev/cdrom c. Optionally, set and export "CMAFDTNSILENT" environment variable: #export CMAFDTNSILENT=yes d. Install Compaq Foundation Agent RPM using following commands: #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. 6.4.2 Installing from RPM Download "cmafdtn-5.40.0-x.i386.rpm" from http://www.compaq.com/support/files/server/us/index.html. Log in as "root", then use following command to install downloaded RPM: #rpm -Uvh cmafdtn-5.40.0-x.i386.rpm Note: x is the "release" number. 6.5 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 listed 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. (Note: this is the Minimum configuratin that is performed during RPM installation) 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. Start the Foundation agents # /etc/init.d/cmafdtn start If "snmpd" is not running, start it with following command: # /etc/init.d/snmpd 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) 7. 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. 8. New Features and Fixes Added UCD SNMP RPMs from Compaq. Added agents and snmpd configurations during RPM installation. 9. Supported Products The "Compaq Foundation Agents - Linux" has been tested on the following Compaq Products: Compaq ProLiant BL10e Compaq ProLiant BL20e Compaq ProLiant DL320 Compaq ProLiant DL360 Compaq ProLiant DL360 G2 Compaq ProLiant DL380 Compaq ProLiant DL380 G2 Compaq ProLiant DL580 Compaq ProLiant DL580 G2 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 ML530 G2 Compaq ProLiant ML570 Compaq ProLiant ML570 G2 Compaq ProLiant ML750 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-2002 Compaq Computer Corporation. All rights reserved. Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.