FILE NAME: cmanic-5.30.0-3.i386.rpm TITLE: Compaq NIC Agents for Servers - Linux VERSION: 5.30.0 LANGUAGE: English CATEGORY: Management Agents DIVISIONS: Systems PRODUCTS AFFECTED: Compaq ProLiant 8000 Compaq ProLiant 8500 Compaq ProLiant DL 320 Compaq ProLiant DL 360 Compaq ProLiant DL 380 Compaq ProLiant DL 380 G2 Compaq ProLiant DL 580 Compaq ProLiant DL 760 Compaq ProLiant ML 330 Compaq ProLiant ML 330e Compaq ProLiant ML 350 Compaq ProLiant ML 350 1 GHz Compaq ProLiant ML 370 Compaq ProLiant ML 370 G2 Compaq ProLiant ML 530 Compaq ProLiant ML 570 Compaq ProLiant ML 750 OPERATING SYSTEM: Red Hat Linux 7.1 Red Hat Linux 7.2 SuSE Linux Enterprise Server 7 PREREQUISITES: Compaq Foundation Agents for Linux version 5.30.0-x must be installed before installing the Compaq NIC Agents for Linux. EFFECTIVE DATE: December 7, 2001 SUPERSEDES: cmanic-5.20-1.i386.rpm DESCRIPTION: This RPM (RPM Package Manager) package contains the Compaq NIC Agents for Linux. ENHANCEMENTS/FIXES: Added support for SuSE Linux Enterprise Server 7 Added support for cpqNicIfLogMapSpeed and cpqNicIfPhysAdapterPartNumber MIB objects Changed format of cpqNicConnectivityRestored and cpqNicConnectivityLost SNMP traps to cpqNic2ConnectivityRestored and cpqNic2ConnectivityLost format HOW TO USE: 1. Download the cmanic-5.30.0-3.i386.rpm and cmanic-5.30.0-3.i386.txt to a directory on your hard drive and change to that directory. 2. Refer to the cmanic-5.30.0-3.i386.txt file for installation and configuration instructions. 3. After the RPM is installed, you may delete the previously downloaded RPM file. 4. Refer to the cmanic-5.30.0-3.i386.txt file 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 NIC Agents - Linux Version 5.30.0 December 7, 2001 ------------------------------------------------------------------------ 1. Introduction 2. Documentation Updates and Corrections 3. Known Issues 4. Installation 4.1 Before installation 4.2 Installing the Compaq NIC Agents 4.3 After installation 5. New Features 6. Supported Products ------------------------------------------------------------------------ 1. Introduction The "Compaq NIC Agents - Linux" software release contains the SNMP Network Interface Card Agents and related files that enable Linux to support the NIC reporting features of the Compaq Insight Manager (CIM) and Insight Manager XE. 2. Documentation Updates and Corrections This section contains information on known errors and omissions in the "Compaq NIC Agents - Linux" section of the Compaq Managements Agents for Linux Servers HOWTO. 3. Known Issues 1) The e100 driver does not report the first link status change if the driver is loaded and the network cable is not plugged in. However, subsequent link status changes are detected and reported. 2) The e100 driver Driver_Name is a description of the driver instead of the name of the driver (e100). 3) NIC events are not reported to the Integrated Management Log (IML) in this release. 4) Information CIM reports from MIB-II may not be correct, such as the speed of the link. 5) Messages in /var/spool/compaq/cma.log related to parsing the snmpd.conf file, strings containing "Did not find" when parsing /usr/share/snmp/mibs/*, and strings containing "Unlinked OID in". 4. Installation 4.1 Before installation 1) The NIC Agents require: Compaq Foundation Agents, version 5.30.0, (cmafdtn-5.30.0-x) Compaq Server Agents, version 5.30.0, (cmasvr-5.30.0-x) Red Hat Linux 7.1 or Red Hat Linux 7.2 or SuSE Linux Enterprise Server 7 Compaq tested and supported NIC drivers from http://www.compaq.com/products/servers/linux/linux-drivers.html. 2) The NIC Agents are configured to start at the same runlevels as the snmpd daemon. Please insure the snmpd daemon is configured to start at the desired runlevels before installing the NIC Agents, otherwise the NIC Agents will need to be manually configured after installation using chkconfig or a similar utility. 4.2 Installing the NIC Agents NOTE: If version 4.90-x of the Compaq NIC Agents is currently installed on your server, the agents must be removed before installing a newer version. Check the version by issuing the following command: # rpm -q cmanic If you see a line containing "cmanic-4.90", remove the agents with the following command before installing the new agents # rpm -e cmanic Use following command to install or upgrade Compaq NIC Agents: # rpm -Uvh cmanic-x.xx.x-x.i386.rpm Where "x" is the version number of the Compaq NIC Agent package. 4.3 After installation a. The Compaq NIC Agents are configured to start at the same runlevels as the snmpd daemon. To start the NIC agent immediately after installation, enter the following command: # /etc/init.d/cmanic start or # /etc/rc.d/init.d/cmanic start b. To determine the NIC drivers that support /proc file system reporting, run the following commands: find /proc/net/nicinfo -name "eth*.info" \ -exec grep Driver_Name {} \; 2>/dev/null | uniq find /proc/net/PRO_LAN_Adapters -name "eth*.info" \ -exec grep Driver_Name {} \; 2>/dev/null | uniq NIC drivers supporting this reporting mechanism will be displayed as: Driver_Name name_of_driver where name_of_driver is the actual name of the loaded driver. The latest NIC drivers tested by Compaq can be downloaded from http://www.compaq.com/products/servers/linux/linux-drivers.html c. The following command line arguments can be passed to cmanicd from the /opt/compaq/nic/etc/cmanicd script: -p poll_time specifies the number of seconds between data caching/poll intervals. NIC drivers are only queried when a request comes in and the cached information is older than the specified poll interval. The default value is 20 seconds. The minimum poll time is 10 seconds. -s set_state specifies whether SNMP set commands are allowed for this agent. A set_state of OK (default) means that SNMP set commands are allowed. A set_state of NOT_OK means that SNMP set commands are not allowed. -t trap_state specifies whether the NIC agent is allowed to send traps. A trap_state of OK (default) indicates the NIC agent may send SNMP traps. A trap_state of NOT_OK means that NIC agent is not allowed to send traps. For example, to set the poll interval to 30 seconds and prevent traps one would change PFLAGS= to PFLAGS="-p30 -t NOT_OK" in the /opt/compaq/nic/etc/cmanicd script. The resource control script to start the cmanicd daemon is cmanic. 5. New Features Added support for SuSE Linux Enterprise Server 7 Added support for cpqNicIfLogMapSpeed and cpqNicIfPhysAdapterPartNumber MIB objects Changed format of cpqNicConnectivityRestored and cpqNicConnectivityLost SNMP traps to cpqNic2ConnectivityRestored and cpqNic2ConnectivityLost format 6. Supported Products The Compaq NIC Agents for Linux are supported on Compaq servers tested for running Red Hat Linux 7.1 and 7.2, and SuSE Linux Enterprise Server 7. Please refer to the "Linux Server certification matrix" at http://www.compaq.com/products/servers/linux/ for a complete list of Compaq servers that have been tested with the above distributions and versions. 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.