From 2b3674dcaebbfa9a2eacf13c1029c2f1535e1fc2 Mon Sep 17 00:00:00 2001 From: Ambroise Date: Tue, 21 Sep 2021 16:51:10 +0200 Subject: [PATCH] Add support for Riverbed SteelheadEx and Steelfusion (#438) * Retrieve Serial Number and device type for CheckPoint devices at right place in MIB * Add support for SteelheadEx and Steelfusion * Update Info.pm * fix tests Co-authored-by: Oliver Gorwits Co-authored-by: Oliver Gorwits --- lib/SNMP/Info.pm | 20 ++- lib/SNMP/Info/Layer3/Steelfusion.pm | 213 ++++++++++++++++++++++++++++ lib/SNMP/Info/Layer3/SteelheadEx.pm | 213 ++++++++++++++++++++++++++++ 3 files changed, 445 insertions(+), 1 deletion(-) create mode 100644 lib/SNMP/Info/Layer3/Steelfusion.pm create mode 100644 lib/SNMP/Info/Layer3/SteelheadEx.pm diff --git a/lib/SNMP/Info.pm b/lib/SNMP/Info.pm index ceb26ea7..8a7b070b 100644 --- a/lib/SNMP/Info.pm +++ b/lib/SNMP/Info.pm @@ -1032,12 +1032,24 @@ Subclass for generic SonicWALL devices. See documentation in L for details. +=item SNMP::Info::Layer3::Steelfusion + +Subclass for Riverbed Steelfusion WAN optimization appliances. + +See documentation in L for details. + =item SNMP::Info::Layer3::Steelhead Subclass for Riverbed Steelhead WAN optimization appliances. See documentation in L for details. +=item SNMP::Info::Layer3::SteelheadEx + +Subclass for Riverbed SteelheadEx WAN optimization appliances. + +See documentation in L for details. + =item SNMP::Info::Layer3::Sun Subclass for Generic Sun Routers running SunOS. @@ -1962,7 +1974,13 @@ sub device_type { if ( $desc =~ /\bTeltonika.*RUT9\d{2}\b/); - # Whiterabbit Timing + # Riverbed Steelfusion + $objtype = 'SNMP::Info::Layer3::SteelheadEx' + if ( $soid =~ /\.1\.3\.6\.1\.4\.1\.17163\.1\.51/i ); + $objtype = 'SNMP::Info::Layer3::Steelfusion' + if ( $soid =~ /\.1\.3\.6\.1\.4\.1\.17163\.1\.52/i ); + + # Whiterabbit Timing $objtype = 'SNMP::Info::Layer3::Whiterabbit' if ( $soid =~ /\.1\.3\.6\.1\.4\.1\.96\.100\.1000/i ); diff --git a/lib/SNMP/Info/Layer3/Steelfusion.pm b/lib/SNMP/Info/Layer3/Steelfusion.pm new file mode 100644 index 00000000..a3f182fe --- /dev/null +++ b/lib/SNMP/Info/Layer3/Steelfusion.pm @@ -0,0 +1,213 @@ +# SNMP::Info::Layer3::Steelfusion +# +# Copyright (c) 2013 Eric Miller +# 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::Steelfusion; + +use strict; +use warnings; +use Exporter; +use SNMP::Info::Layer3; + +@SNMP::Info::Layer3::Steelfusion::ISA + = qw/SNMP::Info::Layer3 Exporter/; +@SNMP::Info::Layer3::Steelfusion::EXPORT_OK = qw//; + +our ($VERSION, %GLOBALS, %FUNCS, %MIBS, %MUNGE); + +$VERSION = '3.78'; + +%MIBS = ( + %SNMP::Info::Layer3::MIBS, + 'STEELFUSIN-MIB' => 'serialNumber', +); + +%GLOBALS = ( + %SNMP::Info::Layer3::GLOBALS, + # Fully qualified to remove ambiguity of 'model' + 'rb_model' => 'STEELFUSION-MIB::model', +); + +%FUNCS = ( + %SNMP::Info::Layer3::FUNCS, +); + +%MUNGE = ( + %SNMP::Info::Layer3::MUNGE, +); + +sub layers { + return '01001100'; +} + +sub vendor { + return 'riverbed'; +} + +sub model { + my $riverbed = shift; + + my $model = $riverbed->rb_model() || ''; + + if ($model =~ /^(\d+)/) { + return $1; + } + return $model; +} + +sub os { + return 'steelfusion'; +} + +sub os_ver { + my $riverbed = shift; + + my $ver = $riverbed->systemVersion() || ''; + + if ( $ver =~ /(\d+[\.\d]+)/ ) { + return $1; + } + + return $ver; +} + +sub serial { + my $riverbed = shift; + + return $riverbed->serialNumber(); +} + +1; +__END__ + +=head1 NAME + +SNMP::Info::Layer3::Steelfusion - SNMP Interface to Riverbed Steelhead WAN +optimization appliances. + +=head1 AUTHOR + +Eric Miller + +=head1 SYNOPSIS + + # Let SNMP::Info determine the correct subclass for you. + my $riverbed = new SNMP::Info( + AutoSpecify => 1, + Debug => 1, + DestHost => 'myswitch', + Community => 'public', + Version => 2 + ) + or die "Can't connect to DestHost.\n"; + + my $class = $riverbed->class(); + print "SNMP::Info determined this device to fall under subclass : $class\n"; + +=head1 DESCRIPTION + +Abstraction subclass for Riverbed Steelhead WAN optimization appliances. + + +=head2 Inherited Classes + +=over + +=item SNMP::Info::Layer3 + +=back + +=head2 Required MIBs + +F + +=over + +=item Inherited Classes' MIBs + +See L for its own MIB requirements. + +=back + +=head1 GLOBALS + +These are methods that return scalar value from SNMP + +=over + +=item $riverbed->vendor() + +Returns 'riverbed' + +=item $riverbed->model() + +Returns the chassis model. + +(C) + +=item $riverbed->os() + +Returns 'steelhead' + +=item $riverbed->os_ver() + +Returns the software version extracted from (C). + +=item $riverbed->serial() + +Returns the chassis serial number. + +(C) + +=back + +=head2 Overrides + +=over + +=item $riverbed->layers() + +Returns 01001100. Steelhead does not support bridge MIB, so override reported +layers. + +=back + +=head2 Globals imported from SNMP::Info::Layer3 + +See documentation in L for details. + +=head1 TABLE METHODS + +These are methods that return tables of information in the form of a reference +to a hash. + +=head2 Table Methods imported from SNMP::Info::Layer3 + +See documentation in L for details. + +=cut diff --git a/lib/SNMP/Info/Layer3/SteelheadEx.pm b/lib/SNMP/Info/Layer3/SteelheadEx.pm new file mode 100644 index 00000000..5ecbf410 --- /dev/null +++ b/lib/SNMP/Info/Layer3/SteelheadEx.pm @@ -0,0 +1,213 @@ +# SNMP::Info::Layer3::SteelheadEx +# +# Copyright (c) 2013 Eric Miller +# 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::SteelheadEx; + +use strict; +use warnings; +use Exporter; +use SNMP::Info::Layer3; + +@SNMP::Info::Layer3::SteelheadEx::ISA + = qw/SNMP::Info::Layer3 Exporter/; +@SNMP::Info::Layer3::SteelheadEx::EXPORT_OK = qw//; + +our ($VERSION, %GLOBALS, %FUNCS, %MIBS, %MUNGE); + +$VERSION = '3.78'; + +%MIBS = ( + %SNMP::Info::Layer3::MIBS, + 'STEELHEAD-EX-MIB' => 'serialNumber', +); + +%GLOBALS = ( + %SNMP::Info::Layer3::GLOBALS, + # Fully qualified to remove ambiguity of 'model' + 'rb_model' => 'STEELHEAD-EX-MIB::model', +); + +%FUNCS = ( + %SNMP::Info::Layer3::FUNCS, +); + +%MUNGE = ( + %SNMP::Info::Layer3::MUNGE, +); + +sub layers { + return '01001100'; +} + +sub vendor { + return 'riverbed'; +} + +sub model { + my $riverbed = shift; + + my $model = $riverbed->rb_model() || ''; + + if ($model =~ /^(\d+)/) { + return $1; + } + return $model; +} + +sub os { + return 'steelhead-ex'; +} + +sub os_ver { + my $riverbed = shift; + + my $ver = $riverbed->systemVersion() || ''; + + if ( $ver =~ /(\d+[\.\d]+)/ ) { + return $1; + } + + return $ver; +} + +sub serial { + my $riverbed = shift; + + return $riverbed->serialNumber(); +} + +1; +__END__ + +=head1 NAME + +SNMP::Info::Layer3::SteelheadEx - SNMP Interface to Riverbed Steelhead WAN +optimization appliances. + +=head1 AUTHOR + +Eric Miller + +=head1 SYNOPSIS + + # Let SNMP::Info determine the correct subclass for you. + my $riverbed = new SNMP::Info( + AutoSpecify => 1, + Debug => 1, + DestHost => 'myswitch', + Community => 'public', + Version => 2 + ) + or die "Can't connect to DestHost.\n"; + + my $class = $riverbed->class(); + print "SNMP::Info determined this device to fall under subclass : $class\n"; + +=head1 DESCRIPTION + +Abstraction subclass for Riverbed Steelhead WAN optimization appliances. + + +=head2 Inherited Classes + +=over + +=item SNMP::Info::Layer3 + +=back + +=head2 Required MIBs + +F + +=over + +=item Inherited Classes' MIBs + +See L for its own MIB requirements. + +=back + +=head1 GLOBALS + +These are methods that return scalar value from SNMP + +=over + +=item $riverbed->vendor() + +Returns 'riverbed' + +=item $riverbed->model() + +Returns the chassis model. + +(C) + +=item $riverbed->os() + +Returns 'steelhead' + +=item $riverbed->os_ver() + +Returns the software version extracted from (C). + +=item $riverbed->serial() + +Returns the chassis serial number. + +(C) + +=back + +=head2 Overrides + +=over + +=item $riverbed->layers() + +Returns 01001100. Steelhead does not support bridge MIB, so override reported +layers. + +=back + +=head2 Globals imported from SNMP::Info::Layer3 + +See documentation in L for details. + +=head1 TABLE METHODS + +These are methods that return tables of information in the form of a reference +to a hash. + +=head2 Table Methods imported from SNMP::Info::Layer3 + +See documentation in L for details. + +=cut