Cisco Viptela PowerPack Release Notes, version 104

Version 104 of the Cisco: Viptela PowerPack includes an update to existing Dynamic Applications and resolutions to data collection issues.

  • Minimum Required SL1 Version: 11.1.0

Before You Install or Upgrade

Ensure that you are running version 11.1.0 or later of SL1 before installing "Cisco: Viptela" PowerPack version 104.

For details on upgrading SL1, see the relevant SL1 Platform Release Notes.

Installation or Upgrade Process

By default, installing a new version of a PowerPack will overwrite all content in that PowerPack that has already been installed on the target system. You can use the Enable Selective PowerPack Field Protection setting in the Behavior Settings page (System > Settings > Behavior) to prevent the new version of the PowerPack from overwriting local changes for some commonly customized fields.

If you are currently using the Dynamic Applications in this PowerPack to monitor devices, collection errors might occur for one or two polling cycles during the installation of a new version. To prevent collection errors during an upgrade, you can optionally disable collection for monitored devices before performing the following steps and re-enable collection after the upgrade.

To install version 104 of the Cisco: Viptela PowerPack, perform the following steps:

  1. See the Before You Install or Upgrade section. If you have not done so already, upgrade your system to the minimum required platform version or later release.
  2. Familiarize yourself with the Issues for this release.
  3. Download Version 104 of the Cisco: Viptela PowerPack from the Support Site to a local computer.

  4. Go to the PowerPack Manager page (System > Manage > PowerPacks). Click the Actions menu and select Import PowerPack. When prompted, import Version 104 of the Cisco: Viptela PowerPack.

  5. After importing/upgrading the PowerPack, you will be prompted to install the PowerPack. Click the Install button to install the PowerPack.

  6. To ensure all apps are collecting data after the upgrade, go to the Credentials page (Manage > Credentials). Identify the current credential and click the Edit button. Add %silo_token=X-XSRF-TOKEN as a header in the HTTP Headers section and click the Save button.

  7. Go to the Device Manager page (Devices > Device Manager). Identify the vManage virtual root device and click the Device Properties icon. In the Collections tab, select the Actions menu and click the Add Dynamic Application button. Select the Cisco: Viptela Token Configuration Dynamic Application with the current credential and save it. Perform these same steps to align the Cisco: Viptela vManage IP Address Configuration Dynamic Application to the root device.

  8. See the manual Monitoring Cisco Viptela for instructions on using the new PowerPack.

Features

This release includes the following features:

  • Dynamic Applications that enable SL1 to discover, model, and monitor Cisco: Viptela devices.

  • Device Classes for each type of Cisco: Viptela device monitored.
  • Event Policies and the corresponding alerts that are triggered when Cisco: Viptela devices meet certain status criteria.
  • An example credential that you can use as a template to create a SOAP/XML credential to connect to the Cisco: Viptela component devices that you want to monitor.
  • Dashboards that display information about Cisco: Viptela component devices.
  • "The Cisco: Viptela vManage Template" is available for aligning all Dynamic Applications to the root component device.

Enhancements and Issues Addressed

The following enhancements and addressed issues are included this release of the "Cisco: Viptela" PowerPack:

  • Addressed an issue in which log outs were causing collection gaps.
  • Updated the "Cisco: Viptela Events Caching" Dynamic Application to continue collecting data by updating the snippet code to use sessions generated by the "Cisco: Viptela Token Configuration" Dynamic Application.
  • Updated the silo_apps library version from 1.20.0 to 3.4.1 to work on SL1 11.2.

The value of the Max Sessions Per User field must be set as Disabled in the Administration Settings for this PowerPack to work correctly.

Known Issues

The following known issues affect version 104 of the Cisco: Viptela PowerPack:

  • There may be a collection gap in the "Cisco: Viptela Events Caching" Dynamic Application when you log out of a session.