README file for the SNMP agent extension implementing the INTEL-LAN-ADAPTERS MIB. Overview: --------- The SNMP agent extension extends the UCD-SNMP agent for Linux. It provides information on the Intel PRO Lan adapters (10/100/1000), through the adapter drivers (e100, e1000). It also provides information on advanced features, including teaming and VLANs, through the Advanced Networking Services (ANS) module. Pre-Requisites: ------------ The SNMP agent package will work best when the Intel PRO Lan adapter drivers (e100, e1000) and/or the Intel ANS module (ians) are installed and loaded on the system. However, the package will work with any combination of the 3 modules mentioned above. Installation: ------------- There are three choices available for the installation of the inic-UCD-SNMP package. The first two are for "Managed Stations" (running the agent). The third is for the installation of the "Mangagement Stations" (running MIB browsers/applications). 1. Installing the RPMs. The Provided RPMs were prepared for Red Hat* 7.0 and as a replacememnt to the UCD-SNMP-4.1.2-8.i386.rpm, UCD-SNMP-utils-4.1.2-8.i386.rpm and UCD-SNMP-devel-4.1.2-8.i386.rpm packages. 1.1 If you have the UCD-SNMP-{,utils-,devel-}4.1.2-8.i386.rpm currently installed in your system, you need to uninstall them issuing the command "rpm -e UCD-SNMP UCD-SNMP-utils UCD-SNMP-devel". (First, save the "/etc/SNMP/SNMPd.conf" configuration file.) 1.2 Install the inic-UCD-SNMP RPMs issuing the command "rpm -i inic-UCD-SNMP-*-4.1.2-8.i386.rpm" in the directory where the inic-UCD-SNMP RPMs reside. 2. Installing from the UCD-SNMPd source tree. This installation procedure is intended for users who need to compile their own SNMP agent. (Users running a Linux distribution unsupported by the RPM packaged pre-compiled agent provided, or users who need to extend/tailor their SNMP agent with additional MIBS for their own needs.) 2.1 Get UCD-SNMP-4.1.2.tar.gz clean original sources and the inic-SNMP-X.X.X.tar.gz file. These files are available both from the web and the bundled software CD. 2.2 Follow the instructions in the "README.developer" file on how to patch and compile the UCD-SNMP source code. If you would like to load the SNMP agent on boot, use your favorite setup tool ("ntsysv" on Red Hat Systems) to make sure that the SNMP agent is loaded on boot. 3. Installing the Clients Get the file mibs.tar.gz and open it. Copy the textual MIBs (INTEL-Common-MIB.txt, INTEL-LAN-ADAPTERS-MIB.txt) to every management station, placing them in the relevant mibs directory. (This will vary according to the SNMP MIB browser/application you are using). For more information concerning the UCD-SNMP (NET-SNMP) package, visit http://net-SNMP.sourceforge.net License: -------- The following license does not apply to modifications of original files in the UCD-SNMP source code. Look at the UCD-SNMP source code files for the relevant License statement. Copyright (c) 1999 - 2001, Intel Corporation All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistribution's of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistribution's in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of Intel Corporation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Funcionality: ------------- The SNMP extension implements the following MIB branch. 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). +--intel-lan-adapters(2) | +--component-description(1) | | | +-- -R-- String company(1) | | Textual Convention: DisplayString | | Size: 0..255 | +-- -R-- String description(2) | | Textual Convention: DisplayString | | Size: 0..255 | +-- -R-- String operatingSystem(3) | | Textual Convention: DisplayString | | Size: 0..255 | +-- -R-- String mibVersion1-0-0(4) | | Textual Convention: DisplayString | | Size: 0..255 | +-- -R-- String mibVersionSupported(5) | | Textual Convention: DisplayString | | Size: 0..255 | +-- -R-- String agentExtensionVersion(6) | | Textual Convention: DisplayString | | Size: 0..255 | +-- -R-- EnumVal status(7) | Values: baseDriverNotLoadedAnsNotLoaded(0), baseDriverLoadedAnsNotLoaded(1), baseDriverNotLoadedAnsLoaded(2), baseDriverLoadedAnsLoaded(3) | +--adapterTables(2) | | | +--genericAdapterAttrTables(1) | | | | | +--genericAdapterAttrTable(1) | | | | | | | +--genericAdapterAttrEntry(1) | | | | | | | +-- -R-- Integer adapterIndex(1) | | | | Textual Convention: InterfaceIndex | | | | Range: 1..2147483647 | | | +-- -R-- String adapterName(2) | | | | Textual Convention: DisplayString | | | | Size: 0..255 | | | +-- -R-- EnumVal adapterType(3) | | | Values: standAlone(0), teamMember(1), virtual(2) | | | | | +--genericAdapterAttrDriversTable(2) | | | | | | | +--genericAdapterAttrDriversEntry(1) | | | | | | | +-- -R-- String adapterDriverName(1) | | | | Textual Convention: DisplayString | | | | Size: 0..255 | | | +-- -R-- String adapterDriverInfo(2) | | | | Textual Convention: DisplayString | | | | Size: 0..255 | | | +-- -R-- String adapterDriverVersion(3) | | | | Textual Convention: DisplayString | | | | Size: 0..255 | | | +-- -R-- String adapterDriverPath(4) | | | | Textual Convention: DisplayString | | | | Size: 0..255 | | | +-- -R-- String adapterDriverDate(5) | | | | Textual Convention: DisplayString | | | | Size: 0..255 | | | +-- -R-- String adapterDriverSize(6) | | | Textual Convention: DisplayString | | | Size: 0..255 | | | | | +--genericAdapterAttrTrafficStatsTable(3) | | | | | +--genericAdapterAttrTrafficStatsEntry(1) | | | | | +-- -R-- Counter adapterRxPackets(1) | | +-- -R-- Counter adapterTxPackets(2) | | +-- -R-- Counter adapterRxBytes(3) | | +-- -R-- Counter adapterTxBytes(4) | | +-- -R-- Counter adapterRxErrors(5) | | +-- -R-- Counter adapterTxErrors(6) | | +-- -R-- Counter adapterRxDropped(7) | | +-- -R-- Counter adapterTxDropped(8) | | +-- -R-- Counter adapterRxMulticast(9) | | +-- -R-- Counter adapterCollisions(10) | | | +--physicalAdapterAttrTables(2) | | | | | +--physicalAdapterAttrTable(1) | | | | | | | +--physicalAdapterAttrEntry(1) | | | | | | | +-- -R-- Integer physicalAdapterIndex(1) | | | | Textual Convention: InterfaceIndex | | | | Range: 1..2147483647 | | | +-- -R-- EnumVal physicalAdapterLinkStatus(2) | | | | Values: link-up(0), link-down(1) | | | +-- -RW- Counter physicalAdapterLinkStatusChangesCounter(3) | | | +-- -R-- Gauge physicalAdapterSpeed(4) | | | +-- -R-- EnumVal physicalAdapterDplxMode(5) | | | | Values: not-available(0), half(1), full(2) | | | +-- -R-- EnumVal physicalAdapterAutoNegotiation(6) | | | | Values: on(0), off(1) | | | +-- -R-- Integer physicalAdapterPciBus(7) | | | +-- -R-- Integer physicalAdapterPciSlot(8) | | | +-- -R-- Integer physicalAdapterIrq(9) | | | +-- -R-- String physicalAdapterCurrentNA(10) | | | | Textual Convention: PhysAddress | | | +-- -R-- String physicalAdapterPermanentNA(11) | | | Textual Convention: PhysAddress | | | | | +--physicalAdapterAttrChecksumOffloadTable(2) | | | | | +--physicalAdapterAttrChecksumOffloadEntry(1) | | | | | +-- -R-- EnumVal physicalAdapterTcpRxChecksumOffLoadEnable(1) | | | Values: enabled(0), disabled(1) | | +-- -R-- Counter physicalAdapterTcpRxChecksumBad(2) | | +-- -R-- EnumVal physicalAdapterTcpTxChecksumOffLoadEnable(3) | | Values: enabled(0), disabled(1) | | | +--virtualAdapterAttrTables(3) | | | | | +--virtualAdapterAttrTable(1) | | | | | | | +--virtualAdapterAttrEntry(1) | | | | | | | +-- -R-- Integer virtualAdapterIndex(1) | | | | Textual Convention: InterfaceIndex | | | | Range: 1..2147483647 | | | +-- -R-- Integer virtualAdapterTeamId(2) | | | | | +--virtualAdapterAttrVlanTable(2) | | | | | +--virtualAdapterAttrVlanEntry(1) | | | | | +-- -R-- EnumVal virtualAdapterVlanId(1) | | Values: none(0) | | | +--teamAttrTables(4) | | | | | +--teamAttrTable(1) | | | | | | | +--teamAttrEntry(1) | | | | | | | +-- -R-- Integer teamId(1) | | | +-- -R-- Integer teamNumberOfMembers(2) | | | +-- -R-- Integer teamNumberOfVirtualAdapters(3) | | | | | +--teamAttrVlanTable(2) | | | | | | | +--teamAttrVlanEntry(1) | | | | | | | +-- -R-- EnumVal teamVlanTaggingType(1) | | | | Values: none(0), tag-802-1Q(1), tag-802-1P(2), tag-802-3AC(3), tag-iSL(4) | | | +-- -R-- EnumVal teamVlanGvrpSupport(2) | | | Values: enabled(0), disabled(1) | | | | | +--teamAttrAdapterTeamingTable(3) | | | | | +--teamAttrAdapterTeamingEntry(1) | | | | | +-- -R-- String teamAdapterTeamingTeamName(1) | | | Textual Convention: DisplayString | | | Size: 0..255 | | +-- -R-- EnumVal teamAdapterTeamingMode(2) | | | Values: none(0), team-aft(1), team-alb(2), team-fec(3), team-gec(4), team-802-3ad(5) | | +-- -R-- EnumVal teamAdapterTeamingLinkState(3) | | | Values: up(0), down(1) | | +-- -R-- Gauge teamAdapterTeamingSpeed(4) | | +-- -R-- EnumVal teamAdapterTeamingProbesState(5) | | | Values: probes-enabled(0), probes-disabled(1) | | +-- -R-- EnumVal teamAdapterTeamingProbesMode(6) | | | Values: broadcast(0), multicast(1), not-available(2) | | +-- -R-- EnumVal teamAdapterTeamingLoadBalanceRefresh(7) | | | Values: not-available(0) | | +-- -R-- EnumVal teamAdapterTeamingProbesSendTime(8) | | | Values: not-available(0) | | +-- -R-- EnumVal teamAdapterTeamingPreferredPrimaryIndex(9) | | | Values: not-available(0) | | +-- -R-- EnumVal teamAdapterTeamingCurrentPrimaryIndex(10) | | | Values: not-available(0) | | +-- -R-- EnumVal teamAdapterTeamingPreviousPrimaryIndex(11) | | | Values: not-available(0) | | +-- -RW- Counter teamAdapterTeamingFailoverCounter(12) | | | +--teamMemberAttrTables(5) | | | +--teamMemberAttrTable(1) | | | | | +--teamMemberAttrEntry(1) | | | | | +-- -R-- Integer teamMemberIndex(1) | | | Textual Convention: InterfaceIndex | | | Range: 1..2147483647 | | +-- -R-- Integer teamMemberTeamId(2) | | | +--teamMemberAttrAdapterTeamingTable(2) | | | +--teamMemberAttrAdapterTeamingEntry(1) | | | +-- -R-- EnumVal teamMemberAdapterTeamingState(1) | | Values: active(0), disabled(1), standby(2), active-secondary(3) | +-- -RW- Counter teamMemberAdapterTeamingFailureCounter(2) | +-- -R-- EnumVal teamMemberAdapterTeamingPriority(3) | Values: none(0), primary(1), secondary(2) | +--events(3) | +--physicalAdapterEvents(1) | | | +--physicalAdapterTraps(1) | | | | | +--physicalAdapterLinkUpTrap(1) | | | | | +--physicalAdapterLinkDownTrap(2) | | | | | +--physicalAdapterAddedTrap(3) | | | | | +--physicalAdapterRemovedTrap(4) | | | +-- -RW- EnumVal physicalAdapterLinkUpDownTrapEnable(2) | | Values: disabled(0), enabled(1) | +-- -RW- EnumVal physicalAdapterAddedRemovedTrapEnable(3) | Values: disabled(0), enabled(1) | +--virtualAdapterEvents(2) | | | +--virtualAdapterTraps(1) | | | | | +--virtualAdapterAddedTrap(1) | | | | | +--virtualAdapterRemovedTrap(2) | | | +-- -RW- EnumVal virutalAdapterTrapEnable(2) | Values: disabled(0), enabled(1) | +--teamEvents(3) | | | +--teamTraps(1) | | | | | +--teamAdapterTeamingFailoverTrap(1) | | | | | +--teamAddedTrap(2) | | | | | +--teamRemovedTrap(3) | | | +-- -RW- EnumVal teamTrapEnable(2) | Values: disabled(0), enabled(1) | +--teamMemberEvents(4) | +--teamMemberTraps(1) | | | +--teamMemberAddedTrap(1) | | | +--teamMemberRemovedTrap(2) | +-- -RW- EnumVal teamMemberTrapEnable(2) Values: disabled(0), enabled(1) * This tree is the output from the UCD SNMPtranslate utility.