FILE NAME:  cmanic-7.2.1-5.linux.i686.rpm
TITLE:  NIC Agents for Servers - Linux
VERSION:  7.2.1
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
                   DL145
                   DL320 ATA
                   DL320 G2 ATA    
                   DL320 G2 SCSI
                   DL320 G3 SATA
                   DL320 SCSI
                   DL360    
                   DL360 G2
                   DL360 G3
                   DL360 G4 SATA
                   DL360 G4 SCSI
                   DL380    
                   DL380 G2
                   DL380 G3
                   DL380 G4
                   DL385
                   DL560
                   DL580
                   DL580 G2
                   DL580 G3
                   DL585
                   DL740
                   DL760
                   DL760 G2
                   ML310 ATA
                   ML310 SCSI
                   ML330    
                   ML330e    
                   ML330 G2 ATA
                   ML330 G2 SCSI
                   ML330 G3 ATA
                   ML330 G3 SCSI
                   ML350    
                   ML350 G2
                   ML350 G3
                   ML350 G4 SATA
                   ML350 G4 SCSI
                   ML370    
                   ML370 G2
                   ML370 G3
                   ML370 G4
                   ML530
                   ML530 G2
                   ML570
                   ML570 G2
                   ML570 G3
                   ML750

OPERATING SYSTEM: Red Hat Enterprise Linux 4


PREREQUISITES:  HP ProLiant Advanced Server Management Package (hpasm) version 
                7.2.1-x must be installed before installing the NIC Agents 
                for Linux.

EFFECTIVE DATE:  February 28, 2005

SUPERSEDES:  cmanic-7.1.1-5.i686.rpm

DESCRIPTION:  This RPM (RPM Package Manager) package contains the NIC Agents 
              for Linux.

ENHANCEMENTS/FIXES:  
    Added support for Red Hat Enterprise Linux 4


HOW TO USE:
1. Download the cmanic-7.2.1-5.linux.i686.rpm and 
   cmanic-7.2.1-5.linux.i686.txt to a directory on your hard drive and change 
   to that directory.

2. Refer to the cmanic-7.2.1-5.linux.i686.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.2.1-5.linux.i686.txt file for additional information.


Copyright 2000, 2001, 2002, 2003, 2004, 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

                           NIC Agents - Linux

                             Version 7.2.1
                           February 28, 2005


------------------------------------------------------------------------

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.  Bug Fixes/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) 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).


4.  Installation

    4.1 Before installation

        1) The NIC Agents require:
               HP ProLiant Advanced Server Management Package, version 7.2.1, 
               (hpasm-7.2.1-x)

               One of the following Linux distributions:

                    - Red Hat Enterprise Linux 4


               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 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 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-7.2.1-x.linux.i686.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. 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.

           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.  Bug Fixes/New Features

    Red Hat Enterprise Linux 4


6.  Supported Products

    The NIC Agents for Linux are supported on HP servers running one of the 
    following Linux distributions:

       - Red Hat Enterprise Linux 4


    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 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, 2001, 2002, 2003, 2004, 2005 Hewlett-Packard Development 
Company, L.P.

Product names mentioned herein may be trademarks and/or registered
trademarks of their respective companies.