clones/librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-09-21 10:28:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

Extended ceraos (ceragon) discovery to graph various wireless parameters (#5014)

Browse Source
This commit is contained in:
barryodonovan 2016-12-07 15:24:56 +00:00 committed by Neil Lathwood
parent 5810c3af88
commit f7d80202e7
16 changed files with 352 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
html/includes/graphs/device/ceraos_DefectedBlocks.inc.php Normal file
View File

@ -0,0 +1,17 @@
<?php
require 'includes/graphs/common.inc.php';
$rrdfilename = rrd_name($device['hostname'], 'ceragon-radio');
if (rrdtool_check_rrd_exists($rrdfilename)) {
$rrd_options .= ' COMMENT:" Now Min Max\r" ';
$features = explode(' ', $device[features]);
$num_radios = $features[0];
$color = array("CC0000", "00CC00", "0000CC", "CCCCCC");
for ($i=1; $i <= $num_radios; $i++) {
$rrd_options .= ' DEF:radio'.$i.'DefectedBlocks='.$rrdfilename.':radio'.$i.'DefectedBlock:AVERAGE ';
$rrd_options .= ' LINE1:radio'.$i.'DefectedBlocks#'.$color[$i-1].':"Radio '.$i.' DefectedBlocks\l" ';
$rrd_options .= ' COMMENT:\u ';
$rrd_options .= ' GPRINT:radio'.$i.'DefectedBlocks:LAST:"%0.0lf " ';
$rrd_options .= ' GPRINT:radio'.$i.'DefectedBlocks:MIN:"%0.0lf " ';
$rrd_options .= ' GPRINT:radio'.$i.'DefectedBlocks:MAX:"%0.0lf \r" ';
}
}

21
html/includes/graphs/device/ceraos_MSE.inc.php Normal file
View File

@ -0,0 +1,21 @@
<?php
$scale_min = -30;
$scale_max = -25;
require 'includes/graphs/common.inc.php';
$rrdfilename = rrd_name($device['hostname'], 'ceragon-radio');
if (rrdtool_check_rrd_exists($rrdfilename)) {
$rrd_options .= ' COMMENT:" Now Min Max\r" ';
$features = explode(' ', $device[features]);
$num_radios = $features[0];
$color = array("CC0000", "00CC00", "0000CC", "CCCCCC");
for ($i=1; $i <= $num_radios; $i++) {
$rrd_options .= ' DEF:radio'.$i.'MSE='.$rrdfilename.':radio'.$i.'MSE:AVERAGE ';
$rrd_options .= ' CDEF:divided'.$i.'MSE=radio'.$i.'MSE,100,/ ';
$rrd_options .= ' LINE1:divided'.$i.'MSE#'.$color[$i-1].':"Radio '.$i.' MSE\l" ';
$rrd_options .= ' COMMENT:\u ';
$rrd_options .= ' GPRINT:divided'.$i.'MSE:LAST:"%0.2lf dB" ';
$rrd_options .= ' GPRINT:divided'.$i.'MSE:MIN:"%0.2lf dB" ';
$rrd_options .= ' GPRINT:divided'.$i.'MSE:MAX:"%0.2lf dB\r" ';
}
}

21
html/includes/graphs/device/ceraos_RxBitrate.inc.php Normal file
View File

@ -0,0 +1,21 @@
<?php
$scale_min = 100;
$scale_max = 250;
require 'includes/graphs/common.inc.php';
$rrdfilename = rrd_name($device['hostname'], 'ceragon-radio');
if (rrdtool_check_rrd_exists($rrdfilename)) {
$rrd_options .= ' COMMENT:" Now Min Max\r" ';
$features = explode(' ', $device[features]);
$num_radios = $features[0];
$color = array("CC0000", "00CC00", "0000CC", "CCCCCC");
for ($i=1; $i <= $num_radios; $i++) {
$rrd_options .= ' DEF:radio'.$i.'RxBitrate='.$rrdfilename.':radio'.$i.'RxRate:AVERAGE ';
$rrd_options .= ' CDEF:radio'.$i.'RxBitrateMbps=radio'.$i.'RxBitrate,1000,/ ';
$rrd_options .= ' LINE1:radio'.$i.'RxBitrateMbps#'.$color[$i-1].':"Radio '.$i.' RxBitrate\l" ';
$rrd_options .= ' COMMENT:\u ';
$rrd_options .= ' GPRINT:radio'.$i.'RxBitrateMbps:LAST:"%0.2lf Mbps" ';
$rrd_options .= ' GPRINT:radio'.$i.'RxBitrateMbps:MIN:"%0.2lf Mbps" ';
$rrd_options .= ' GPRINT:radio'.$i.'RxBitrateMbps:MAX:"%0.2lf Mbps\r" ';
}
}

20
html/includes/graphs/device/ceraos_RxLevel.inc.php Normal file
View File

@ -0,0 +1,20 @@
<?php
$scale_min = -75;
$scale_max = -55;
require 'includes/graphs/common.inc.php';
$rrdfilename = rrd_name($device['hostname'], 'ceragon-radio');
if (rrdtool_check_rrd_exists($rrdfilename)) {
$rrd_options .= ' COMMENT:" Now Min Max\r" ';
$features = explode(' ', $device[features]);
$num_radios = $features[0];
$color = array("CC0000", "00CC00", "0000CC", "CCCCCC");
for ($i=1; $i <= $num_radios; $i++) {
$rrd_options .= ' DEF:radio'.$i.'RxLevel='.$rrdfilename.':radio'.$i.'RxLevel:AVERAGE ';
$rrd_options .= ' LINE1:radio'.$i.'RxLevel#'.$color[$i-1].':"Radio '.$i.' RX Level\l" ';
$rrd_options .= ' COMMENT:\u ';
$rrd_options .= ' GPRINT:radio'.$i.'RxLevel:LAST:"%3.2lf dBm" ';
$rrd_options .= ' GPRINT:radio'.$i.'RxLevel:MIN:"%3.2lf dBm" ';
$rrd_options .= ' GPRINT:radio'.$i.'RxLevel:MAX:"%3.2lf dBm\r" ';
}
}

21
html/includes/graphs/device/ceraos_TxBitrate.inc.php Normal file
View File

@ -0,0 +1,21 @@
<?php
$scale_min = 100;
$scale_max = 250;
require 'includes/graphs/common.inc.php';
$rrdfilename = rrd_name($device['hostname'], 'ceragon-radio');
if (rrdtool_check_rrd_exists($rrdfilename)) {
$rrd_options .= ' COMMENT:" Now Min Max\r" ';
$features = explode(' ', $device[features]);
$num_radios = $features[0];
$color = array("CC0000", "00CC00", "0000CC", "CCCCCC");
for ($i=1; $i <= $num_radios; $i++) {
$rrd_options .= ' DEF:radio'.$i.'TxBitrate='.$rrdfilename.':radio'.$i.'TxRate:AVERAGE ';
$rrd_options .= ' CDEF:radio'.$i.'TxBitrateMbps=radio'.$i.'TxBitrate,1000,/ ';
$rrd_options .= ' LINE1:radio'.$i.'TxBitrateMbps#'.$color[$i-1].':"Radio '.$i.' TxBitrate\l" ';
$rrd_options .= ' COMMENT:\u ';
$rrd_options .= ' GPRINT:radio'.$i.'TxBitrateMbps:LAST:"%0.2lf Mbps" ';
$rrd_options .= ' GPRINT:radio'.$i.'TxBitrateMbps:MIN:"%0.2lf Mbps" ';
$rrd_options .= ' GPRINT:radio'.$i.'TxBitrateMbps:MAX:"%0.2lf Mbps\r" ';
}
}

20
html/includes/graphs/device/ceraos_TxPower.inc.php Normal file
View File

@ -0,0 +1,20 @@
<?php
$scale_min = -10;
$scale_max = 20;
require 'includes/graphs/common.inc.php';
$rrdfilename = rrd_name($device['hostname'], 'ceragon-radio');
if (rrdtool_check_rrd_exists($rrdfilename)) {
$rrd_options .= ' COMMENT:" Now Min Max\r" ';
$features = explode(' ', $device[features]);
$num_radios = $features[0];
$color = array("CC0000", "00CC00", "0000CC", "CCCCCC");
for ($i=1; $i <= $num_radios; $i++) {
$rrd_options .= ' DEF:radio'.$i.'TxPower='.$rrdfilename.':radio'.$i.'TxPower:AVERAGE ';
$rrd_options .= ' LINE1:radio'.$i.'TxPower#'.$color[$i-1].':"Radio '.$i.' RX Level\l" ';
$rrd_options .= ' COMMENT:\u ';
$rrd_options .= ' GPRINT:radio'.$i.'TxPower:LAST:"%3.2lf dBm" ';
$rrd_options .= ' GPRINT:radio'.$i.'TxPower:MIN:"%3.2lf dBm" ';
$rrd_options .= ' GPRINT:radio'.$i.'TxPower:MAX:"%3.2lf dBm\r" ';
}
}

18
html/includes/graphs/device/ceraos_XPI.inc.php Normal file
View File

@ -0,0 +1,18 @@
<?php
require 'includes/graphs/common.inc.php';
$rrdfilename = rrd_name($device['hostname'], 'ceragon-radio');
if (rrdtool_check_rrd_exists($rrdfilename)) {
$rrd_options .= ' COMMENT:" Now Min Max\r" ';
$features = explode(' ', $device[features]);
$num_radios = $features[0];
$color = array("CC0000", "00CC00", "0000CC", "CCCCCC");
for ($i=1; $i <= $num_radios; $i++) {
$rrd_options .= ' DEF:radio'.$i.'XPI='.$rrdfilename.':radio'.$i.'XPI:AVERAGE ';
$rrd_options .= ' CDEF:divided'.$i.'XPI=radio'.$i.'XPI,100,/ ';
$rrd_options .= ' LINE1:divided'.$i.'XPI#'.$color[$i-1].':"Radio '.$i.' XPI\l" ';
$rrd_options .= ' COMMENT:\u ';
$rrd_options .= ' GPRINT:divided'.$i.'XPI:LAST:"%0.2lf dB" ';
$rrd_options .= ' GPRINT:divided'.$i.'XPI:MIN:"%0.2lf dB" ';
$rrd_options .= ' GPRINT:divided'.$i.'XPI:MAX:"%0.2lf dB\r" ';
}
}

33
includes/definitions.inc.php
View File

@ -766,6 +766,10 @@ $config['os'][$os]['type'] = 'wireless';
$config['os'][$os]['icon'] = 'ceragon';
$config['os'][$os]['over'][0]['graph'] = 'device_bits';
$config['os'][$os]['over'][0]['text'] = 'Traffic';
$config['os'][$os]['over'][1]['graph'] = 'device_ceraos_RxLevel';
$config['os'][$os]['over'][1]['text'] = 'Rx Level';
$config['os'][$os]['over'][2]['graph'] = 'device_ping_perf';
$config['os'][$os]['over'][2]['text'] = 'Ping Times';
// Cisco WAP
$os = 'ciscowap';
@ -2386,6 +2390,35 @@ $config['graph_types']['device']['saf_modemCapacity']['section'] = 'wireless';
$config['graph_types']['device']['saf_modemCapacity']['order'] = '3';
$config['graph_types']['device']['saf_modemCapacity']['descr'] = 'Capacity';
// Ceragon Ceraos support
$config['graph_types']['device']['ceraos_RxLevel']['section'] = 'wireless';
$config['graph_types']['device']['ceraos_RxLevel']['order'] = '0';
$config['graph_types']['device']['ceraos_RxLevel']['descr'] = 'RX Level';
$config['graph_types']['device']['ceraos_TxPower']['section'] = 'wireless';
$config['graph_types']['device']['ceraos_TxPower']['order'] = '1';
$config['graph_types']['device']['ceraos_TxPower']['descr'] = 'TX Power';
$config['graph_types']['device']['ceraos_MSE']['section'] = 'wireless';
$config['graph_types']['device']['ceraos_MSE']['order'] = '2';
$config['graph_types']['device']['ceraos_MSE']['descr'] = 'Radial MSE';
$config['graph_types']['device']['ceraos_XPI']['section'] = 'wireless';
$config['graph_types']['device']['ceraos_XPI']['order'] = '3';
$config['graph_types']['device']['ceraos_XPI']['descr'] = 'Cross Polarisation Interference';
$config['graph_types']['device']['ceraos_DefectedBlocks']['section'] = 'wireless';
$config['graph_types']['device']['ceraos_DefectedBlocks']['order'] = '4';
$config['graph_types']['device']['ceraos_DefectedBlocks']['descr'] = 'DefectedBlocks';
$config['graph_types']['device']['ceraos_TxBitrate']['section'] = 'wireless';
$config['graph_types']['device']['ceraos_TxBitrate']['order'] = '5';
$config['graph_types']['device']['ceraos_TxBitrate']['descr'] = 'TxBitrate';
$config['graph_types']['device']['ceraos_RxBitrate']['section'] = 'wireless';
$config['graph_types']['device']['ceraos_RxBitrate']['order'] = '6';
$config['graph_types']['device']['ceraos_RxBitrate']['descr'] = 'RxBitrate';
// Sub10 support
$config['graph_types']['device']['sub10_sub10RadioLclTxPower']['section'] = 'wireless';
$config['graph_types']['device']['sub10_sub10RadioLclTxPower']['order'] = '0';

96
includes/polling/mib/ceraos-mib.inc.php Normal file
View File

@ -0,0 +1,96 @@
<?php
$features = explode(' ', $device[features]);
$num_radios = $features[0];
$mib_oids = array();
$radioNumber = 0;
$ifIndex = 0;
$ifIndex_array = array();
$ifIndex_array = explode("\n", snmp_walk($device, "ifIndex", "-Oqv", "IF-MIB"));
$snmp_get_oids = "";
foreach ($ifIndex_array as $ifIndex) {
$snmp_get_oids .= "ifDescr.$ifIndex ifName.$ifIndex ";
}
$ifDescr_array = array();
$ifDescr_array = snmp_get_multi($device, $snmp_get_oids, '-OQU', 'IF-MIB');
d_echo($ifDescr_array);
foreach ($ifIndex_array as $ifIndex) {
d_echo("\$ifDescr_array[$ifIndex]['IF-MIB::ifDescr'] = " . $ifDescr_array[$ifIndex]['IF-MIB::ifDescr'] . "\n");
$ifDescr = $ifDescr_array[$ifIndex]['IF-MIB::ifDescr'];
d_echo("\$ifDescr_array[$ifIndex]['IF-MIB::ifName'] = " . $ifDescr_array[$ifIndex]['IF-MIB::ifName'] . "\n");
$ifName = $ifDescr_array[$ifIndex]['IF-MIB::ifName'];
if (stristr($ifDescr, "Radio")) {
$radioNumber = $radioNumber+1;
$mib_oids["genEquipRfuStatusRxLevel.$ifIndex"] = array(
"",
"radio".$radioNumber."RxLevel",
$ifName." RX Level",
"GAUGE",
);
$mib_oids["genEquipRfuStatusTxLevel.$ifIndex"] = array(
"",
"radio".$radioNumber."TxPower",
$ifName." TX Power",
"GAUGE",
);
$mib_oids["genEquipRadioStatusMSE.$ifIndex"] = array(
"",
"radio".$radioNumber."MSE",
$ifName." MSE",
"GAUGE",
);
if ($num_radios > 1) {
$mib_oids["genEquipRadioStatusXPI.$ifIndex"] = array(
"",
"radio".$radioNumber."XPI",
$ifName." Cross Polarisation Interference",
"GAUGE",
);
}
$mib_oids["genEquipRadioStatusDefectedBlocks.$ifIndex"] = array(
"",
"radio".$radioNumber."DefectedBlocks",
$ifName." Defected Blocks",
"GAUGE",
);
$mib_oids["genEquipRadioMRMCCurrTxBitrate.$ifIndex"] = array(
"",
"radio".$radioNumber."TxRate",
$ifName." Tx Bit Rate",
"GAUGE",
);
$mib_oids["genEquipRadioMRMCCurrRxBitrate.$ifIndex"] = array(
"",
"radio".$radioNumber."RxRate",
$ifName." Rx Bit Rate",
"GAUGE",
);
}
}
if ($num_radios > 1) {
$mib_graphs = array(
"ceraos_RxLevel",
"ceraos_TxPower",
"ceraos_MSE",
"ceraos_XPI",
"ceraos_DefectedBlocks",
"ceraos_TxBitrate",
"ceraos_RxBitrate",
);
} else {
$mib_graphs = array(
"ceraos_RxLevel",
"ceraos_TxPower",
"ceraos_MSE",
"ceraos_DefectedBlocks",
"ceraos_TxBitrate",
"ceraos_RxBitrate",
);
}
poll_mib_def($device, "MWRM-RADIO-MIB:ceragon-radio", "ceraos", $mib_oids, $mib_graphs, $graphs);
unset($feature, $num_radios, $radioNumber, $ifIndex, $ifIndex_array, $ifName, $ifDescr, $mib_graphs, $mib_oids, $snmp_get_oids);

46
includes/polling/os/ceraos.inc.php
View File

@ -1,5 +1,45 @@
<?php
/*
* LibreNMS
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the
* Free Software Foundation, either version 3 of the License, or (at your
* option) any later version. Please see LICENSE.txt at the top level of
* the source code distribution for details.
*/
$hardware = snmp_get($device, 'genEquipInventoryCardName.127', '-Osqnv', 'MWRM-UNIT-MIB');
$serial = snmp_get($device, 'genEquipInventorySerialNumber.127', '-Osqnv', 'MWRM-UNIT-MIB');
$version = snmp_get($device, 'genEquipMngSwIDUVersionsRunningVersion.1', '-Osqnv', 'MWRM-UNIT-MIB');
$ceragon_type = $poll_device['sysObjectID'];
$hardware = rewrite_ceraos_hardware($ceragon_type, $device); // function in ./includes/rewrites.php
if (stristr('IP10', $hardware)) {
$serial = snmp_get($device, 'genEquipUnitIDUSerialNumber.0', '-Oqv', 'MWRM-UNIT-MIB');
} else {
$serial = snmp_get($device, 'genEquipInventorySerialNumber.127', '-Oqv', 'MWRM-UNIT-MIB');
}
$multi_get_array = snmp_get_multi($device, 'genEquipMngSwIDUVersionsRunningVersion.1 genEquipUnitLatitude.0 genEquipUnitLongitude.0', '-OQU', 'MWRM-RADIO-MIB');
d_echo($multi_get_array);
$version = $multi_get_array[1]['MWRM-UNIT-MIB::genEquipMngSwIDUVersionsRunningVersion'];
$latitude = $multi_get_array[0]['MWRM-UNIT-MIB::genEquipUnitLatitude'];
$longitude = $multi_get_array[0]['MWRM-UNIT-MIB::genEquipUnitLongitude'];
$ifIndex_array = array();
$ifIndex_array = explode("\n", snmp_walk($device, 'ifIndex', '-Oqv', 'IF-MIB'));
d_echo($ifIndex_array);
$snmp_get_oids = "";
foreach ($ifIndex_array as $ifIndex) {
$snmp_get_oids .= "ifDescr.$ifIndex ifName.$ifIndex ";
}
$num_radios = 0;
$ifDescr_array = array();
$ifDescr_array = snmp_get_multi($device, $snmp_get_oids, '-OQU', 'IF-MIB');
d_echo($ifDescr_array);
foreach ($ifIndex_array as $ifIndex) {
d_echo("\$ifDescr_array[$ifIndex]['IF-MIB::ifDescr'] = " . $ifDescr_array[$ifIndex]['IF-MIB::ifDescr'] . "\n");
if (stristr($ifDescr_array[$ifIndex]['IF-MIB::ifDescr'], "Radio")) {
$num_radios = $num_radios+1;
}
}
$features = $num_radios . " radios in unit";
unset($ceragon_type, $multi_get_array, $ifIndex_array, $ifIndex, $ifDescr_array, $ifDescr, $num_radios);

3
includes/polling/wifi.inc.php
View File

@ -7,6 +7,9 @@ if ($device['type'] == 'network' || $device['type'] == 'firewall' || $device['ty
} elseif ($device['os'] == 'airos-af') {
echo 'It Is AirFIBER' . PHP_EOL;
include 'includes/polling/mib/ubnt-airfiber-mib.inc.php';
} elseif ($device['os'] == 'ceraos') {
echo 'It is Ceragon CeroOS' . PHP_EOL;
include 'includes/polling/mib/ceraos-mib.inc.php';
} elseif ($device['os'] == 'siklu') {
echo 'It is Siklu' . PHP_EOL;
include 'includes/polling/mib/siklu-mib.inc.php';

39
includes/rewrites.php
View File

@ -1380,3 +1380,42 @@ $ipmiSensorsNames = array(
"Power Meter" => "Power usage",
),
);
/**
* @param $ceragon_type
* @param $device
* @return bool|mixed|string
*/
function rewrite_ceraos_hardware($ceragon_type, $device)
{
if (strstr($ceragon_type, '.2281.1.10')) {
$hardware = 'IP10 Family';
} elseif (strstr($ceragon_type, '.2281.1.20.1.1.2')) {
$hardware = 'IP-20A 1RU';
} elseif (strstr($ceragon_type, '.2281.1.20.1.1.4')) {
$hardware = 'IP-20 Evolution LH 1RU';
} elseif (strstr($ceragon_type, '.2281.1.20.1.1')) {
$hardware = 'IP-20N 1RU';
} elseif (strstr($ceragon_type, '.2281.1.20.1.2.2')) {
$hardware = 'IP-20A 2RU';
} elseif (strstr($ceragon_type, '.2281.1.20.1.2.4')) {
$hardware = 'IP-20 Evolution 2RU';
} elseif (strstr($ceragon_type, '.2281.1.20.1.2')) {
$hardware = 'IP-20N 2RU';
} elseif (strstr($ceragon_type, '.2281.1.20.1.3.1')) {
$hardware = 'IP-20G';
} elseif (strstr($ceragon_type, '.2281.1.20.1.3.2')) {
$hardware = 'IP-20GX';
} elseif (strstr($ceragon_type, '.2281.1.20.2.2.2')) {
$hardware = 'IP-20S';
} elseif (strstr($ceragon_type, '.2281.1.20.2.2.3')) {
$hardware = 'IP-20E (hardware release 1)';
} elseif (strstr($ceragon_type, '.2281.1.20.2.2.4')) {
$hardware = 'IP-20E (hardware release 2)';
} elseif (strstr($ceragon_type, '.2281.1.20.2.2')) {
$hardware = 'IP-20C';
} else {
$hardware = snmp_get($device, 'genEquipInventoryCardName', '-Oqv', 'MWRM-UNIT-NAME');
}
return $hardware;
};

0
mibs/MWRM-NETWORK-MIB → mibs/ceraos/MWRM-NETWORK-MIB
View File

0
mibs/MWRM-PM-MIB → mibs/ceraos/MWRM-PM-MIB
View File

0
mibs/MWRM-RADIO-MIB → mibs/ceraos/MWRM-RADIO-MIB
View File

0
mibs/MWRM-UNIT-MIB → mibs/ceraos/MWRM-UNIT-MIB
View File