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

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

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.

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

1. Using ssh, login to SevOne Data Insight appliance as sevone.

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

2. Go to /home/sevone folder.

   $ cd /home/sevone

3. 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.<latest>.tgz
   2. signature-tools-<latest-version>-build.<latest>.tgz.sha256.txt
4. 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 /

5. Make a directory. For example, sdwan-7.0.

   Example

   $ mkdir sdwan-7.0

6. Go to folder sdwan-7.0.

   $ cd sdwan-7.0

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-7.0 directory.
   1. sdwan-widgets-v7.0.0-build.9.tar.gz
   2. sdwan-widgets-v7.0.0-build.9.tar.gz.sha256.txt
8. Extract the widget tar file.

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

9. Run deploy.sh script.

   Example

   $ ./deploy.sh /home/sevone/sdwan-7.0/sdwan-widgets-v7.0.0-build.9.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-7.0/sdwan-widgets-v7.0.0-build.9.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>

   Note: Insert the correct values at the prompts.
10. Once the script has been successfully executed, the following widgets are installed.
    • Geo Topology
    • Network Topology
    • Site-to-Site Traffic

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

1. Using ssh, login to SevOne Data Insight appliance as sevone.

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

2. Go to /home/sevone folder.

   $ cd /home/sevone

3. 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.<latest>.tgz
   2. signature-tools-<latest-version>-build.<latest>.tgz.sha256.txt
4. 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 /

5. Make a directory. For example, sdwan-7.0.

   Example

   $ mkdir sdwan-7.0

6. Go to folder sdwan-7.0.

   $ cd sdwan-7.0

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-7.0 directory.
   1. sdwan-widgets-v7.0.0-build.9.tar.gz
   2. sdwan-widgets-v7.0.0-build.9.tar.gz.sha256.txt
8. Extract the widget tar file.

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

9. Run deploy.sh script.

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

   $ ./deploy.sh /home/sevone/sdwan-7.0/sdwan-widgets-v7.0.0-build.9.tar.gz

   From SD-WAN < 2.9 to SD-WAN 7.0

   $ ./deploy.sh /home/sevone/sdwan-7.0/sdwan-widgets-v7.0.0-build.9.tar.gz --force

   To delete deprecated widgets, please run the deployment script using the following command.

   Example

   ./deploy.sh <sdwan-widgets-7.0-tar-package> --force --delete-old-widgets

   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-7.0/sdwan-widgets-v7.0.0-build.9.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.
10. Once the script has been successfully executed, the following widgets are installed.
    • Geo Topology
    • Network Topology
    • Site-to-Site Traffic

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

1. 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.
2. 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.
3. In the right panel, Select a Widget section now includes the following SD-WAN widgets:
   • Geo Topology
   • Network Topology
   • Site-to-Site Traffic
4. 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 7.0.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/site-to-site/widget.json | jq .version