. * * @link http://librenms.org * @copyright 2018 Tony Murray * @author Tony Murray */ namespace LibreNMS\OS; use App\Models\Device; use App\Models\PortsNac; use Illuminate\Support\Str; use LibreNMS\Device\Processor; use LibreNMS\Device\WirelessSensor; use LibreNMS\Interfaces\Discovery\OSDiscovery; use LibreNMS\Interfaces\Discovery\ProcessorDiscovery; use LibreNMS\Interfaces\Discovery\Sensors\WirelessApCountDiscovery; use LibreNMS\Interfaces\Discovery\Sensors\WirelessClientsDiscovery; use LibreNMS\Interfaces\Polling\NacPolling; use LibreNMS\Interfaces\Polling\OSPolling; use LibreNMS\OS; use LibreNMS\RRD\RrdDefinition; class Vrp extends OS implements OSPolling, ProcessorDiscovery, NacPolling, WirelessApCountDiscovery, WirelessClientsDiscovery, OSDiscovery { public function discoverOS(Device $device): void { parent::discoverOS($device); // yaml //Huawei VRP devices are not providing the HW description in a unified way preg_match('/Version (\S+)/', $device->sysDescr, $matches); $device->version = isset($matches[1]) ? ($matches[1] . ($device->version ? " ($device->version)" : '')) : null; // version from yaml sysDescr if ($device->version) { $patch = snmp_getnext($this->getDeviceArray(), 'HUAWEI-SYS-MAN-MIB::hwPatchVersion', '-OQv'); if ($patch) { $device->version .= " [$patch]"; } } if ($device->hardware && preg_match("/$device->hardware\S+/", $device->sysDescr, $matches)) { $device->hardware = $matches[0]; } } public function pollOS() { // Polling the Wireless data TODO port to module $apTable = snmpwalk_group($this->getDeviceArray(), 'hwWlanApName', 'HUAWEI-WLAN-AP-MIB', 2); //Check for existence of at least 1 AP to continue the polling) if (! empty($apTable)) { $apTableOids = [ 'hwWlanApSn', 'hwWlanApTypeInfo', ]; foreach ($apTableOids as $apTableOid) { $apTable = snmpwalk_group($this->getDeviceArray(), $apTableOid, 'HUAWEI-WLAN-AP-MIB', 2, $apTable); } $apRadioTableOids = [ // hwWlanRadioInfoTable 'hwWlanRadioMac', 'hwWlanRadioChUtilizationRate', 'hwWlanRadioChInterferenceRate', 'hwWlanRadioActualEIRP', 'hwWlanRadioFreqType', 'hwWlanRadioWorkingChannel', ]; $clientPerRadio = []; $radioTable = []; foreach ($apRadioTableOids as $apRadioTableOid) { $radioTable = snmpwalk_group($this->getDeviceArray(), $apRadioTableOid, 'HUAWEI-WLAN-AP-RADIO-MIB', 2, $radioTable); } $numClients = 0; $vapInfoTable = snmpwalk_group($this->getDeviceArray(), 'hwWlanVapStaOnlineCnt', 'HUAWEI-WLAN-VAP-MIB', 3); foreach ($vapInfoTable as $ap_id => $ap) { //Convert mac address (hh:hh:hh:hh:hh:hh) to dec OID (ddd.ddd.ddd.ddd.ddd.ddd) //$a_index_oid = implode(".", array_map("hexdec", explode(":", $ap_id))); foreach ($ap as $r_id => $radio) { foreach ($radio as $s_index => $ssid) { $clientPerRadio[$ap_id][$r_id] += $ssid['hwWlanVapStaOnlineCnt']; $numClients += $ssid['hwWlanVapStaOnlineCnt']; } } } $numRadios = count($radioTable); $rrd_def = RrdDefinition::make() ->addDataset('NUMAPS', 'GAUGE', 0, 12500000000) ->addDataset('NUMCLIENTS', 'GAUGE', 0, 12500000000); $fields = [ 'NUMAPS' => $numRadios, 'NUMCLIENTS' => $numClients, ]; $tags = compact('rrd_def'); data_update($this->getDeviceArray(), 'vrp', $tags, $fields); $ap_db = dbFetchRows('SELECT * FROM `access_points` WHERE `device_id` = ?', [$this->getDeviceArray()['device_id']]); foreach ($radioTable as $ap_id => $ap) { foreach ($ap as $r_id => $radio) { $channel = $radio['hwWlanRadioWorkingChannel']; $mac = $radio['hwWlanRadioMac']; $name = $apTable[$ap_id]['hwWlanApName'] . ' Radio ' . $r_id; $radionum = $r_id; $txpow = $radio['hwWlanRadioActualEIRP']; $interference = $radio['hwWlanRadioChInterferenceRate']; $radioutil = $radio['hwWlanRadioChUtilizationRate']; $numasoclients = $clientPerRadio[$ap_id][$r_id]; switch ($radio['hwWlanRadioFreqType']) { case 1: $type = '2.4Ghz'; break; case 2: $type = '5Ghz'; break; default: $type = 'unknown (huawei ' . $radio['hwWlanRadioFreqType'] . ')'; } // TODO $numactbssid = 0; $nummonbssid = 0; $nummonclients = 0; d_echo(" name: $name\n"); d_echo(" radionum: $radionum\n"); d_echo(" type: $type\n"); d_echo(" channel: $channel\n"); d_echo(" txpow: $txpow\n"); d_echo(" radioutil: $radioutil\n"); d_echo(" numasoclients: $numasoclients\n"); d_echo(" interference: $interference\n"); $rrd_name = ['arubaap', $name . $radionum]; $rrd_def = RrdDefinition::make() ->addDataset('channel', 'GAUGE', 0, 200) ->addDataset('txpow', 'GAUGE', 0, 200) ->addDataset('radioutil', 'GAUGE', 0, 100) ->addDataset('nummonclients', 'GAUGE', 0, 500) ->addDataset('nummonbssid', 'GAUGE', 0, 200) ->addDataset('numasoclients', 'GAUGE', 0, 500) ->addDataset('interference', 'GAUGE', 0, 2000); $fields = [ 'channel' => $channel, 'txpow' => $txpow, 'radioutil' => $radioutil, 'nummonclients' => $nummonclients, 'nummonbssid' => $nummonbssid, 'numasoclients' => $numasoclients, 'interference' => $interference, ]; $tags = compact('name', 'radionum', 'rrd_name', 'rrd_def'); data_update($this->getDeviceArray(), 'arubaap', $tags, $fields); $foundid = 0; for ($z = 0; $z < sizeof($ap_db); $z++) { if ($ap_db[$z]['name'] == $name && $ap_db[$z]['radio_number'] == $radionum) { $foundid = $ap_db[$z]['accesspoint_id']; $ap_db[$z]['seen'] = 1; continue; } } if ($foundid == 0) { $ap_id = dbInsert( [ 'device_id' => $this->getDeviceArray()['device_id'], 'name' => $name, 'radio_number' => $radionum, 'type' => $type, 'mac_addr' => $mac, 'channel' => $channel, 'txpow' => $txpow, 'radioutil' => $radioutil, 'numasoclients' => $numasoclients, 'nummonclients' => $nummonclients, 'numactbssid' => $numactbssid, 'nummonbssid' => $nummonbssid, 'interference' => $interference, ], 'access_points' ); } else { dbUpdate( [ 'mac_addr' => $mac, 'type' => $type, 'deleted' => 0, 'channel' => $channel, 'txpow' => $txpow, 'radioutil' => $radioutil, 'numasoclients' => $numasoclients, 'nummonclients' => $nummonclients, 'numactbssid' => $numactbssid, 'nummonbssid' => $nummonbssid, 'interference' => $interference, ], 'access_points', '`accesspoint_id` = ?', [$foundid] ); } }//end foreach 1 }//end foreach 2 for ($z = 0; $z < sizeof($ap_db); $z++) { if (! isset($ap_db[$z]['seen']) && $ap_db[$z]['deleted'] == 0) { dbUpdate(['deleted' => 1], 'access_points', '`accesspoint_id` = ?', [$ap_db[$z]['accesspoint_id']]); } } } } /** * Discover processors. * Returns an array of LibreNMS\Device\Processor objects that have been discovered * * @return array Processors */ public function discoverProcessors() { $device = $this->getDeviceArray(); $processors_data = snmpwalk_cache_multi_oid($device, 'hwEntityCpuUsage', [], 'HUAWEI-ENTITY-EXTENT-MIB', 'huawei'); if (! empty($processors_data)) { $processors_data = snmpwalk_cache_multi_oid($device, 'hwEntityMemSize', $processors_data, 'HUAWEI-ENTITY-EXTENT-MIB', 'huawei'); $processors_data = snmpwalk_cache_multi_oid($device, 'hwEntityBomEnDesc', $processors_data, 'HUAWEI-ENTITY-EXTENT-MIB', 'huawei'); } d_echo($processors_data); $processors = []; foreach ($processors_data as $index => $entry) { if ($entry['hwEntityMemSize'] != 0) { d_echo($index . ' ' . $entry['hwEntityBomEnDesc'] . ' -> ' . $entry['hwEntityCpuUsage'] . ' -> ' . $entry['hwEntityMemSize'] . "\n"); $usage_oid = '.1.3.6.1.4.1.2011.5.25.31.1.1.1.1.5.' . $index; $descr = $entry['hwEntityBomEnDesc']; $usage = $entry['hwEntityCpuUsage']; if (empty($descr) || Str::contains($descr, 'No') || Str::contains($usage, 'No')) { continue; } $processors[] = Processor::discover( $this->getName(), $this->getDeviceId(), $usage_oid, $index, $descr, 1, $usage ); } } return $processors; } /** * Discover the Network Access Control informations (dot1X etc etc) */ public function pollNac() { $nac = collect(); // We collect the first table $portAuthSessionEntry = snmpwalk_cache_oid($this->getDeviceArray(), 'hwAccessTable', [], 'HUAWEI-AAA-MIB'); if (! empty($portAuthSessionEntry)) { // If it is not empty, lets add the Extended table $portAuthSessionEntry = snmpwalk_cache_oid($this->getDeviceArray(), 'hwAccessExtTable', $portAuthSessionEntry, 'HUAWEI-AAA-MIB'); // We cache a port_ifName -> port_id map $ifName_map = $this->getDevice()->ports()->pluck('port_id', 'ifName'); // update the DB foreach ($portAuthSessionEntry as $authId => $portAuthSessionEntryParameters) { $mac_address = strtolower(implode(array_map('zeropad', explode(':', $portAuthSessionEntryParameters['hwAccessMACAddress'])))); $port_id = $ifName_map->get($portAuthSessionEntryParameters['hwAccessInterface'], 0); if ($port_id <= 0) { continue; //this would happen for an SSH session for instance } $nac->put($mac_address, new PortsNac([ 'port_id' => $ifName_map->get($portAuthSessionEntryParameters['hwAccessInterface'], 0), 'mac_address' => $mac_address, 'auth_id' => $authId, 'domain' => $portAuthSessionEntryParameters['hwAccessDomain'], 'username' => '' . $portAuthSessionEntryParameters['hwAccessUserName'], 'ip_address' => $portAuthSessionEntryParameters['hwAccessIPAddress'], 'authz_by' => '' . $portAuthSessionEntryParameters['hwAccessType'], 'authz_status' => '' . $portAuthSessionEntryParameters['hwAccessAuthorizetype'], 'host_mode' => is_null($portAuthSessionEntryParameters['hwAccessAuthType']) ? 'default' : $portAuthSessionEntryParameters['hwAccessAuthType'], 'timeout' => $portAuthSessionEntryParameters['hwAccessSessionTimeout'], 'time_elapsed' => $portAuthSessionEntryParameters['hwAccessOnlineTime'], 'authc_status' => $portAuthSessionEntryParameters['hwAccessCurAuthenPlace'], 'method' => '' . $portAuthSessionEntryParameters['hwAccessAuthtype'], 'vlan' => $portAuthSessionEntryParameters['hwAccessVLANID'], ])); } } return $nac; } public function discoverWirelessApCount() { $sensors = []; $ap_number = snmpwalk_cache_oid($this->getDeviceArray(), 'hwWlanCurJointApNum.0', [], 'HUAWEI-WLAN-GLOBAL-MIB'); $sensors[] = new WirelessSensor( 'ap-count', $this->getDeviceId(), '.1.3.6.1.4.1.2011.6.139.12.1.2.1.0', 'vrp-ap-count', 'ap-count', 'AP Count', $ap_number[0]['hwWlanCurJointApNum'] ); return $sensors; } public function discoverWirelessClients() { $sensors = []; $total_oids = []; $vapInfoTable = $this->getCacheTable('hwWlanVapInfoTable', 'HUAWEI-WLAN-VAP-MIB', 3); foreach ($vapInfoTable as $a_index => $ap) { //Convert mac address (hh:hh:hh:hh:hh:hh) to dec OID (ddd.ddd.ddd.ddd.ddd.ddd) $a_index_oid = implode('.', array_map('hexdec', explode(':', $a_index))); foreach ($ap as $r_index => $radio) { foreach ($radio as $s_index => $ssid) { $oid = '.1.3.6.1.4.1.2011.6.139.17.1.1.1.9.' . $a_index_oid . '.' . $r_index . '.' . $s_index; $total_oids[] = $oid; $sensors[] = new WirelessSensor( 'clients', $this->getDeviceId(), $oid, 'vrp', $a_index_oid . '.' . $r_index . '.' . $s_index, 'Radio:' . $r_index . ' SSID:' . $ssid['hwWlanVapProfileName'], $ssid['hwWlanVapStaOnlineCnt'] ); } } } return $sensors; } }