FILE NAME: cmanic-6.20.0-5.i386.rpm TITLE: NIC Agents for Servers - Linux VERSION: 6.20.0 LANGUAGE: English CATEGORY: Management Agents DIVISIONS: Systems PRODUCTS AFFECTED: The following HP ProLiant servers are affected. BL10e BL20p DL320 DL360 DL360 G2 DL380 DL380 G2 DL380 G3 DL580 DL580 G2 DL760 ML310 ML330 ML330e ML330 G2 ML350 ML350 G2 ML350 G3 ML370 ML370 G2 ML370 G3 ML530 ML530 G2 ML570 ML570 G2 ML750 OPERATING SYSTEM: Red Hat Linux 7.3 Professional Red Hat Linux 8.0 Professional Red Hat Linux Advanced Server 2.1 SuSE Linux Enterprise Server 7 (SLES-7) Conective S.A., The SCO Group, SuSE Linux AG and Turbolinux, Inc. powered by UnitedLinux 1.0 PREREQUISITES: HP ProLiant Advanced Server Management Package (hpasm) version 6.20.0-x must be installed before installing the NIC Agents for Linux. EFFECTIVE DATE: January 23, 2003 SUPERSEDES: cmanic-6.10.0-3.i386.rpm DESCRIPTION: This RPM (RPM Package Manager) package contains the NIC Agents for Linux. ENHANCEMENTS/FIXES: Added network bonding (teaming) support Added VLAN support HOW TO USE: 1. Download the cmanic-6.20.0-5.i386.rpm and cmanic-6.20.0-5.i386.txt to a directory on your hard drive and change to that directory. 2. Refer to the cmanic-6.20.0-5.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-6.20.0-5.i386.txt file for additional information. Copyright 2000-2003 Hewlett-Packard Development Company, L.P. Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies ==================================README================================== H E W L E T T - P A C K A R D C O M P A N Y NIC Agents - Linux Version 6.20.0 January 23, 2003 ------------------------------------------------------------------------ 1. Introduction 2. Documentation Updates and Corrections 3. Known Issues 4. Installation 4.1 Before installation 4.2 Installing the NIC Agents 4.3 After installation 5. New Features 6. Supported Products ------------------------------------------------------------------------ 1. Introduction The "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 Insight Manager 7. 2. Documentation Updates and Corrections None. 3. Known Issues 1) NIC events are not reported to the Integrated Management Log (IML) in this release. 2) Information CIM reports from MIB-II may not be correct, such as the speed of the link. 3) 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) Link status traps forwarded from RIB/iLO don't contain the IpAddress field, while traps sent directly from the NIC agents do. 4. Installation 4.1 Before installation 1) The NIC Agents require: HP ProLiant Advanced Server Management Package, version 6.20.0, (hpasm-6.20.0-x) One of the following Linux distributions: - Red Hat Linux 7.3 Professional or - Red Hat Linux 8.0 Professional or - Red Hat Linux Advanced Server 2.1 or - SuSE Linux Enterprise Server 7 (SLES-7) or - Conective S.A., The SCO Group, SuSE Linux AG and Turbolinux, Inc. powered by UnitedLinux 1.0 HP tested and supported NIC drivers for ProLiant servers from http://www.compaq.com/products/servers/linux/linux-drivers.html. If using network teaming (bonding), the tested and supported bonding driver available from http://h18007.www1.hp.com/support/files/networking/nics/ must be used. If using VLANs, the tested and supported 8021q driver available from http://h18007.www1.hp.com/support/files/networking/nics/ must be used. 2) The NIC Agents are configured to start at the same runlevels as the snmpd daemon. Please ensure 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 Use following command to install or upgrade NIC Agents: # rpm -Uvh cmanic-6.20.0-x.i386.rpm Where "x" is the version number of the NIC Agent package. 4.3 After installation a. The 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 HP tested and supported NIC drivers for ProLiant servers can be downloaded from 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 (/etc/init.d/cmanic). 5. New Features Added network bonding (teaming) support Added VLAN support 6. Supported Products The NIC Agents for Linux are supported on HP servers tested for running Red Hat Linux 7.3 Professional, Red Hat Linux 8.0 Professional, Red Hat Linux Advanced Server 2.1, SuSE Linux Enterprise Server 7, and Conective S.A., The SCO Group, SuSE Linux AG and Turbolinux, Inc. powered by UnitedLinux 1.0. Please refer to the "Linux Server Certification Matrix" at http://www.compaq.com/products/servers/linux/ for a complete list of HP ProLiant servers that have been tested with the above distributions and versions. Use of this software on equipment not specifically tested by HP may produce unreliable or undesirable results. HP does not warrant the fitness or compatibility of this software on untested hardware. ------------------------------------------------------------------------ Copyright 2000-2003 Hewlett-Packard Development Company, L.P. Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.