SNMP agent extension implementing the INTEL-LAN-ADAPTERS MIB

# SNMP Agent Extension for Linux*

Overview

Prerequisites

Installation

Functionality

Known Issues

## Overview

This file describes the Intel® SNMP package for Linux* operating systems, version 1.8.x. This package supports the 2.4.x kernels.

The SNMP agent extension extends the UCD-SNMP or NET-SNMP agent for Linux via a "pass-through" protocol. It provides information on the Intel® PRO LAN adapters (10/100/1000/10GbE) through the adapter drivers (e100, e1000, ixgb). It also provides information about advanced features, including teaming and VLANs.

The extension was tested on Red Hat* Enterprise Server 3 with the net-snmp-5.0.9 SNMP agent and on Red Hat 9.0 with the net-snmp-5.0.6 SNMP agent.

## Prerequisites

An SNMP agent which supports the "pass-through" protocol should be installed on the system.

The libstdc++-libc6.2-2.so.3 package - available in Red Hat* 7.2 and later. Located in either the libstdc++ or compat-libstdc++ package provided
with the operating system. libstdc++.so.5 package is required for x86_64 architecture.

## Installation

1. Copy the inic-snmp-xxx.tar.gz tar file to a directory of your choice.

2. Untar the archive:

   > tar xzf inic-snmp-xxx.tar.gz

   The inic-snmp-x.x.x directory should be created.

3. Change directories to the inic-snmp-x.x.x directory:

   > cd inic-snmp-x.x.x

   The following files should be in the directory:

   > INSTALL
   > ia32
   > ia64
   > INTELLAN.txt
   > LICENSE
   > README
   > UNINSTALL inic-snmp_rh21.spec
   > inic-snmp_rh3.spec
   > inic-snmp_rh9.spec
   > ldistrib.txt
   > x86_64

4. Enter:

   > ./INSTALL [-i <install_directory>][-c <snmpd_config_file>]

   The INSTALL script:

   - detects architecture (<arch>) of the current machine (ia32, x86_64, or ia64)
   - copies the following files to the indicated location:

     > <arch>/inic-extension - to <install_directory>
     > <arch>/inic-daemon - to <install_directory>
     > LICENSE and README - to /usr/share/doc/inic-snmp-<package_version>
     > INTELLAN.txt - to <mibs_directory>

   - adds the following line anywhere in <snmpd_config_file>:

     > pass .1.3.6.1.4.1.343.2.7.2 <install_directory>/inic_extension

   | NOTES: <install_directory> is any preferred directory. If option -i is not used, <install_directory> is /usr/local/sbin.
   | <snmpd_config_file> is any configuration file for the SNMP agent. If option -c is not used, <snmpd_config_file> is the file specified in the snmpd.conf man page. If this file does not exist, INSTALL script creates an empty file in the specified location.
   | <mibs_directory> is the MIBS directory specified in the snmpd man page.

5. In order to receive both complete information on counters and SNMP traps, run the inic_daemon executable before using the extended agent.

   The inic_daemon executable is used for keeping track of internal counters and sending traps to the SNMP clients. The daemon recognizes the directives 'trapsink', 'trap2sink', 'informsink', 'trapcommunity', 'agentuser', 'agentaddress' and 'agentgroup' (for more information, see the snmpd.conf man page). These directives are optional and should be added manually to <snmpd_config_file> (see previous step, <snmpd_config_file>).

   By default, the inic_daemon reads the trap directives from the configuration file specified in the snmpd.conf man page (see previous step, <snmpd_config_file>). In order to use an alternative configuration file, specify the file from the inic_daemon command line using the '-c' option:

   > inic_daemon -c <snmpd_config_file>

   Your SNMP agent is now ready to run.

6. Install the clients. Copy the MIB files (INTELLAN.txt) to every management station, placing the file in the relevant MIBS directory. This varies according to the SNMP MIB browser/application you are using.

#### To uninstall enter:

1. ./UNINSTALL [-i <install_directory>][-c <snmpd_config_file>]

2. The UNINSTALL script will remove all files installed in step 4 (see above). If <install_directory> is not specified, the default is the directory used when running the INSTALL script.

3. The UNINSTALL script will remove the line

> > pass .1.3.6.1.4.1.343.2.7.2 <install_directory>/inic_extension

> from <snmpd_config_file>. If <snmpd_config_file> is not specified, the default is the file used when running the INSTALL script.

4. To keep all features of UNINSTALL script working properly, it is not recommended to relocate the files installed/edited by INSTALL script. To relocate them run UNINSTALL and then INSTALL with new parameters.

| NOTE: The UNINSTALL script will not remove any directives added manually to <snmpd_config_file>.

For more information concerning the UCD-SNMP (NET-SNMP) package, go to http://net-SNMP.sourceforge.net.

## Functionality

The SNMP extension implements a MIB branch through the UCD SNMP translate utility. The branch is located under the Intel branch at:

.intel.products.nic-products.intel-lan-adapters

Full OID: .1.3.6.1.4.1.343.2.7.2

For a text reference of the tree output, see README, included in the SNMP Agent Extension tar file.

## Known Issues

NOTE: For Linux distribution-specific information, see the ldistrib.txt file included in the SNMP tar file.

### Possible Memory Leak Scenario

When informsink is set to a host that acknowledges the message, there is a memory leak in inic_daemon. This is due to a memory leak in net-snmp code and is a third party issue.

`Last modified on 3/08/05 10:04a Revision 2`