SNMP Agent Extension for Linux*: Intel® Network Adapters User Guide

Overview
Prerequisites
Installation
Functionality

Overview

This file describes the Intel SNMP package for Red Hat Linux* operating systems, version 1.5.x. This package is intended for 2.4.x kernels. Intel focused testing on Red Hat Linux systems running the 2.4.18 kernel.

The SNMP agent extension extends the UCD-SNMP agent for Red Hat Linux via the SNMP "pass-through" protocol. It provides information on the Intel® PRO LAN adapters (10/100/1000) through the adapter drivers (e100, e1000). It also provides information about advanced features, including teaming and VLANs, through the Intel Advanced Network Services (ANS) module.

The extension was tested on Red Hat 8.0 with the NET-snmp-5.0.1 SNMP agent, Red Hat 7.3 with the ucd-snmp-4.2.4 SNMP agent and Red Hat AS 2.1.

Intel supplies pre-built binary RPM files of this application for Red Hat Linux distributions. For instructions on installing an RPM, see the Installation section.

Prerequisites

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

Installation

There are two methods for installing the SNMP Agent: installing from source code; and installing from a pre-built binary RPM.

Installing from Source Code

Copy the inic-snmp-xxx.tar.gztar file to a directory of your choice.
Untar the archive:
tar xzf inic-snmp-xxx.tar.gz

The inic-snmp-x.x.x directory should be created
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

        inic-snmp.spec

        INTELLAN.txt

        LICENSE

        README

        UNINSTALL

ENTER:

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

NOTE: By default the install script will install the inic-snmp application in: /usr/local/sbin. The user can choose another directory by specifying it with the "-i" parameter.

NOTE: The install script finds the correct snmp configuration file as specified in the snmpd man file. The user can select a different snmp configuration file by using the "-c" parameter.

The INSTALL script:

detects architecture (<arch>) of the current machine (ia32 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

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.

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

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

To Uninstall, enter:

./UNINSTALL [-i<install_directory>][-c<snmpd_config_file].
The UNINSTALL script will remove all files installed in step 4 (see above). If the option -i is not used, <install_directory> will be in the same directory as the last time the INSTALL script was run.
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 option -c is not used, <snmpd_config_file> will be the same files as the last time the INSTALL script was run.

To keep all features of the UNISTALL script working properly, it is not recommended to relocate the files installed/edited by the 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>.

Installing a Pre-Built Binary RPM

Intel supplies pre-built binary RPM files of this application for Red Hat Linux distributions. To install, uninstall, or upgrade the RPMs, follow the instructions below.

NOTE: The <filename> and <package> must be specific to the application version and distribution you are using.

<filename> is the entire filename; for example, inic-snmp-1.2.6-1.i386.rpm.
<package> is just the package name; for example, inic-snmp-1.2.6-1.

NOTE: If you have a previous RPM installed, it must be uninstalled before installing the new RPM. To determine whether or not a previous RPM is installed, enter rpm -q inic-snmp.

To install the RPM, enter:
    rpm -i <filename>
To uninstall the RPM, enter:
    rpm -e <package>
To upgrade the RPM to a newer application version, enter:
    rpm -U <filename>

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 snmp.txt, included in the SNMP Agent Extension tar file.

Please read all restrictions and disclaimers.

Back to Contents Page Back to Top