Datacenter Automation Utilities PowerPack Release Notes, version 202

The "Datacenter Automation Utilities" PowerPack includes run book automation and run book action policies that assist with general-purpose activities for other installed "Datacenter Advanced Enrichment" or "Automation Policies" PowerPacks. You can use the run book actions with run book automations to collect additional diagnostic information when events occur and to provide instructions on how to troubleshoot issues. This additional information about an event is intended to assist the engineer responsible for troubleshooting and resolving that event.

This PowerPack also provides various enrichment utilities that validate network connectivity from SL1 to a target device, and "HTTP Action Template", a run book action template that you can use to make network requests (GET/POST) from SL1.

Version 202 of the "Datacenter Automation Utilities" PowerPack includes three enrichment actions and the "Automation Remote Login" Dynamic Application from the "Datacenter Advanced Enrichment Actions" PowerPack, which is now deprecated.  This release also addresses a number of issues.

Version 202 of this PowerPack is required for all "Automation" PowerPacks and all "Datacenter Automation Utilities" PowerPacks.

Before You Install or Upgrade

Ensure that you are running version 12.1.2 or later of SL1 before installing "Datacenter Automation Utilities" PowerPack version 202.

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

Upgrading from a Previous Version of the PowerPack

If you are using a version of the "Datacenter Automation Utilities" PowerPack before version 200, you will need to execute the following SQL on your SL1 system to ensure a seamless transition to this version. These queries ensure that any applicable run book actions, automation policies, and other content on the SL1 system from the previous versions of the "Network Connectivity" and "HTTP Action Type" PowerPacks can receive updates from the upgrade to version 202 of this PowerPack.

If you are upgrading from version 200 or later of this PowerPack, you can skip this step.

To upgrade from a previous release of the "Datacenter Automation Utilities" PowerPack:

  1. In SL1, go to the Database Tool page (System > Tools > DB Tool).

  2. Execute the following queries, one at a time:

    UPDATE 'master'.'automation_action_types' SET 'ppguid' = 'B93FB6E9C2E5C7BC8C99A55E4DDD673F' WHERE 'ppguid' IN ('2BF43CA3E82A767F2B14756B64D6E2AE', '1034B560B0D0DFDE390C248396F2A301');

    UPDATE 'master'.'automation_action_types' SET 'ppguid' = 'B93FB6E9C2E5C7BC8C99A55E4DDD673F' WHERE 'guid' IN ('EFE2255897C1700DE6601F6CB7892C9D');

    UPDATE 'master'.'policies_actions' SET 'ppguid' = 'B93FB6E9C2E5C7BC8C99A55E4DDD673F' WHERE 'ppguid' IN ('2BF43CA3E82A767F2B14756B64D6E2AE', '1034B560B0D0DFDE390C248396F2A301');

    UPDATE 'master'.'policies_automation' SET 'ppguid' = 'B93FB6E9C2E5C7BC8C99A55E4DDD673F' WHERE 'ppguid' IN ('2BF43CA3E82A767F2B14756B64D6E2AE', '1034B560B0D0DFDE390C248396F2A301');

    UPDATE 'master_dev'.'device_groups' SET 'ppguid' = 'B93FB6E9C2E5C7BC8C99A55E4DDD673F' WHERE 'ppguid' IN ('2BF43CA3E82A767F2B14756B64D6E2AE', '1034B560B0D0DFDE390C248396F2A301');

Also, if you were using a version of the now-deprecated "Datacenter Advanced Enrichment Actions" PowerPack on your SL1 system, you will need to run two additional queries.

To upgrade from the "Datacenter Advanced Enrichment Actions" PowerPack:

  1. In SL1, go to the Database Tool page (System > Tools > DB Tool).

  2. Execute the following queries, one at a time:

    UPDATE master.dynamic_app SET ppguid ="B93FB6E9C2E5C7BC8C99A55E4DDD673F" WHERE app_guid IN ("9E65983E6129D5B352197D171A66BB4E");

    UPDATE master.policies_actions SET ppguid ="B93FB6E9C2E5C7BC8C99A55E4DDD673F" WHERE action_guid IN ("7447456C1A06B17E845DFA12DDE06C97", "8CFB38D8D133F29F0DF67BB6ED3789AC", "D757533AD358FAE5272DABD873238360");

Installation Process

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 this PowerPack:

  1. Search for and download the PowerPack from the PowerPacks page (Product Downloads > PowerPacks & SyncPacks) at the ScienceLogic Support Site.
  2. In SL1, go to the PowerPacks page (System > Manage > PowerPacks).
  3. Click the Actions menu and choose Import PowerPack. The Import PowerPack modal appears.
  4. Click Browse and navigate to the PowerPack file from step 1.
  5. Select the PowerPack file and click Import. The PowerPack Installer modal displays a list of the PowerPack contents.
  6. Click Install. The PowerPack is added to the PowerPack Manager page.

Enhancements and Issues Addressed

The following enhancements and addressed issues are included in version 202 of the "Datacenter Automation Utilities" PowerPack:

  • Added the following content from the "Datacenter Advanced Enrichment Actions" PowerPack, which has been deprecated:

    • "Enrichment: Util: Collect Enrichment Data" run book action
    • "Enrichment: Util: Load HTML Work Instructions" run book action
    • "Enrichment: Util: Load Plaintext Work Instructions" run book action
    • "Automation Remote Login" Dynamic Application

  • Updated ciphers used in the "Automation Remote Login" Dynamic Application and libraries.

  • Addressed an issue where the "Datacenter Automation: Format Output as HTML" action did not properly format new line characters in the output.

  • Added handling for custom device prompts to the "Enrichment: Util: Collect Enrichment Data" run book action. Instructions are described in a comment in the action snippet code, but for more information, see the Datacenter Automation Utilities manual.

  • Improved the error messages that display in the Event Actions Log modal for the "Enrichment: Util: Collect Enrichment Data" run book action.

  • As part of this release, ScienceLogic added the run book actions that were in the now-deprecated "Datacenter Advanced Enrichment Actions" PowerPack to the corresponding "Datacenter Advanced Enrichment" or "Automation Policies" PowerPacks. The updated PowerPacks include the following:

    • "Cisco Miscellaneous Automation Policies" PowerPack version 102

      This PowerPack was previously called the "Cisco Collaboration Automation Policies" PowerPack. This new version includes policies for Cisco ACE, Cisco CSP, Cisco NSO, Cisco OLT, Cisco StarOS, Cisco Tandberg, and System.

    • "Cisco NX Automation Policies" PowerPack version 102

    • "Cisco UCS Automation Policies" PowerPack version 102

    • "Cisco UCS C-Series Automation Policies" PowerPack version 101

    • "Cisco Unified Communication Manager Automation Policies" PowerPack version 101

    • "Citrix Netscaler Automation Policies" PowerPack version 102

    • "Datacenter Advanced Enrichment: Cisco IOS Policies" PowerPack version 103

    • "Datacenter Advanced Enrichment: Cisco IOS-XE Policies" PowerPack version 103

    • "Datacenter Advanced Enrichment: Cisco IOS-XR Policies" PowerPack version 103

    • "Datacenter Advanced Enrichment: Cisco Networking Policies" PowerPack version 103

    • "Datacenter Advanced Enrichment: Cisco Wireless Policies" PowerPack version 102

    • "F5 Automation Policies" PowerPack version 102

    • "Juniper JunOS and ScreenOS Automation Policies" PowerPack version 102

    • "NetApp Automation Policies" PowerPack version 102

Known Issues

This release has no known issues.