Info::Layer3::Enterasys(3)

NAME
SNMP::Info::Layer3::Enterasys - SNMP Interface to Enterasys Network Devices

AUTHOR
Eric Miller

SYNOPSIS
 # Let SNMP::Info determine the correct subclass for you.
 my $enterasys = new SNMP::Info(
                          AutoSpecify => 1,
                          Debug       => 1,
                          DestHost    => 'myswitch',
                          Community   => 'public',
                          Version     => 1
                        )
    or die "Can't connect to DestHost.\n";

 my $class = $enterasys->class();

 print "SNMP::Info determined this device to fall under subclass : $class\n";

DESCRIPTION
Provides abstraction to the configuration information obtainable from an Enterasys device through SNMP.

For speed or debugging purposes you can call the subclass directly, but not after determining a more specific class using the method above.

my $enterasys = new SNMP::Info::Layer3::Enterasys(...);

  Inherited Classes

SNMP::Info::MAU
SNMP::Info::LLDP
SNMP::Info::CDP
SNMP::Info::Layer3

  Required MIBs

ENTERASYS-OIDS-MIB

  Inherited MIBs
See "Required MIBs" in SNMP::Info::MAU for its MIB requirements.

See "Required MIBs" in SNMP::Info::LLDP for its MIB requirements.

See "Required MIBs" in SNMP::Info::CDP for its MIB requirements.

See "Required MIBs" in SNMP::Info::Layer3 for its MIB requirements.

GLOBALS
These are methods that return scalar value from SNMP

$enterasys->model()
    Returns model type. Checks $enterasys->id() against the ENTERASYS-OIDS-MIB.

$enterasys->vendor()
    Returns enterasys

$enterasys->os()
    Returns enterasys

$enterasys->os_ver()
    Returns os version extracted from "sysDescr"

$enterasys->mac()
    Returns base mac

    ("dot1dBaseBridgeAddress")

  Overrides

  Globals imported from SNMP::Info::MAU
See documentation in "GLOBALS" in SNMP::Info::MAU for details.

  Globals imported from SNMP::Info::LLDP
See documentation in "GLOBALS" in SNMP::Info::LLDP for details.

  Globals imported from SNMP::Info::CDP
See documentation in "GLOBALS" in SNMP::Info::CDP for details.

  Globals imported from SNMP::Info::Layer3
See documentation in "GLOBALS" in SNMP::Info::Layer3 for details.

TABLE METHODS
These are methods that return tables of information in the form of a reference to a hash.

  Overrides

$enterasys->interfaces()
    Mapping between the Interface Table Index (iid) and the physical port name.

$enterasys->i_ignore()
    Returns reference to hash. Creates a key for each IID that should be ignored.

    Currently looks for rs232, tunnel,loopback,lo,null from $enterasys->interfaces()

$enterasys->i_duplex()
    See documentation for mau_i_duplex() in "TABLE METHODS" in SNMP::Info::MAU.

$enterasys->i_duplex_admin()
    See documentation for mau_i_duplex_admin() in "TABLE METHODS" in SNMP::Info::MAU.

$enterasys->fw_mac()
    Returns reference to hash of forwarding table MAC Addresses.

$enterasys->fw_port()
    Returns reference to hash of forwarding table entries port interface identifier (iid).

    ("dot1qTpFdbPort")

  Topology information
Based upon the firmware version Enterasys devices may support Cabletron Discovery Protocol (CTRON CDP), Cisco Discovery Protocol (CDP), Link Layer Discovery Protocol (LLDP), or all. This module currently supports CDP and LLDP, but not CTRON CDP. These methods will query both CDP and LLDP and return the combination of all information. As a result, there may be identical topology information returned from the two protocols causing duplicate entries. It is the calling program's responsibility to identify any duplicate entries and remove duplicates if necessary.

$enterasys->hasCDP()
    Returns true if the device is running either CDP or LLDP.

$enterasys->c_if()
    Returns reference to hash. Key: iid Value: local device port (interfaces)

$enterasys->c_ip()
    Returns reference to hash. Key: iid Value: remote IPv4 address

    If multiple entries exist with the same local port, c_if(), with the same IPv4 address, c_ip(), it may be a duplicate entry.

    If multiple entries exist with the same local port, c_if(), with different IPv4 addresses, c_ip(), there is either a non-CDP/LLDP device in between two or more devices or multiple devices which are not directly connected.

    Use the data from the Layer2 Topology Table below to dig deeper.

$enterasys->c_port()
    Returns reference to hash. Key: iid Value: remote port (interfaces)

$enterasys->c_id()
    Returns reference to hash. Key: iid Value: string value used to identify the chassis component associated with the remote system.

$enterasys->c_platform()
    Returns reference to hash. Key: iid Value: Remote Device Type

  Table Methods imported from SNMP::Info::MAU
See documentation in "TABLE METHODS" in SNMP::Info::MAU for details.

  Table Methods imported from SNMP::Info::LLDP
See documentation in "TABLE METHODS" in SNMP::Info::LLDP for details.

  Table Methods imported from SNMP::Info::CDP
See documentation in "TABLE METHODS" in SNMP::Info::CDP for details.

  Table Methods imported from SNMP::Info::Layer3
See documentation in "TABLE METHODS" in SNMP::Info::Layer3 for details.