Wireless LAN Controller (WLC) Solutions Widgets for Data Insight Installation Guide

About

This document includes steps for deploying the widgets available with the Wireless LAN Controller (WLC) collector in Data Insight.

Prerequisites

Edit online

In order to deploy the Wireless LAN Controller (WLC) widgets, you will need to have the following:

For SevOne NMS and SevOne Data Insight versions compatible with this release, please refer to Release Notes Wireless LAN Controller (WLC) Collector > section Compatibility Matrix.
sevone access to the Data Insight machine.
Wireless LAN Controller (WLC) collector installed on your SevOne NMS appliance or cluster.
Wireless LAN Collector (WLC) 6.8 widget pack provided to you by IBM SevOne Production or IBM SevOne Support.

Extract and Deploy

Edit online

Perform the following steps to extract and deploy the Wireless LAN Controller widgets in SevOne Data Insight.

After downloading the widget tar and <CHECKSUM_FILE_NAME>.sha256.txt files provided to you by IBM SevOne Production or IBM SevOne Support, perform the steps below to install the widgets on SevOne Data Insight using CLI (Command Line Interface).

Installation

Edit online

To install the WLC/Generic widgets on SevOne Data Insight, execute the following commands.

ssh to your SevOne Data Insight machine as sevone user.

$ ssh sevone@<SevOne Data Insight IP address or hostname>

