Wi-Fi Plugin

The collector has a default MAC Address manufacturer list which allows the MAC Addresses to be mapped to their Manufacturers. It is possible to edit the default configuration and it must be edited at each peer. Peer level configuration allows for tenant level configuration on a multi-tenant cluster.

1. The MAC Address manufacturer list is stored in /config/collectors/wifi/configuration/oui.csv.sample.
2. The user can create a new file in /config/collectors/wifi/configuration named oui.csv and store the updated MAC Address manufacturer list there. For the latest CSV file, please refer to IEEE Registration Authority MAC Address Block Large (MA-L).
3. The oui.csv file expects at least two fields.
   • Assignment - Mac Address
   • Organization Name - name used to create manufacturer device
     Note: All the other fields will be ignored.
4. If oui.csv file is corrupted or empty, the collector will exit.
   Important: The user must not make any changes to oui.csv.sample file and also, if the oui.csv file is not present in the folder, oui.csv.sample file will be used.

Perform the following steps to remove the Wi-Fi data.

1. Login into SevOne NMS.
2. Disable the Wi-Fi plugin on the respective devices.
3. Delete the following.
   1. Metadata Namespaces

      Administration > Metadata Schema > Wifi Station, Wifi Access Point, and WLC Device.

   2. Object Types > Filter for Deferred Data > Wifi Aggregation , Wifi Station , Wifi Access Point , Wifi Controller , Selfmon, and Wired Interface .
   3. Devices > Device Manager > remove all AP and station devices. You can filter these devices based on the device group.
      • AP devices: All device group > Wifi > APs
      • Station devices: All device group > Wifi > Stations.
   4. Devices > Device Groups > remove Wifi device group.
   5. Events > Configuration > Policy Browser > remove WiFi Selfmon: Polling duration is more than polling cycle, Unavailable AP devices (Unavailable APs set to zero), and Unavailable AP devices (Time since newest data point) policies.

If an Access Point (AP) hardware is reused in a network with a different hostname, it will result in duplicate APs in SevOne NMS with the same IP address but a different hostname resulting in both access points co–existing with duplicate data.

Example

WiFi AP:tyo-ap1-FL7-S-36021-ad.sevone.com 10.90.103.39
WiFi AP:jap-ap3-FL7-N-37203-ad.sevone.com 10.90.103.39

In this situation, if an access point is decommissioned from a particular site, you must delete the old AP from NMS. When the AP comes alive after being renamed, it will be automatically get rediscovered and added to SevOne. This will avoid duplication of access points in SevOne NMS.

Follow the steps below to clean up the Wi-Fi stations which have been inactive. Inactivity is calculated based on the last time the station was connected to the Wi-Fi network. The configuration allows for different retention periods for different SSIDs. The default retention period for Wi-Fi Station objects is 360 hours (= 15 days).

/config/collectors/wifi/configuration/disable_config.json

{"SevOne": 168, "SevOne-guest": 48}

The user can change the following variables in /config/collectors/wifi/configuration/advanced_config.env so that the cleanup process can utilize and apply these variables. For additional variables, please see advanced_config.env table below.

To enable alerting on Wi-Fi stations that are unavailable for 10 minutes or more, a special Object Group (Wifi > Wifi Station Monitor) and Alert Policy (Wifi Station Monitor: Some stations are not available) are shipped OOTB.

1. Either pin or create rules as per the Object Group capability.
2. Enable the applicable alerting policy as mentioned above.

wifi_global_settings.json file can be found in /config/collectors/wifi/configuration directory.

{
    "AP_ESS_AGG_BL": "",
    "AP_ESS_AGG_BL_ALL": false,
    "COLLECT_STATION_USERNAME": true,
    "NO_PREFIX": true,
    "WLC_ESS_BL": "",
    "WLC_ESS_WL": "",
    "WLC_VERBOSE": 2,
    "COLLECT_AUDIT_LOGS": true
}

In addition to the updates made in wifi_global_settings.json file, it also requires advanced_config.env, oui.csv.sample, disable_config.json, and phy_types.json files. Please refer to the sections below for details on these files.

advanced_config.env file can be found in /config/collectors/wifi/configuration directory.

