    
         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.00
                             March 8, 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.


4.  Installation

    4.1 Before installation

        1) The NIC Agents require:
               Compaq Foundation Agent, version 5.00, (cmafdtn-5.00-x)
               RedHat Linux version 7.0
               UCD-SNMP version 4.1.2
               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 tool.

    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.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/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/PRO_LAN_Adapters -name "eth*.info" \
                     -exec grep Driver_Name {} \; 2>/dev/null | uniq
 
                find /proc/net/nicinfo -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

    This is the initial release.


6.  Supported Products

    The Compaq NIC Agents for Linux is supported on Compaq servers tested
    for running RedHat 7.0. 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 RedHat 7.0.


    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 2001 Compaq Computer Corporation. All rights reserved.

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