SD-WAN Collector Widgets for Data Insight Installation / Upgrade Guide

Edit online

About

Edit online

This document includes steps for installing the widgets available with the SD-WAN 6.7 collector in SevOne Data Insight.

Terminology usage...
In this guide if there is,

[any reference to master] OR
[[if a CLI command (for NMS or Kubernetes or Redis) contains master] AND/OR
[its output contains master]],

it means leader or control plane.
And, if there is any reference to slave, it means follower or Agent.

Prerequisites

Edit online

In order to deploy the SD-WAN Solution widgets, you will need the following:

For SevOne Data Insight versions compatible with this release, please refer to Release Notes SD-WAN Collector > Resources & Requirements > section Compatibility Matrix.
sevone access to the SevOne Data Insight machine
SevOne SD-WAN Collector installed on your SevOne NMS appliance or cluster
The widget tar file provided to you by IBM SevOne Production or IBM SevOne Support

Installation

Edit online

Execute the following steps to install SD-WAN widgets in SevOne Data Insight.

Note: Prior to executing the steps below, SevOne Data Insight must already be provisioned.

Using ssh, login to SevOne Data Insight appliance as sevone.
```
$ 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.1-build.1.tgz
2. signature-tools-latest-version-build.<###>.tgz.sha256.txt. For example, signature-tools-2.0.1-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, sdwan-6.7.
Example
```
$ mkdir sdwan-6.7
```
Go to folder sdwan-6.7.
```
$ cd sdwan-6.7
```
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/sdwan-6.7 directory.
1. sdwan-widgets-v6.7.0-build.2.tar.gz
2. sdwan-widgets-v6.7.0-build.2.tar.gz.sha256.txt

Extract the widget tar file.

$ tar xvf <sdwan-widgets-6.7-tar-package>

Run deploy.sh script.

Example

$ ./deploy.sh /home/sevone/sdwan-6.7/sdwan-widgets-v6.7.0-build.2.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/sdwan-6.7/sdwan-widgets-v6.7.0-build.2.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.sh <widget-tar-file-name>.tgz --user <DI_USERNAME> \
--password <DI_PASSWORD> --tenant <DI_TENANT> \
--host <DI_HOST (without http/https) or localhost>

Insert the correct values at the prompts.

Once the script has been successfully executed, the following widgets are installed.
- SD-WAN Alarm (Deprecated)
- SD-WAN Flow (Deprecated)
- Geo Topology
- Interface Queue Widget (Deprecated)
- Key Performance Indicators (KPI) (Deprecated)
- Network Topology
- Site-to-Site Traffic
- Device Summary (Deprecated)
- Tenants (Deprecated)

Upgrade

Edit online

To upgrade the existing SD-WAN widgets on SevOne Data Insight, execute the following commands.

Using ssh, login to SevOne Data Insight appliance as sevone.
```
$ 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.1-build.1.tgz
2. signature-tools-latest-version-build.<###>.tgz.sha256.txt. For example, signature-tools-2.0.1-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, sdwan-6.7.
Example
```
$ mkdir sdwan-6.7
```
Go to folder sdwan-6.7.
```
$ cd sdwan-6.7
```
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/sdwan-6.7 directory.
1. sdwan-widgets-v6.7.0-build.2.tar.gz
2. sdwan-widgets-v6.7.0-build.2.tar.gz.sha256.txt

Extract the widget tar file.

$ tar xvf <sdwan-widgets-6.7-tar-package>

Run deploy.sh script.

From SD-WAN >= 2.9 to SD-WAN 6.7

$ ./deploy.sh /home/sevone/sdwan-6.7/sdwan-widgets-v6.7.0-build.2.tar.gz

From SD-WAN < 2.9 to SD-WAN 6.7

$ ./deploy.sh /home/sevone/sdwan-6.7/sdwan-widgets-v6.7.0-build.2.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/sdwan-6.7/sdwan-widgets-v6.7.0-build.2.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>]

Insert the correct values at the prompts.

Once the script has been successfully executed, the following widgets are installed.
- SD-WAN Alarm (Deprecated)
- SD-WAN Flow (Deprecated)
- Geo Topology
- Interface Queue Widget (Deprecated)
- Key Performance Indicators (KPI) (Deprecated)
- Network Topology
- Site-to-Site Traffic
- Device Summary (Deprecated)
- Tenants (Deprecated)

Post-Deployment

Edit online

After completing the installation steps above, confirm that SD-WAN widgets are now available from SevOne Data Insight.

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 SD-WAN widgets:
- SD-WAN Alarm (Deprecated)
- SD-WAN Flow (Deprecated)
- Geo Topology
- Interface Queue Widget (Deprecated)
- Key Performance Indicators (KPI) (Deprecated)
- Network Topology
- Site-to-Site Traffic
- Device Summary (Deprecated)
- Tenants (Deprecated)
Click the info icon available for the SD-WAN widgets in the Select a Widget section. You will notice that the version of widgets is now changed to 6.7.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/sdwan-alarm/widget.json | jq .version
```