1042 lines
27 KiB
Perl
1042 lines
27 KiB
Perl
# SNMP::Info::Layer3::Extreme - SNMP Interface to Extreme devices
|
|
# $Id$
|
|
#
|
|
# Copyright (c) 2008 Eric Miller
|
|
#
|
|
# Copyright (c) 2002,2003 Regents of the University of California
|
|
# All rights reserved.
|
|
#
|
|
# Redistribution and use in source and binary forms, with or without
|
|
# modification, are permitted provided that the following conditions are met:
|
|
#
|
|
# * Redistributions of source code must retain the above copyright notice,
|
|
# this list of conditions and the following disclaimer.
|
|
# * Redistributions 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.
|
|
# * Neither the name of the University of California, Santa Cruz 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 THE COPYRIGHT OWNER OR 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.
|
|
|
|
package SNMP::Info::Layer3::Extreme;
|
|
|
|
use strict;
|
|
use Exporter;
|
|
use SNMP::Info::Layer3;
|
|
use SNMP::Info::MAU;
|
|
use SNMP::Info::LLDP;
|
|
use SNMP::Info::EDP;
|
|
|
|
@SNMP::Info::Layer3::Extreme::ISA
|
|
= qw/SNMP::Info::Layer3 SNMP::Info::MAU SNMP::Info::LLDP
|
|
SNMP::Info::EDP Exporter/;
|
|
@SNMP::Info::Layer3::Extreme::EXPORT_OK = qw//;
|
|
|
|
use vars qw/$VERSION %GLOBALS %FUNCS %MIBS %MUNGE/;
|
|
|
|
$VERSION = '2.11';
|
|
|
|
%MIBS = (
|
|
%SNMP::Info::Layer3::MIBS,
|
|
%SNMP::Info::MAU::MIBS,
|
|
%SNMP::Info::LLDP::MIBS,
|
|
%SNMP::Info::EDP::MIBS,
|
|
'EXTREME-BASE-MIB' => 'extremeAgent',
|
|
'EXTREME-SYSTEM-MIB' => 'extremeSystem',
|
|
'EXTREME-FDB-MIB' => 'extremeSystem',
|
|
'EXTREME-VLAN-MIB' => 'extremeVlan',
|
|
'EXTREME-POE-MIB' => 'extremePethSystemAdminEnable',
|
|
);
|
|
|
|
%GLOBALS = (
|
|
%SNMP::Info::Layer3::GLOBALS,
|
|
%SNMP::Info::MAU::GLOBALS,
|
|
%SNMP::Info::LLDP::GLOBALS,
|
|
%SNMP::Info::EDP::GLOBALS,
|
|
'serial1' => 'extremeSystemID.0',
|
|
'temp' => 'extremeCurrentTemperature',
|
|
'ps1_status_old' => 'extremePrimaryPowerOperational.0',
|
|
'ps1_status_new' => 'extremePowerSupplyStatus.1',
|
|
'ps2_status_old' => 'extremeRedundantPowerStatus.0',
|
|
'ps2_status_new' => 'extremePowerSupplyStatus.2',
|
|
'mac' => 'dot1dBaseBridgeAddress',
|
|
);
|
|
|
|
%FUNCS = (
|
|
%SNMP::Info::Layer3::FUNCS,
|
|
%SNMP::Info::MAU::FUNCS,
|
|
%SNMP::Info::LLDP::FUNCS,
|
|
%SNMP::Info::EDP::FUNCS,
|
|
'fan_state' => 'extremeFanOperational',
|
|
|
|
# EXTREME-FDB-MIB:extremeFdbMacFdbTable
|
|
'ex_fw_mac' => 'extremeFdbMacFdbMacAddress',
|
|
'ex_fw_port' => 'extremeFdbMacFdbPortIfIndex',
|
|
'ex_fw_status' => 'extremeFdbMacFdbStatus',
|
|
|
|
# EXTREME-VLAN-MIB:extremeVlanIfTable
|
|
'ex_vlan_descr' => 'extremeVlanIfDescr',
|
|
'ex_vlan_global_id' => 'extremeVlanIfGlobalIdentifier',
|
|
|
|
# EXTREME-VLAN-MIB:extremeVlanEncapsIfTable
|
|
'ex_vlan_encap_tag' => 'extremeVlanEncapsIfTag',
|
|
|
|
'peth_port_power' => 'extremePethPortMeasuredPower',
|
|
);
|
|
|
|
%MUNGE = (
|
|
|
|
# Inherit all the built in munging
|
|
%SNMP::Info::Layer3::MUNGE,
|
|
%SNMP::Info::MAU::MUNGE,
|
|
%SNMP::Info::LLDP::MUNGE,
|
|
%SNMP::Info::EDP::MUNGE,
|
|
'ex_fw_mac' => \&SNMP::Info::munge_mac,
|
|
'ps1_status_old' => \&munge_true_ok,
|
|
'ps1_status_new' => \&munge_power_stat,
|
|
'ps2_status_old' => \&munge_power_stat,
|
|
'ps2_status_new' => \&munge_power_stat,
|
|
'fan_state' => \&munge_true_ok,
|
|
);
|
|
|
|
# Method OverRides
|
|
|
|
*SNMP::Info::Layer3::Extreme::i_duplex = \&SNMP::Info::MAU::mau_i_duplex;
|
|
*SNMP::Info::Layer3::Extreme::i_duplex_admin
|
|
= \&SNMP::Info::MAU::mau_i_duplex_admin;
|
|
|
|
sub model {
|
|
my $extreme = shift;
|
|
my $id = $extreme->id();
|
|
|
|
unless ( defined $id ) {
|
|
print
|
|
" SNMP::Info::Layer3::Extreme::model() - Device does not support sysObjectID\n"
|
|
if $extreme->debug();
|
|
return;
|
|
}
|
|
|
|
my $model = &SNMP::translateObj($id);
|
|
|
|
return $id unless defined $model;
|
|
|
|
return $model;
|
|
}
|
|
|
|
sub vendor {
|
|
return 'extreme';
|
|
}
|
|
|
|
sub os {
|
|
my $extreme = shift;
|
|
|
|
my $desc = $extreme->description();
|
|
|
|
if ($desc =~ /xos/i) {
|
|
return 'xos';
|
|
}
|
|
|
|
return 'extremeware';
|
|
}
|
|
|
|
sub os_ver {
|
|
my $extreme = shift;
|
|
my $descr = $extreme->description();
|
|
return unless defined $descr;
|
|
|
|
if ( $descr =~ m/Version\s+([^ ]+)/ ) {
|
|
return $1;
|
|
}
|
|
|
|
return;
|
|
}
|
|
|
|
#
|
|
# ifName is a nice concise port name on Extreme devices.
|
|
# Layer3.pm defaults to i_description, which is verbose
|
|
# and has spaces. However, ifName has the IP address
|
|
# assigned for router interfaces, so we use ifDescr
|
|
# for those.
|
|
sub interfaces {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
my $i_name = $extreme->orig_i_name($partial);
|
|
my $i_description = $extreme->orig_i_description($partial);
|
|
my $interfaces = {};
|
|
foreach my $idx ( keys %$i_name ) {
|
|
if ( $i_name->{$idx} =~ /\([0-9.]+\)/ ) {
|
|
$interfaces->{$idx} = $i_description->{$idx};
|
|
}
|
|
else {
|
|
$interfaces->{$idx} = $i_name->{$idx};
|
|
}
|
|
}
|
|
return $interfaces;
|
|
}
|
|
|
|
#
|
|
# Ignore VLAN meta-interfaces and loopback
|
|
sub i_ignore {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
|
|
my $i_description = $extreme->i_description($partial) || {};
|
|
|
|
my %i_ignore;
|
|
foreach my $if ( keys %$i_description ) {
|
|
if ( $i_description->{$if}
|
|
=~ /^(802.1Q Encapsulation Tag \d+|VLAN \d+|lo\d+)/i )
|
|
{
|
|
$i_ignore{$if}++;
|
|
}
|
|
}
|
|
return \%i_ignore;
|
|
}
|
|
|
|
# When we use the extreme_fw_* objects, we're not using BRIDGE-MIB.
|
|
# Either way, Extreme uses a 1:1 mapping of bridge interface ID to
|
|
# ifIndex.
|
|
sub bp_index {
|
|
my $extreme = shift;
|
|
my $if_index = $extreme->i_index();
|
|
|
|
my %bp_index;
|
|
foreach my $iid ( keys %$if_index ) {
|
|
$bp_index{$iid} = $iid;
|
|
}
|
|
return \%bp_index;
|
|
}
|
|
|
|
sub munge_true_ok {
|
|
my $val = shift;
|
|
return unless defined($val);
|
|
return "OK" if ( $val eq 'true' );
|
|
return "Not OK" if ( $val eq 'false' );
|
|
return $val;
|
|
}
|
|
|
|
sub munge_power_stat {
|
|
my $val = shift;
|
|
return unless defined($val);
|
|
$val =~ s/^present//;
|
|
$val =~ s/^not/Not /i;
|
|
return $val;
|
|
}
|
|
|
|
sub ps1_status {
|
|
my $extreme = shift;
|
|
my $ps1_status = $extreme->ps1_status_new();
|
|
return $ps1_status || $extreme->ps1_status_old();
|
|
}
|
|
|
|
sub ps2_status {
|
|
my $extreme = shift;
|
|
my $ps2_status = $extreme->ps2_status_new();
|
|
return $ps2_status || $extreme->ps2_status_old();
|
|
}
|
|
|
|
sub fan {
|
|
my $extreme = shift;
|
|
my $fan_state = $extreme->fan_state();
|
|
my $ret = "";
|
|
my $s = "";
|
|
foreach my $i ( sort { $a <=> $b } keys %$fan_state ) {
|
|
$ret .= $s . $i . ": " . $fan_state->{$i};
|
|
$s = ", ";
|
|
}
|
|
return if ( $s eq "" );
|
|
return $ret;
|
|
}
|
|
|
|
# Newer versions of the Extreme firmware have vendor-specific tables
|
|
# for this; those are ex_fw_*(). Older firmware versions don't have
|
|
# these tables, so we use the BRIDGE-MIB tables.
|
|
sub fw_mac {
|
|
my $extreme = shift;
|
|
my $fw_mac = $extreme->ex_fw_mac;
|
|
return $fw_mac if defined($fw_mac);
|
|
return $extreme->orig_fw_mac();
|
|
}
|
|
|
|
sub fw_port {
|
|
my $extreme = shift;
|
|
my $fw_port = $extreme->ex_fw_port;
|
|
return $fw_port if defined($fw_port);
|
|
return $extreme->orig_fw_port();
|
|
}
|
|
|
|
sub fw_status {
|
|
my $extreme = shift;
|
|
my $fw_status = $extreme->ex_fw_status;
|
|
return $fw_status if defined($fw_status);
|
|
return $extreme->orig_fw_status();
|
|
}
|
|
|
|
# Mapping the virtual VLAN interfaces:
|
|
# The virtual VLAN interfaces in extremeVlanIfTable
|
|
# are the higher layer above the interfaces that are
|
|
# untagged, and also above an interface in
|
|
# extremeVlanEncapsIfTable that does the encapsulation.
|
|
# Note that it's possible to have a VLAN defined that
|
|
# does not have a tag, if it has all native interfaces.
|
|
# To represent this, we use a negative version of the
|
|
# internal VLAN ID (the deprecated extremeVlanIfGlobalIdentifier)
|
|
sub _if2tag {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
my $stack = shift || $extreme->ifStackStatus($partial);
|
|
my $encap_tag = $extreme->ex_vlan_encap_tag();
|
|
my $vlan_descr = $extreme->ex_vlan_descr();
|
|
|
|
my $stackmap = {};
|
|
foreach my $idx ( keys %$stack ) {
|
|
my ( $higher, $lower ) = split( /\./, $idx );
|
|
$stackmap->{$higher}->{$lower} = $stack->{$idx};
|
|
}
|
|
|
|
my %if2tag = ();
|
|
my $missed = 0;
|
|
foreach my $if ( keys %$vlan_descr ) {
|
|
$if2tag{$if} = -1;
|
|
foreach my $tagif ( keys %$encap_tag ) {
|
|
if ( defined( $stackmap->{$if}->{$tagif} )
|
|
&& $stackmap->{$if}->{$tagif} eq 'active' )
|
|
{
|
|
$if2tag{$if} = $encap_tag->{$tagif};
|
|
}
|
|
}
|
|
if ( $if2tag{$if} == -1 ) {
|
|
$missed++;
|
|
}
|
|
}
|
|
if ($missed) {
|
|
my $global_id = $extreme->ex_vlan_global_id();
|
|
foreach my $if ( keys %if2tag ) {
|
|
$if2tag{$if} = -$global_id->{$if}
|
|
if ( $if2tag{$if} == -1 && defined( $global_id->{$if} ) );
|
|
}
|
|
}
|
|
return \%if2tag;
|
|
}
|
|
|
|
# No partial support in v_name or v_index, because the obivous partial
|
|
# is the VLAN ID and the index here is the ifIndex of
|
|
# the VLAN interface.
|
|
sub v_name {
|
|
my $extreme = shift;
|
|
return $extreme->ex_vlan_descr();
|
|
}
|
|
|
|
sub v_index {
|
|
my $extreme = shift;
|
|
return $extreme->_if2tag();
|
|
}
|
|
|
|
sub i_vlan {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
my $stack = $extreme->ifStackStatus($partial);
|
|
my $encap_tag = $extreme->ex_vlan_encap_tag();
|
|
my $vlan_descr = $extreme->ex_vlan_descr();
|
|
my $stackmap = {};
|
|
foreach my $idx ( keys %$stack ) {
|
|
my ( $higher, $lower ) = split( /\./, $idx );
|
|
$stackmap->{$higher}->{$lower} = $stack->{$idx};
|
|
}
|
|
my $if2tag = $extreme->_if2tag( $partial, $stack );
|
|
|
|
#
|
|
# Now that we've done all that mapping work, we can map the
|
|
# ifStack indexes.
|
|
my %i_vlan = ();
|
|
foreach my $if ( keys %$if2tag ) {
|
|
foreach my $lowif ( keys %{ $stackmap->{$if} } ) {
|
|
$i_vlan{$lowif} = $if2tag->{$if};
|
|
}
|
|
}
|
|
return \%i_vlan;
|
|
}
|
|
|
|
sub i_vlan_membership {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
my $stack = $extreme->ifStackStatus($partial);
|
|
my $encap_tag = $extreme->ex_vlan_encap_tag();
|
|
my $vlan_descr = $extreme->ex_vlan_descr();
|
|
my $stackmap = {};
|
|
foreach my $idx ( keys %$stack ) {
|
|
my ( $higher, $lower ) = split( /\./, $idx );
|
|
$stackmap->{$higher}->{$lower} = $stack->{$idx};
|
|
}
|
|
my $if2tag = $extreme->_if2tag( $partial, $stack );
|
|
|
|
#
|
|
# Now that we've done all that mapping work, we can map the
|
|
# ifStack indexes.
|
|
my %i_vlan_membership = ();
|
|
foreach my $if ( keys %$if2tag ) {
|
|
foreach my $lowif ( keys %{ $stackmap->{$if} } ) {
|
|
push( @{ $i_vlan_membership{$lowif} }, $if2tag->{$if} );
|
|
}
|
|
}
|
|
|
|
#
|
|
# Now add all the tagged ports.
|
|
foreach my $if ( keys %$encap_tag ) {
|
|
foreach my $lowif ( keys %{ $stackmap->{$if} } ) {
|
|
push( @{ $i_vlan_membership{$lowif} }, $encap_tag->{$if} );
|
|
}
|
|
}
|
|
return \%i_vlan_membership;
|
|
}
|
|
|
|
# VLAN management.
|
|
# See extreme-vlan.mib for a detailed description of
|
|
# Extreme's use of ifStackTable and EXTREME-VLAN-MIB.
|
|
|
|
sub set_i_vlan {
|
|
my $extreme = shift;
|
|
return $extreme->_extreme_set_i_vlan( 0, @_ );
|
|
}
|
|
|
|
sub set_i_pvid {
|
|
my $extreme = shift;
|
|
return $extreme->_extreme_set_i_vlan( 1, @_ );
|
|
}
|
|
|
|
# set_i_vlan implicitly turns off any encapsulation
|
|
# set_i_pvid retains any encapsulation
|
|
# otherwise they do the same: set the unencapsulated
|
|
# vlan ID.
|
|
# First arg to _set_i_vlan is whether or not to turn
|
|
# off any encapsulation.
|
|
sub _extreme_set_i_vlan {
|
|
my $extreme = shift;
|
|
my ( $is_pvid, $vlan_id, $ifindex ) = @_;
|
|
my $encap_tag = $extreme->ex_vlan_encap_tag();
|
|
|
|
# The inverted stack MIB would make this easier, since
|
|
# we need to find the vlan interface
|
|
# that's stacked above $ifindex.
|
|
my $cur_stack = $extreme->ifStackStatus();
|
|
|
|
#
|
|
# create inverted stack
|
|
my $invstack;
|
|
foreach my $idx ( keys %$cur_stack ) {
|
|
my ( $higher, $lower ) = split( /\./, $idx );
|
|
$invstack->{$lower}->{$higher} = $cur_stack->{$idx};
|
|
}
|
|
|
|
# create vlan tag -> encap interface map
|
|
my %encapif = reverse %$encap_tag;
|
|
|
|
# now find encap interface from tag
|
|
my $encapidx = $encapif{$vlan_id};
|
|
if ( !defined($encapidx) ) {
|
|
$extreme->error_throw(
|
|
"can't map $vlan_id to encapsulation interface");
|
|
return;
|
|
}
|
|
|
|
# now find vlan interface stacked above encap
|
|
my @abovevlan = keys %{ $invstack->{$encapidx} };
|
|
if ( @abovevlan != 1 ) {
|
|
$extreme->error_throw(
|
|
"can't map encap interface $encapidx for $vlan_id to encapsulation interface"
|
|
);
|
|
return;
|
|
}
|
|
my $vlanidx = $abovevlan[0];
|
|
my $rv;
|
|
|
|
# Delete old VLAN mapping
|
|
foreach my $oldidx ( keys %{ $invstack->{$ifindex} } ) {
|
|
if ( $is_pvid && defined( $encap_tag->{$oldidx} ) ) {
|
|
next; # Don't delete tagged mappings
|
|
}
|
|
$rv = $extreme->set_ifStackStatus( "destroy",
|
|
$oldidx . "." . $ifindex );
|
|
unless ($rv) {
|
|
$extreme->error_throw(
|
|
"Unable to remove $ifindex from old VLAN index $oldidx");
|
|
return;
|
|
}
|
|
}
|
|
|
|
# Add new VLAN mapping
|
|
$rv = $extreme->set_ifStackStatus( "createAndGo",
|
|
$vlanidx . "." . $ifindex );
|
|
unless ($rv) {
|
|
$extreme->error_throw(
|
|
"Unable to add new VLAN index $vlanidx to ifIndex $ifindex");
|
|
return;
|
|
}
|
|
|
|
# XXX invalidate cache of ifstack?
|
|
# XXX Info.pm library function for this?
|
|
# XXX set_ should do invalidation?
|
|
# $store = $extreme->store(); delete $store->{ifStackStatus}; $extreme->store($store);
|
|
# $extreme->{_ifStackStatus} = 0;
|
|
return $rv;
|
|
}
|
|
|
|
sub set_remove_i_vlan_tagged {
|
|
my $extreme = shift;
|
|
my ( $vlan_id, $ifindex ) = @_;
|
|
my $encap_tag = $extreme->ex_vlan_encap_tag();
|
|
|
|
# create vlan tag -> encap interface map
|
|
my %encapif = reverse %$encap_tag;
|
|
|
|
# now find encap interface from tag
|
|
my $encapidx = $encapif{$vlan_id};
|
|
if ( !defined($encapidx) ) {
|
|
$extreme->error_throw(
|
|
"can't map $vlan_id to encapsulation interface");
|
|
return;
|
|
}
|
|
my $rv = $extreme->set_ifStackStatus( "destroy",
|
|
$encapidx . "." . $ifindex );
|
|
unless ($rv) {
|
|
$extreme->error_throw(
|
|
"Unable to delete VLAN encap ifIndex $encapidx for VLAN $vlan_id from ifIndex $ifindex"
|
|
);
|
|
return;
|
|
}
|
|
|
|
# invalidate cache of ifstack?
|
|
return $rv;
|
|
}
|
|
|
|
sub set_add_i_vlan_tagged {
|
|
my $extreme = shift;
|
|
my ( $vlan_id, $ifindex ) = @_;
|
|
my $encap_tag = $extreme->ex_vlan_encap_tag();
|
|
|
|
# create vlan tag -> encap interface map
|
|
my %encapif = reverse %$encap_tag;
|
|
|
|
# now find encap interface from tag
|
|
my $encapidx = $encapif{$vlan_id};
|
|
if ( !defined($encapidx) ) {
|
|
$extreme->error_throw(
|
|
"can't map $vlan_id to encapsulation interface");
|
|
return;
|
|
}
|
|
my $rv = $extreme->set_ifStackStatus( "createAndGo",
|
|
$encapidx . "." . $ifindex );
|
|
unless ($rv) {
|
|
$extreme->error_throw(
|
|
"Unable to add VLAN encap ifIndex $encapidx for VLAN $vlan_id to ifIndex $ifindex"
|
|
);
|
|
return;
|
|
}
|
|
|
|
# invalidate cache of ifstack?
|
|
return $rv;
|
|
}
|
|
|
|
# Use EDP and/or LLDP
|
|
sub hasCDP {
|
|
my $extreme = shift;
|
|
|
|
return $extreme->hasLLDP() || $extreme->hasEDP();
|
|
}
|
|
|
|
sub c_ip {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
|
|
my $edp = $extreme->edp_ip() || {};
|
|
my $lldp = $extreme->lldp_ip($partial) || {};
|
|
|
|
my %c_ip;
|
|
foreach my $iid ( keys %$edp ) {
|
|
my $ip = $edp->{$iid};
|
|
next unless defined $ip;
|
|
|
|
$c_ip{$iid} = $ip;
|
|
}
|
|
|
|
foreach my $iid ( keys %$lldp ) {
|
|
my $ip = $lldp->{$iid};
|
|
next unless defined $ip;
|
|
|
|
$c_ip{$iid} = $ip;
|
|
}
|
|
return \%c_ip;
|
|
}
|
|
|
|
sub c_if {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
|
|
my $lldp = $extreme->lldp_if($partial) || {};
|
|
my $edp = $extreme->edp_if() || {};
|
|
|
|
my %c_if;
|
|
foreach my $iid ( keys %$edp ) {
|
|
my $if = $edp->{$iid};
|
|
next unless defined $if;
|
|
|
|
$c_if{$iid} = $if;
|
|
}
|
|
|
|
foreach my $iid ( keys %$lldp ) {
|
|
my $if = $lldp->{$iid};
|
|
next unless defined $if;
|
|
|
|
$c_if{$iid} = $if;
|
|
}
|
|
return \%c_if;
|
|
}
|
|
|
|
sub c_port {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
|
|
my $lldp = $extreme->lldp_port($partial) || {};
|
|
my $edp = $extreme->edp_port() || {};
|
|
|
|
my %c_port;
|
|
foreach my $iid ( keys %$edp ) {
|
|
my $port = $edp->{$iid};
|
|
next unless defined $port;
|
|
|
|
$c_port{$iid} = $port;
|
|
}
|
|
|
|
foreach my $iid ( keys %$lldp ) {
|
|
my $port = $lldp->{$iid};
|
|
next unless defined $port;
|
|
$c_port{$iid} = $port;
|
|
}
|
|
return \%c_port;
|
|
}
|
|
|
|
sub c_id {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
|
|
my $lldp = $extreme->lldp_id($partial) || {};
|
|
my $edp = $extreme->edp_id() || {};
|
|
|
|
my %c_id;
|
|
foreach my $iid ( keys %$edp ) {
|
|
my $id = $edp->{$iid};
|
|
next unless defined $id;
|
|
|
|
$c_id{$iid} = $id;
|
|
}
|
|
|
|
foreach my $iid ( keys %$lldp ) {
|
|
my $id = $lldp->{$iid};
|
|
next unless defined $id;
|
|
|
|
$c_id{$iid} = $id;
|
|
}
|
|
return \%c_id;
|
|
}
|
|
|
|
sub c_platform {
|
|
my $extreme = shift;
|
|
my $partial = shift;
|
|
|
|
my $lldp = $extreme->lldp_rem_sysdesc($partial) || {};
|
|
|
|
my %c_platform;
|
|
|
|
foreach my $iid ( keys %$lldp ) {
|
|
my $platform = $lldp->{$iid};
|
|
next unless defined $platform;
|
|
|
|
$c_platform{$iid} = $platform;
|
|
}
|
|
return \%c_platform;
|
|
}
|
|
|
|
1;
|
|
|
|
__END__
|
|
|
|
=head1 NAME
|
|
|
|
SNMP::Info::Layer3::Extreme - Perl5 Interface to Extreme Network Devices
|
|
|
|
=head1 AUTHOR
|
|
|
|
Eric Miller, Bill Fenner
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
# Let SNMP::Info determine the correct subclass for you.
|
|
my $extreme = new SNMP::Info(
|
|
AutoSpecify => 1,
|
|
Debug => 1,
|
|
DestHost => 'myswitch',
|
|
Community => 'public',
|
|
Version => 1
|
|
)
|
|
or die "Can't connect to DestHost.\n";
|
|
|
|
my $class = $extreme->class();
|
|
|
|
print "SNMP::Info determined this device to fall under subclass : $class\n";
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
Provides abstraction to the configuration information obtainable from an
|
|
Extreme 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 $extreme = new SNMP::Info::Layer3::Extreme(...);
|
|
|
|
=head2 Inherited Classes
|
|
|
|
=over
|
|
|
|
=item SNMP::Info::Layer3
|
|
|
|
=item SNMP::Info::MAU
|
|
|
|
=item SNMP::Info::LLDP
|
|
|
|
=item SNMP::Info::EDP
|
|
|
|
=back
|
|
|
|
=head2 Required MIBs
|
|
|
|
=over
|
|
|
|
=item F<EXTREME-BASE-MIB>
|
|
|
|
=item F<EXTREME-SYSTEM-MIB>
|
|
|
|
=item F<EXTREME-FDB-MIB>
|
|
|
|
=item F<EXTREME-VLAN-MIB>
|
|
|
|
=item F<EXTREME-POE-MIB>
|
|
|
|
=item Inherited Classes' MIBs
|
|
|
|
See classes listed above for their required MIBs.
|
|
|
|
=back
|
|
|
|
=head1 GLOBALS
|
|
|
|
These are methods that return scalar value from SNMP
|
|
|
|
=over
|
|
|
|
=item $extreme->model()
|
|
|
|
Returns model type. Checks $extreme->id() against the F<EXTREME-BASE-MIB>.
|
|
|
|
=item $extreme->vendor()
|
|
|
|
Returns extreme
|
|
|
|
=item $extreme->os()
|
|
|
|
Returns extreme
|
|
|
|
=item $extreme->os_ver()
|
|
|
|
Parses device operating system version from description()
|
|
|
|
=item $extreme->serial()
|
|
|
|
Returns serial number
|
|
|
|
(C<extremeSystemID>)
|
|
|
|
=item $extreme->temp()
|
|
|
|
Returns system temperature
|
|
|
|
(C<extremeCurrentTemperature>)
|
|
|
|
=item $extreme->ps1_status()
|
|
|
|
Returns status of power supply 1
|
|
|
|
(C<extremePowerSupplyStatus.1>)
|
|
|
|
=item $extreme->ps2_status()
|
|
|
|
Returns status of power supply 2
|
|
|
|
(C<extremePowerSupplyStatus.2>)
|
|
|
|
=item $extreme->fan()
|
|
|
|
Returns fan status
|
|
|
|
(C<extremeFanOperational.1>)
|
|
|
|
=item $extreme->mac()
|
|
|
|
Returns base mac
|
|
|
|
(C<dot1dBaseBridgeAddress>)
|
|
|
|
=back
|
|
|
|
=head2 Globals imported from SNMP::Info::Layer3
|
|
|
|
See documentation in L<SNMP::Info::Layer3/"GLOBALS"> for details.
|
|
|
|
=head2 Globals imported from SNMP::Info::MAU
|
|
|
|
See documentation in L<SNMP::Info::MAU/"GLOBALS"> for details.
|
|
|
|
=head2 Globals imported from SNMP::Info::LLDP
|
|
|
|
See documentation in L<SNMP::Info::LLDP/"GLOBALS"> for details.
|
|
|
|
=head2 Globals imported from SNMP::Info::EDP
|
|
|
|
See documentation in L<SNMP::Info::EDP/"GLOBALS"> for details.
|
|
|
|
=head1 TABLE METHODS
|
|
|
|
These are methods that return tables of information in the form of a reference
|
|
to a hash.
|
|
|
|
=head2 Overrides
|
|
|
|
=over
|
|
|
|
=item $extreme->interfaces()
|
|
|
|
Returns a mapping between the Interface Table Index (iid) and the physical
|
|
port name.
|
|
|
|
=item $extreme->i_duplex()
|
|
|
|
Parses mau_index and mau_link to return the duplex information for
|
|
interfaces.
|
|
|
|
=item $extreme->i_duplex_admin()
|
|
|
|
Parses C<mac_index>,C<mau_autostat>,C<mau_type_admin> in
|
|
order to find the admin duplex setting for all the interfaces.
|
|
|
|
Returns either (auto,full,half).
|
|
|
|
=item $extreme->i_ignore()
|
|
|
|
Returns reference to hash. Increments value of IID if port is to be ignored.
|
|
|
|
Ignores VLAN meta interfaces and loopback
|
|
|
|
=item $extreme->fw_mac()
|
|
|
|
(C<extremeFdbMacFdbMacAddress>)
|
|
|
|
=item $extreme->fw_port()
|
|
|
|
(C<extremeFdbMacFdbPortIfIndex>)
|
|
|
|
=item $extreme->fw_status()
|
|
|
|
(C<extremeFdbMacFdbStatus>)
|
|
|
|
=item $extreme->i_vlan()
|
|
|
|
Returns a mapping between C<ifIndex> and the VLAN.
|
|
|
|
=item $extreme->i_vlan_membership()
|
|
|
|
Returns reference to hash of arrays: key = C<ifIndex>, value = array of VLAN
|
|
IDs. These are the VLANs which are members of the egress list for the port.
|
|
|
|
Example:
|
|
my $interfaces = $extreme->interfaces();
|
|
my $vlans = $extreme->i_vlan_membership();
|
|
|
|
foreach my $iid (sort keys %$interfaces) {
|
|
my $port = $interfaces->{$iid};
|
|
my $vlan = join(',', sort(@{$vlans->{$iid}}));
|
|
print "Port: $port VLAN: $vlan\n";
|
|
}
|
|
|
|
=item $extreme->v_index()
|
|
|
|
Returns VLAN IDs
|
|
|
|
=item $extreme->v_name()
|
|
|
|
Returns VLAN names
|
|
|
|
(C<extremeVlanIfDescr>)
|
|
|
|
=item $extreme->bp_index()
|
|
|
|
Returns reference to hash of bridge port table entries map back to interface
|
|
identifier (iid)
|
|
|
|
Returns (C<ifIndex>) for both key and value since we're using
|
|
F<EXTREME-FDB-MIB> rather than F<BRIDGE-MIB>.
|
|
|
|
=item $extreme->peth_port_power()
|
|
|
|
Power supplied by PoE ports, in milliwatts
|
|
("extremePethPortMeasuredPower")
|
|
|
|
=back
|
|
|
|
=head2 Topology information
|
|
|
|
Based upon the firmware version Extreme devices may support Extreme Discovery
|
|
Protocol (EDP), Link Layer Discovery Protocol (LLDP), or both. These methods
|
|
will query both 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.
|
|
|
|
=over
|
|
|
|
=item $extreme->hasCDP()
|
|
|
|
Returns true if the device is running either EDP or LLDP.
|
|
|
|
=item $extreme->c_if()
|
|
|
|
Returns reference to hash. Key: iid Value: local device port (interfaces)
|
|
|
|
=item $extreme->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.
|
|
|
|
With EDP multiple entries may exist with the same local port, c_if(), and
|
|
different IPv4 addresses, c_ip(), as EDP reports addresses for each VLAN
|
|
transported across the trunk. In the case of LLDP with multiple addresses
|
|
there is either a non-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.
|
|
|
|
=item $extreme->c_port()
|
|
|
|
Returns reference to hash. Key: iid Value: remote port (interfaces)
|
|
|
|
=item $extreme->c_id()
|
|
|
|
Returns reference to hash. Key: iid Value: string value used to identify the
|
|
chassis component associated with the remote system.
|
|
|
|
=item $extreme->c_platform()
|
|
|
|
Returns reference to hash. Key: iid Value: Remote Device Type
|
|
|
|
This information is only available from LLDP. EDP does not provide an
|
|
equivalent.
|
|
|
|
=back
|
|
|
|
=head2 Table Methods imported from SNMP::Info::Layer3
|
|
|
|
See documentation in L<SNMP::Info::Layer3/"TABLE METHODS"> for details.
|
|
|
|
=head2 Table Methods imported from SNMP::Info::MAU
|
|
|
|
See documentation in L<SNMP::Info::MAU/"TABLE METHODS"> for details.
|
|
|
|
=head2 Table Methods imported from SNMP::Info::LLDP
|
|
|
|
See documentation in L<SNMP::Info::LLDP/"TABLE METHODS"> for details.
|
|
|
|
=head2 Table Methods imported from SNMP::Info::EDP
|
|
|
|
See documentation in L<SNMP::Info::EDP/"TABLE METHODS"> for details.
|
|
|
|
=head1 SET METHODS
|
|
|
|
These are methods that provide SNMP set functionality for overridden methods
|
|
or provide a simpler interface to complex set operations. See
|
|
L<SNMP::Info/"SETTING DATA VIA SNMP"> for general information on set
|
|
operations.
|
|
|
|
=over
|
|
|
|
=item $extreme->set_i_vlan ( vlan, ifIndex )
|
|
|
|
Changes an access (untagged) port VLAN, must be supplied with the numeric
|
|
VLAN ID and port C<ifIndex>. This method should only be used on end station
|
|
(non-trunk) ports.
|
|
|
|
Example:
|
|
my %if_map = reverse %{$extreme->interfaces()};
|
|
$extreme->set_i_vlan('2', $if_map{'FastEthernet0/1'})
|
|
or die "Couldn't change port VLAN. ",$extreme->error(1);
|
|
|
|
=item $extreme->set_i_pvid ( pvid, ifIndex )
|
|
|
|
Sets port default VLAN, must be supplied with the numeric VLAN ID and
|
|
port C<ifIndex>. This method should only be used on trunk ports.
|
|
|
|
Example:
|
|
my %if_map = reverse %{$extreme->interfaces()};
|
|
$extreme->set_i_pvid('2', $if_map{'FastEthernet0/1'})
|
|
or die "Couldn't change port default VLAN. ",$extreme->error(1);
|
|
|
|
=item $extreme->set_add_i_vlan_tagged ( vlan, ifIndex )
|
|
|
|
Adds the VLAN to the enabled VLANs list of the port, must be supplied with the
|
|
numeric VLAN ID and port C<ifIndex>.
|
|
|
|
Example:
|
|
my %if_map = reverse %{$extreme->interfaces()};
|
|
$extreme->set_add_i_vlan_tagged('2', $if_map{'FastEthernet0/1'})
|
|
or die "Couldn't add port to egress list. ",$extreme->error(1);
|
|
|
|
=item $extreme->set_remove_i_vlan_tagged ( vlan, ifIndex )
|
|
|
|
Removes the VLAN from the enabled VLANs list of the port, must be supplied
|
|
with the numeric VLAN ID and port C<ifIndex>.
|
|
|
|
Example:
|
|
my %if_map = reverse %{$extreme->interfaces()};
|
|
$extreme->set_remove_i_vlan_tagged('2', $if_map{'FastEthernet0/1'})
|
|
or die "Couldn't add port to egress list. ",$extreme->error(1);
|
|
|
|
=back
|
|
|
|
=head1 Data Munging Callback Subroutines
|
|
|
|
=over
|
|
|
|
=item $extreme->munge_power_stat()
|
|
|
|
Removes 'present' and changes 'not' to 'Not' in the front of a string.
|
|
|
|
=item $extreme->munge_true_ok()
|
|
|
|
Replaces 'true' with "OK" and 'false' with "Not OK".
|
|
|
|
=back
|
|
|
|
=cut
|