Add initial support for Teltonika RUT9xx routers (#386)
Note that Teltonika routers run the net-snmp agent and can present the net-snmp enterprise ID; if so, configure the following through the router CLI to be identified as Teltonika and to be picked up by this device class:
uci set snmpd.@system[0].sysObjectID=.1.3.6.1.4.1.48690
uci commit
ubus call uci commit '{"config":"snmpd"}'
This commit is contained in:
Jeroen van Ingen Schenau
committed by
GitHub
GitHub
parent
543072ca25
commit
a263f54744
6
Changes
6
Changes
@@ -1,3 +1,9 @@
|
||||
Version 3.xx (xxxx-xx-xx)
|
||||
|
||||
[NEW FEATURES]
|
||||
|
||||
* Teltonika RUT9XX support
|
||||
|
||||
Version 3.70 (2019-10-15)
|
||||
|
||||
[NEW FEATURES]
|
||||
|
||||
@@ -1038,6 +1038,12 @@ Subclass for Avaya Secure Routers.
|
||||
|
||||
See documentation in L<SNMP::Info::Layer3::Tasman> for details.
|
||||
|
||||
=item SNMP::Info::Layer3::Teltonika
|
||||
|
||||
Subclass for Teltonika RUT9xx series routers.
|
||||
|
||||
See documentation in L<SNMP::Info::Layer3::Teltonika> for details.
|
||||
|
||||
=item SNMP::Info::Layer3::Timetra
|
||||
|
||||
Alcatel-Lucent SR Class.
|
||||
@@ -1723,6 +1729,7 @@ sub device_type {
|
||||
40310 => 'SNMP::Info::Layer3::Cumulus',
|
||||
41112 => 'SNMP::Info::Layer2::Ubiquiti',
|
||||
44641 => 'SNMP::Info::Layer3::VyOS',
|
||||
48690 => 'SNMP::Info::Layer3::Teltonika',
|
||||
);
|
||||
|
||||
my %l2sysoidmap = (
|
||||
@@ -1760,6 +1767,7 @@ sub device_type {
|
||||
21091 => 'SNMP::Info::Layer2::Exinda',
|
||||
26543 => 'SNMP::Info::Layer3::IBMGbTor',
|
||||
26928 => 'SNMP::Info::Layer2::Aerohive',
|
||||
48690 => 'SNMP::Info::Layer3::Teltonika',
|
||||
);
|
||||
|
||||
my %l1sysoidmap = (
|
||||
@@ -1923,6 +1931,10 @@ sub device_type {
|
||||
$objtype = 'SNMP::Info::Layer3::Scalance'
|
||||
if ( $soid =~ /\.1\.3\.6\.1\.4\.1\.4329\.6\.1\.2/i );
|
||||
|
||||
# Teltonika RUT9xx Series
|
||||
$objtype = 'SNMP::Info::Layer3::Teltonika'
|
||||
if (
|
||||
$desc =~ /\bTeltonika.*RUT9\d{2}\b/);
|
||||
|
||||
# Generic device classification based upon sysObjectID
|
||||
if ( ( $objtype eq 'SNMP::Info::Layer3' )
|
||||
@@ -2134,6 +2146,11 @@ sub device_type {
|
||||
$objtype = 'SNMP::Info::Layer3::Scalance'
|
||||
if ( $soid =~ /\.1\.3\.6\.1\.4\.1\.4329\.6\.1\.2/i );
|
||||
|
||||
# Teltonika RUT9xx Series
|
||||
$objtype = 'SNMP::Info::Layer3::Teltonika'
|
||||
if (
|
||||
$desc =~ /\bTeltonika.*RUT9\d{2}\b/);
|
||||
|
||||
# Generic device classification based upon sysObjectID
|
||||
if ( defined($id) and $objtype eq 'SNMP::Info') {
|
||||
if ( defined $l3sysoidmap{$id} ) {
|
||||
|
||||
172
lib/SNMP/Info/Layer3/Teltonika.pm
Normal file
172
lib/SNMP/Info/Layer3/Teltonika.pm
Normal file
@@ -0,0 +1,172 @@
|
||||
# SNMP::Info::Layer3::Teltonika
|
||||
#
|
||||
# Copyright (c) 2020 Jeroen van Ingen
|
||||
# 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::Teltonika;
|
||||
|
||||
use strict;
|
||||
use warnings;
|
||||
use Exporter;
|
||||
use SNMP::Info::Layer3;
|
||||
|
||||
@SNMP::Info::Layer3::Teltonika::ISA = qw/SNMP::Info::Layer3 Exporter/;
|
||||
@SNMP::Info::Layer3::Teltonika::EXPORT_OK = qw//;
|
||||
|
||||
our ($VERSION, %GLOBALS, %MIBS, %FUNCS, %MUNGE);
|
||||
|
||||
$VERSION = '3.70';
|
||||
|
||||
%MIBS = (
|
||||
%SNMP::Info::Layer3::MIBS,
|
||||
'UCD-SNMP-MIB' => 'versionTag',
|
||||
'NET-SNMP-TC' => 'netSnmpAliasDomain',
|
||||
'HOST-RESOURCES-MIB' => 'hrSystem',
|
||||
'TELTONIKA-MIB' => 'routerName',
|
||||
);
|
||||
|
||||
%GLOBALS = (
|
||||
%SNMP::Info::Layer3::GLOBALS,
|
||||
'snmpd_vers' => 'versionTag',
|
||||
'hrSystemUptime' => 'hrSystemUptime',
|
||||
'serial1' => 'serial',
|
||||
'os_ver' => 'firmwareVersion',
|
||||
);
|
||||
|
||||
%FUNCS = ( %SNMP::Info::Layer3::FUNCS, );
|
||||
|
||||
%MUNGE = ( %SNMP::Info::Layer3::MUNGE, );
|
||||
|
||||
sub vendor {
|
||||
return 'teltonika';
|
||||
}
|
||||
|
||||
sub os {
|
||||
return 'rutos';
|
||||
}
|
||||
|
||||
sub model {
|
||||
my $dev = shift;
|
||||
return $dev->productCode();
|
||||
}
|
||||
|
||||
1;
|
||||
__END__
|
||||
|
||||
=head1 NAME
|
||||
|
||||
SNMP::Info::Layer3::Teltonika - SNMP Interface to Teltonika devices
|
||||
|
||||
=head1 AUTHORS
|
||||
|
||||
Jeroen van Ingen
|
||||
initial version based on SNMP::Info::Layer3::PacketFront
|
||||
|
||||
=head1 SYNOPSIS
|
||||
|
||||
# Let SNMP::Info determine the correct subclass for you.
|
||||
my $info = new SNMP::Info(
|
||||
AutoSpecify => 1,
|
||||
Debug => 1,
|
||||
DestHost => 'myrouter',
|
||||
Community => 'public',
|
||||
Version => 2
|
||||
)
|
||||
or die "Can't connect to DestHost.\n";
|
||||
|
||||
my $class = $info->class();
|
||||
print "SNMP::Info determined this device to fall under subclass : $class\n";
|
||||
|
||||
=head1 DESCRIPTION
|
||||
|
||||
Subclass for Teltonika devices
|
||||
|
||||
=head2 Inherited Classes
|
||||
|
||||
=over
|
||||
|
||||
=item SNMP::Info::Layer3
|
||||
|
||||
=back
|
||||
|
||||
=head2 Required MIBs
|
||||
|
||||
=over
|
||||
|
||||
=item F<UCD-SNMP-MIB>
|
||||
|
||||
=item F<NET-SNMP-TC>
|
||||
|
||||
=item F<HOST-RESOURCES-MIB>
|
||||
|
||||
=item F<TELTONIKA-MIB>
|
||||
|
||||
=item Inherited Classes' MIBs
|
||||
|
||||
See L<SNMP::Info::Layer3> for its own MIB requirements.
|
||||
|
||||
=back
|
||||
|
||||
=head1 GLOBALS
|
||||
|
||||
These are methods that return scalar value from SNMP
|
||||
|
||||
=over
|
||||
|
||||
=item $info->vendor()
|
||||
|
||||
Returns C<'teltonika'>.
|
||||
|
||||
=item $info->os()
|
||||
|
||||
Returns C<'rutos'>.
|
||||
|
||||
=item $info->os_ver()
|
||||
|
||||
Returns the value of C<firmwareVersion>.
|
||||
|
||||
=item $info->model()
|
||||
|
||||
Returns the value of C<productCode>.
|
||||
|
||||
=back
|
||||
|
||||
=head2 Globals imported from SNMP::Info::Layer3
|
||||
|
||||
See documentation in L<SNMP::Info::Layer3> for details.
|
||||
|
||||
=head1 TABLE ENTRIES
|
||||
|
||||
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<SNMP::Info::Layer3> for details.
|
||||
|
||||
|
||||
=cut
|
||||
99
xt/lib/Test/SNMP/Info/Layer3/Teltonika.pm
Normal file
99
xt/lib/Test/SNMP/Info/Layer3/Teltonika.pm
Normal file
@@ -0,0 +1,99 @@
|
||||
# Test::SNMP::Info::Layer3::Teltonika
|
||||
#
|
||||
# Copyright (c) 2020 Jeroen van Ingen Schenau
|
||||
# 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 Test::SNMP::Info::Layer3::Teltonika;
|
||||
|
||||
use Test::Class::Most parent => 'My::Test::Class';
|
||||
|
||||
use SNMP::Info::Layer3::Teltonika;
|
||||
|
||||
sub setup : Tests(setup) {
|
||||
my $test = shift;
|
||||
$test->SUPER::setup;
|
||||
|
||||
# Start with a common cache that will serve most tests
|
||||
my $d_string = 'Linux hostname.domain.example.com 3.18.44 #1 ';
|
||||
$d_string .= 'Fri Mar 13 09:37:25 UTC 2020 mips';
|
||||
my $cache_data = {
|
||||
'_layers' => 4,
|
||||
'_description' => $d_string,
|
||||
|
||||
# No MIB to resolve, just use enterprise ID
|
||||
'_id' => '.1.3.6.1.4.1.48690',
|
||||
'_serial1' => '1105407509',
|
||||
'_productCode' => 'RUT950U02XXX',
|
||||
'_os_ver' => 'RUT9XX_R_00.06.06.1',
|
||||
'store' => {},
|
||||
};
|
||||
$test->{info}->cache($cache_data);
|
||||
}
|
||||
|
||||
sub os : Tests(2) {
|
||||
my $test = shift;
|
||||
|
||||
can_ok($test->{info}, 'os');
|
||||
is($test->{info}->os(), 'rutos', q(OS returns 'rutos'));
|
||||
}
|
||||
|
||||
sub vendor : Tests(2) {
|
||||
my $test = shift;
|
||||
|
||||
can_ok($test->{info}, 'vendor');
|
||||
is($test->{info}->vendor(), 'teltonika', q(Vendor returns 'teltonika'));
|
||||
}
|
||||
|
||||
sub serial : Tests(2) {
|
||||
my $test = shift;
|
||||
|
||||
can_ok($test->{info}, 'serial');
|
||||
is($test->{info}->serial(), '1105407509', q(Serial number is expected value'));
|
||||
}
|
||||
|
||||
sub model : Tests(3) {
|
||||
my $test = shift;
|
||||
|
||||
can_ok($test->{info}, 'model');
|
||||
is($test->{info}->model(), 'RUT950U02XXX', q(Model is expected value));
|
||||
|
||||
$test->{info}->clear_cache();
|
||||
is($test->{info}->model(), undef, q(No model info returns undef model));
|
||||
}
|
||||
|
||||
sub os_ver : Tests(3) {
|
||||
my $test = shift;
|
||||
|
||||
can_ok($test->{info}, 'os_ver');
|
||||
is($test->{info}->os_ver(), 'RUT9XX_R_00.06.06.1', q(OS version is expected value));
|
||||
|
||||
$test->{info}->clear_cache();
|
||||
is($test->{info}->os_ver(), undef,
|
||||
q(No OS version info returns undef OS version));
|
||||
}
|
||||
|
||||
1;
|
||||
Reference in New Issue
Block a user