Go to /home/sevone folder.
```
$ cd /home/sevone
```
Download the following (latest) files from IBM Passport Advantage (https://www.ibm.com/software/passportadvantage/pao_download_software.html) via Passport Advantage Online. However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact IBM SevOne Support for the latest files. You must place these files in /home/sevone/ directory.
- signature-tools-latest-version-build.<###>.tgz. For example, signature-tools-2.0.2-build.1.tgz
- signature-tools-latest-version-build.<###>.tgz.sha256.txt. For example, signature-tools-2.0.2-build.1.tgz.sha256.txt

Execute the following commands to verify the checksum of the code signing tool before extracting it

$ (cat $(ls -Art signature-tools-*.tgz.sha256.txt | \
  tail -n 1) | sha256sum --check)

$ sudo tar xvfz $(ls -Art signature-tools-*.tgz | \
  tail -n 1) -C /

Make a directory. For example, wifi-6.8.
```
$ mkdir wifi-6.8
```
Go to folder wifi-6.8.
```
$ cd wifi-6.8
```
Download the following (latest) files from IBM Passport Advantage (https://www.ibm.com/software/passportadvantage/pao_download_software.html) via Passport Advantage Online. However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact IBM SevOne Support for the latest files. You must place these files in /home/sevone/wifi-6.8 directory.
- wifi-sdi-widgets-v6.8.0-build.1.tar.gz
- wifi-sdi-widgets-v6.8.0-build.1.tar.gz.sha256.txt
Extract <wifi-6.8-widget-tar-package>.
```
$ tar xvf <wifi-6.8-widget-tar-package>
```
Run deploy.sh script.
```
$ ./deploy.sh /home/sevone/wifi-6.8/wifi-sdi-widgets-v6.8.0-build.1.tar.gz
```
If your password contains any special characters, please run the deployment script using the following command. You must enclose the password in double quotes.
Example
```
$ ./deploy.sh /home/sevone/wifi-6.8/wifi-sdi-widgets-v6.8.0-build.1.tar.gz --password "abc#$def"
```
To know more options that are available for deploy.sh script, you may use the --help or -h option.
```
$ ./deploy.sh --help

deploy.sh -- A one click widget packet installer

Usage:
  ./deploy.sh <YOUR_WIDGET_PACKAGE_FILE.tar> [--force] [--user <DI_USERNAME>] [--password <DI_PASSWORD>] [--tenant <DI_TENANT_NAME>] [--host <DI_HOST_NAME>] [--import-ootb-reports] [--datasource-name <DATASOURCE_NAME>]
```
Alternate Method: Commands to install each widget individually Install only one widget
```
$ ./install-widget.sh <widget-in-question>.tgz --user <USERNAME> --password <PASSWORD> --tenant <TENANT> --host <DI-HOST>
```
Example: Manually install AP Audit Table widget
```
$ ./install-widget.sh ap-audit-table-6.8.0.tgz --user admin --password SevOne --tenant "DI Primary Tenant" --host example.di.sevone.com
```
Note:
- Replace widget-in-question with the .tgz file name.
- Replace USERNAME, PASSWORD, TENANT with the credentials you would normally use to log into SevOne Data Insight.
- Replace DI-HOST with the URL that you use to access SevOne Data Insight from your browser.
Note: Insert the correct values at the prompts.

To import out-of-the-box (OOTB) reports, please execute the following command.

Execute this command to import OOTB reports
```
$ ./deploy.sh /home/sevone/wifi-6.8/wifi-sdi-widgets-v6.8.0-build.1.tar.gz --import-ootb-reports
```
Important:
- OOTB reports will be imported to your SevOne Data Insight only when the --import-ootb-reports flag is enabled.
- To import OOTB reports on SevOne Data Insight, please refer to section Import OOTB Reports on SevOne Data Insight.
Once the script has been successfully executed, the following widgets are installed.
- AP Audit Table (WLC widget)
- AP Details (WLC widget)
- Cisco AP Inspector (WLC widget)
- WLC Inspector (WLC Widget)
- Wifi Signal Quality (WLC widget)
- Wifi Station Details (WLC widget)
- Wifi Station Summary (WLC widget)

Upgrade

Edit online

To upgrade the existing WLC/Generic widgets on SevOne Data Insight, execute the following commands.

ssh to your SevOne Data Insight machine as sevone user.

$ ssh sevone@<SevOne Data Insight IP address or hostname>

Go to /home/sevone folder.
```
$ cd /home/sevone
```
Download the following (latest) files from IBM Passport Advantage (https://www.ibm.com/software/passportadvantage/pao_download_software.html) via Passport Advantage Online. However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact IBM SevOne Support for the latest files. You must place these files in /home/sevone directory.
1. signature-tools-<latest version>-build.<###>.tgz
  For example, signature-tools-2.0.2-build.1.tgz
2. signature-tools-<latest version>-build.<###>.tgz.sha256.txt
  For example, signature-tools-2.0.2-build.1.tgz.sha256.txt

Execute the following commands to verify the checksum of the code signing tool before extracting it.

$ (cat $(ls -Art signature-tools-*.tgz.sha256.txt | \
  tail -n 1) | sha256sum --check)

$ sudo tar xvfz $(ls -Art signature-tools-*.tgz | \
  tail -n 1) -C /

Make a directory. For example, wifi-6.8.
```
$ mkdir wifi-6.8
```
Go to folder wifi-6.8.
```
$ cd wifi-6.8
```
Download the following (latest) files from IBM Passport Advantage (https://www.ibm.com/software/passportadvantage/pao_download_software.html) via Passport Advantage Online. However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact IBM SevOne Support for the latest files. You must place these files in /home/sevone/wifi-6.8 directory.
1. wifi-sdi-widgets-v6.8.0-build.1.tar.gz
2. wifi-sdi-widgets-v6.8.0-build.1.tar.gz.sha256.txt
Extract <wifi-6.8-widget-tar-package>. For example, wifi-sdi-widgets-v6.8.0-build.1.tar.gz.
```
$ tar xvf /home/sevone/wifi-6.8/wifi-sdi-widgets-v6.8.0-build.1.tar.gz
```
Run deploy.sh script.
```
$ ./deploy.sh /home/sevone/wifi-6.8/wifi-sdi-widgets-v6.8.0-build.1.tar.gz --force
```
If your password contains any special characters, please run the deployment script using the following command. You must enclose the password in double quotes.

Example
```
$ ./deploy.sh /home/sevone/wifi-6.8/wifi-sdi-widgets-v6.8.0-build.1.tar.gz --force --password "abc#$def"
```
To know more options that are available for deploy.sh script, you may use the --help or -h option.
```
$ ./deploy.sh --help

deploy.sh -- A one click widget packet installer

Usage:
  ./deploy.sh <YOUR_WIDGET_PACKAGE_FILE.tar> [--force] [--user <DI_USERNAME>] [--password <DI_PASSWORD>] [--tenant <DI_TENANT_NAME>] [--host <DI_HOST_NAME>] [--import-ootb-reports] [--datasource-name <DATASOURCE_NAME>]
```
Note: Insert the correct values at the prompts.

To import OOTB reports, please execute the following command.

Execute this command to import OOTB reports
```
$ ./deploy.sh /home/sevone/wifi-6.8/wifi-sdi-widgets-v6.8.0-build.1.tar.gz --force --import-ootb-reports
```
Important:
- OOTB reports will be imported to your SevOne Data Insight only when the --import-ootb-reports flag is enabled.
- To import OOTB reports on SevOne Data Insight, please refer to section Import OOTB Reports on SevOne Data Insight.
Once the script has been successfully executed, the following widgets are installed.
- AP Audit Table (WLC widget)
- AP Details (WLC widget)
- Cisco AP Inspector (WLC widget)
- WLC Inspector (WLC Widget)
- Wifi Signal Quality (WLC widget)
- Wifi Station Details (WLC widget)
- Wifi Station Summary (WLC widget)

Import OOTB Reports on SevOne Data Insight

Edit online

To import OOTB reports independent of installation/upgradation of widgets, please execute the following command.

for SevOne Data Insight >= 3.5 to 3.9

$ bash /opt/SevOne/upgrade/utilities/toolbox-*/ootb-reports <REPORTS-TAR-FILE-PATH>

for SevOne Data Insight >= 3.10

$ sevone-cli sdi reports load <REPORTS-TAR-FILE-PATH>

Important: This command needs to be run on SevOne Data Insight machine, where you want to import the OOTB reports.

Post-Deployment

Edit online

Log in to SevOne Data Insight. If you are already logged in, refresh the page. It may take a couple minutes for the page to reload.
In the left navigation bar, click Create to access the list of widget types to create a report from. Or, if you select Reports, you can click Create Report in the upper-right corner to access the list of widget types to create a report from.
In the right panel, Select a Widget section now includes the following Wifi/WLC widget(s):
- AP Audit Table (WLC widget)
- AP Details (WLC widget)
- Cisco AP Inspector (WLC widget)
- WLC Inspector (WLC Widget)
- Wifi Signal Quality (WLC widget)
- Wifi Station Details (WLC widget)
- Wifi Station Summary (WLC widget)
Click the info icon available for the Wifi widgets in the Select a Widget section. You will notice that the version of widgets is now changed to 6.8.0 . To check the version of individual widgets, execute the following command on your SevOne Data Insight machine.
Example
```
$ sevone-cli exec wdkserver -- cat /opt/widget-server/data/wuploads/wifi-signal-quality/widget.json | jq .version
```