SOFTPAQ NUMBER:  N/A

PART NUMBER:  N/A

FILE NAME:  cmanic-5.00-1.i386.rpm

TITLE:  Compaq NIC Agents for Linux

VERSION:  5.00-1

LANGUAGE:  English



CATEGORY:  Software Solutions



DIVISIONS: Mainstream Servers



PRODUCTS AFFECTED:

ProLiant ML 330

ProLiant ML 350, First Generation up to 933MHz

ProLiant ML 350, Second Generation 1GHz and up

ProLiant ML 370  

ProLiant ML 530 6/800

ProLiant ML 570

ProLiant DL 320

ProLiant DL 360 6/800

ProLiant DL 380 6/733

ProLiant DL 580





OPERATING SYSTEM: 

RedHat 7.0



SYSTEM CONFIGURATION:  

All shipping configurations



PREREQUISITES:  N/A



EFFECTIVE DATE:  March 22, 2001



ELECTRONIC DISTRIBUTION ALLOWED:  Yes



SOFTPAQ UTILITY VERSION:  5.x



SUPERSEDES:  SP14479



DESCRIPTION:  
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.  This release 
supports Red Hat Linux 7.0



HOW TO USE:



1. Before installation

        a) 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.

        b) 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.

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.

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.

4. Known Issues

    a) 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.

    b) The e100 driver Driver_Name is a description of the driver instead 
       of the name of the driver (e100).

    c) NIC events are not reported to the Integrated Management Log (IML) in 
       this release.

    d) Information CIM reports from MIB-II may not be correct, such as the 
       speed of the link.


5.  For additional information please refer to:

http://www.compaq.com/products/servers/linux/





Copyright 2001, Compaq Computer Corporation.  All rights reserved.



Product names mentioned herein may be trademarks and/or registered

trademarks of their respective companies