FILE NAME: cmanic-7.5.0-6.sles9.linux.rpm TITLE: HP NIC Agents for SUSE Linux Enterprise Server 9 VERSION: 7.5.0 LANGUAGE: English CATEGORY: Management Agents DIVISIONS: Systems PRODUCTS AFFECTED: The following HP ProLiant servers are affected. BL10e BL10e G2 BL20p BL20p G2 BL20p G3 BL25p BL30p BL35p BL40p BL45p DL320 G2 SCSI DL320 G3 SATA DL320 G3 SATA RAID DL320 G3 SCSI DL320 SCSI DL360 G3 DL360 G4p SAS DL360 G4p SATA DL360 G4p SATA RAID DL360 G4p SCSI DL360 G4 SATA DL360 G4 SCSI DL380 G3 DL380 G4 DL385 DL560 DL580 DL580 G2 DL580 G3 DL585 DL585 Dual Core DL740 DL760 G2 ML310 G2 SATA ML310 G2 SATA RAID ML310 G2 SCSI ML330 G2 ML330 G3 SCSI ML350 G3 ML350 G4p SATA ML350 G4p SCSI ML350 G4 SCSI ML370 G3 ML370 G4 ML530 ML530 G2 ML570 ML570 G2 ML570 G3 OPERATING SYSTEM: SUSE Linux Enterprise Server 9 PREREQUISITES: HP ProLiant Advanced Server Management Package (hpasm) version 7.5.0-x must be installed before installing the HP NIC Agents for SUSE Linux Enterprise Server 9. EFFECTIVE DATE: December 20, 2005 SUPERSEDES: cmanic-7.4.0-7.sles9.linux.rpm DESCRIPTION: This RPM (RPM Package Manager) package contains the HP NIC Agents for SUSE Linux Enterprise Server 9. ENHANCEMENTS/FIXES: Added HP Linux Virus Throttle support HOW TO USE: 1. Download the cmanic-7.5.0-6.sles9.linux.rpm and cmanic-7.5.0-6.sles9.linux.txt to a directory on your hard drive and change to that directory. 2. Refer to the cmanic-7.5.0-6.sles9.linux.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-7.5.0-6.sles9.linux.txt file for additional information. Copyright 2000-2005 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 HP NIC Agents for SUSE Linux Enterprise Server 9 Version 7.5.0 December 20, 2005 ------------------------------------------------------------------------ 1. Introduction 2. Documentation Updates and Corrections 3. Known Issues 4. Installation 4.1 Before installation 4.2 Installing the HP NIC Agents 4.3 After installation 5. Bug Fixes/New Features 6. Supported Products ------------------------------------------------------------------------ 1. Introduction This HP NIC Agents 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) The NIC agents will not recognize network configuration changes, such as adding or removing an interface from a network team, until a full poll duration has passed. For information to be consistent between all agents after a configuration change, a full poll cycle must pass for each agent - poll times can be different for each agent. See poll_time later in this document for details on the polling duration of the NIC agents. 2) 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". 3) Link status traps forwarded from RIB/iLO don't contain the IpAddress field, while traps sent directly from the NIC agents do. 4) Network interfaces must be named eth0 through ethN, network bonds (teams) must be named bond0 through bondN, and VLAN interfaces must be named ethN.X or bondN.X (N is the interface number and X is the VLAN tag). 5) The default ethtool package that comes with SuSE Linux Enterprise Server 8 is version 1.6; However, the minimum required version for full NIC agent functionality is version 1.8. The NIC agent will allow ethtool version 1.6 for SLES 8, but it must be noted that functionality will be reduced. Specifically, if the NIC agent sends a trap, the part number of the NIC involved will not be reported. Also, the permanent hardware address (physical address) will not be reported in the controller details section of the Systems Management Homepage. The latest version of the ethtool package may be obtained at the following URL: "http://sourceforge.net/projects/gkernel/". 4. Installation 4.1 Before installation 1) The HP NIC Agents require: - HP ProLiant Advanced Server Management Package, version 7.5.0, (hpasm-7.5.0-x) - SUSE Linux Enterprise Server 9 - HP tested and supported NIC drivers for ProLiant servers from http://h18000.www1.hp.com/products/servers/linux/ softwaredrivers.html If using network teaming (bonding), the tested and supported bonding driver available from http://h18000.www1.hp.com/products/servers/linux/ softwaredrivers.html must be used. If using VLANs, the tested and supported 8021q driver available from http://h18000.www1.hp.com/products/servers/linux/ softwaredrivers.html must be used. 2) The HP NIC Agents are configured to start at the same runlevels as the snmpd daemon. Ensure the snmpd daemon is configured to start at the desired runlevels before installing the HP NIC Agents, otherwise the HP NIC Agents will need to be manually configured after installation using chkconfig or a similar utility. 4.2 Installing the HP NIC Agents Use following command to install or upgrade HP NIC Agents: # rpm -Uvh cmanic-7.5.0-6.sles9.linux.rpm 4.3 After installation a. The HP 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 b. The latest HP tested and supported NIC drivers for ProLiant servers that have been tested with this agent should be downloaded from http://h18000.www1.hp.com/products/servers/linux/ softwaredrivers.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. -U specifies the string that the NIC agent should look for to generate link UP trap. The NIC agent always generates Link UP traps on seeing "Link is Up" string in the driver logs. This option can be used to specify additional strings that the NIC agent should look for to generate link UP trap. -D specifies the string that the NIC agent should look for to generate link DOWN trap. The NIC agent always generates Link DOWN traps on seeing "Link is DOWN" string in the driver logs. This option can be used to specify additional strings that the NIC agent should look for to generate link DOWN trap. 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). The /opt/compaq/nic/etc/cmanicd script takes care of passing "-U" and "-D" option depending on the value of UPSTRING and DOWNSTRING shell variables. In order to pass "-U" command line option one would change UPSTRING= to UPSTRING="Link is UP" in the /opt/compaq/nic/etc/cmanicd script. In order to pass "-D" command line option one would change DOWNSTRING= to DOWNSTRING="Link is DOWN" in the /opt/compaq/nic/etc/cmanicd script. 5. Bug Fixes/New Features Added HP Linux Virus Throttle support 6. Supported Products Refer to the "Linux Server Certification Matrix" at http://h18000.www1.hp.com/products/servers/linux/hplinuxcert.html for a complete list of HP ProLiant servers that have been tested with SUSE Linux Enterprise Server 9. 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-2005 Hewlett-Packard Development Company, L.P. Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.