The configuration file should only be modified on the Cluster Leader appliance; from Command Line Interface, SSH to your Cluster Leader appliance as a root user to modify the configuration file. Any changes made will be automatically distributed to all peer nodes within the next 5 minutes.

Example: /config/collectors/wifi/configuration/advanced_config.env

SEVONE_API_READ_TIMEOUT=60
# AUDIT_LOGS_RETENTION_PERIOD accepts hours.
# It only accepts whole numbers. Fractional times are not accepted.
AUDIT_LOGS_RETENTION_PERIOD=
DEL_AUDIT_LOGS=
DEL_OBJECTS=True

oui.csv.sample file can be found in /config/collectors/wifi/configuration directory.

Registry,Assignment,Organization Name,Organization Address
MA-L,002272,American Micro-Fuel Device Corp.,2181 Buchanan Loop Ferndale WA US 98248 
MA-L,00D0EF,IGT,9295 PROTOTYPE DRIVE RENO NV US 89511 
MA-L,086195,Rockwell Automation,1 Allen-Bradley Dr. Mayfield Heights OH US 44124-6118 
MA-L,F4BD9E,"Cisco Systems, Inc",80 West Tasman Drive San Jose CA US 94568 
MA-L,5885E9,Realme Chongqing MobileTelecommunications Corp Ltd,"No.24 Nichang Boulevard, Huixing Block, Yubei District, Chongqing. Chongqing China CN 401120 "
MA-L,BC2392,BYD Precision Manufacture Company Ltd.,"No.3001, Bao He Road, Baolong Industrial, Longgang Street,Longgang Zone, Shenzhen shenzhen  CN 518116 "
MA-L,405582,Nokia,600 March Road Kanata Ontario CA K2K 2E6 
MA-L,A4E31B,Nokia,600 March Road Kanata Ontario CA K2K 2E6 
MA-L,D89790,Commonwealth Scientific and Industrial Research Organisation,GPO Box 1700 Canberra ACT AU 2601 

...
...
...

MA-L,E48EBB,Rockwell Automation,1 Allen-Bradley Dr. Mayfield Heights OH US 44124-6118 
MA-L,F4AAD0,OHSUNG,"335-4,SANHODAERO,GUMI,GYEONG BUK,KOREA GUMI GYEONG BUK KR 730-030 "
MA-L,24BF74,Hamamatsu Photonics K.K.,"1126-1, Ichino-cho, Higashi-ku Hamamatsu-City Shizuoka-ken JP 435-8558 "
MA-L,641C10,Texas Instruments,12500 TI Blvd Dallas TX US 75243 
MA-L,58569F,"Cisco Systems, Inc",80 West Tasman Drive San Jose CA US 94568 
MA-L,142D41,Silicon Laboratories,400 West Cesar Chavez Street Austin TX US 78701 
MA-L,A82AD6,Arthrex Inc.,1370 Creekside Boulevard Naples FL US 34108 
MA-L,A06636,Intracom SA Telecom Solutions,19.7 klm Marcopoulo Ave PEANIA ATTIKI GR 19002 
MA-L,5843AB,"GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD","NO.18 HAIBIN ROAD, DONG GUAN GUANG DONG CN 523860 "
MA-L,141844,Xenon Smart Teknoloji Ltd.,Tatlisu Mh. Akdag Cd. No:3-5 Umraniye Istanbul TR 34774 

disable_config.json file can be found in /config/collectors/wifi/configuration directory.

{
  "ssid": 48,
  "unknown": 360
}

phy_types.json file can be found in /config/collectors/wifi/configuration directory.

{
  "cisco": {
    "1": "dot11a",
    "2": "dot11b",
    "3": "dot11g",
    "4": "unknown",
    "5": "mobile",
    "6": "dot11n24",
    "7": "dot11n5",
    "8": "ethernet",
    "9": "dot3",
    "10": "dot11ac",
    "11": "dot11ax5",
    "12": "dot11ax24",
    "13": "dot11ax6"
  },
  "aruba": {
    "1": "dot11a",
    "2": "dot11b",
    "3": "dot11g",
    "4": "dot11ag",
    "5": "wired"
  }
}