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.10.0
                            November 7, 2002


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

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:
               Foundation Agents, version 6.10.0, (cmafdtn-6.10.0-x)

               Server Agents, version 6.10.0, (cmasvr-6.10.0-x)

               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)

               HP tested and supported NIC drivers for ProLiant servers 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 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.10.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

    Branding changes


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, 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 
    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,2002  Compaq Information Technologies Group, L.P.

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