Introduction to the SL1: System Upgrade Assessment PowerPack

Download this manual as a PDF file

This section describes how to use the "SL1: System Upgrade Assessment" PowerPack.

What is the SL1: System Upgrade Assessment PowerPack?

The "SL1: System Upgrade Assessment" PowerPack provides an efficient way to identify the PowerPacks that need to be rebuilt before upgrading to a newer SL1 version. This is done by having the "SL1: System Upgrade Assessment" PowerPack generate reports of these PowerPacks.

ScienceLogic strongly recommends rebuilding the PowerPacks that are identified in these reports. If you upgrade your SL1 system to a newer version without exporting the PowerPacks included in these reports, the PowerPacks will render as read-only.

What Does the SL1: System Upgrade Assessment PowerPack Include?

The "SL1: System Upgrade Assessment" PowerPack generates reports that identifies the PowerPacks that need to be rebuilt before upgrading to a newer SL1 version. There are two report tools in this PowerPack:

  • Python Assessment Tool, which identifies PowerPacks that need to be rebuilt before upgrading to a newer SL1 version.
  • PowerPack Encryption Validation, which identifies PowerPacks that need to be rebuilt before upgrading SL1 to version 11.3.0 or above.

The "SL1: System Upgrade Assessment" PowerPack includes the following features:

  • The silo_low_code library
  • The "SL1: System Upgrade Assessment Python 2 Verification" run book automation (RBA)

Installing the SL1: System Upgrade Assessment PowerPack

Before you can use the System Upgrade Assessment tool, you must import and install the latest version of the "SL1: System Upgrade Assessment" PowerPack.

To download and install a 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.

If you exit the PowerPack Installer without installing the imported PowerPack, the imported PowerPack will not appear in the PowerPack Manager page. However, the imported PowerPack will appear in the Imported PowerPacks page. This page appears when you click the Actions menu and select Install PowerPack.

Updating Legacy PowerPacks in SL1 12.3.0 and Later

You should read this section and, if necessary, complete the steps described before upgrading to SL1 version 12.3.0 or later. Otherwise, an unconverted PowerPack will have its license switched to read-only and you will not be able to recover a writeable state for it after 12.3.0 is installed.

Encryption and decryption methods that were used in legacy PowerPacks, which includes PowerPacks developed for SL1 10.x and earlier, have been deprecated as of the SL1 12.3.0 release.

As part of this effort, a check was added to ensure that PowerPacks are using the encryption method that is required in version 12.3.0 and later. If you attempt to upgrade to 12.3.0 or later, the upgrade will fail if any PowerPacks using the old encryption method are installed on your SL1 instance.

To ensure that any legacy PowerPacks on your SL1 stack continue to work, you should run the "PowerPack Encryption Validation Report" tool and rebuild any PowerPacks it identifies as not meeting the new encryption criteria before upgrading to SL1 version 12.3.0 or later.

Before you begin the upgrade process to SL1 version 12.3.0 or later, complete the following steps:

  1. Download and install the "SL1: System Upgrade Assessment" PowerPack on the SL1 system you are upgrading.

  2. Generate the "PowerPack Encryption Validation" report (Reports > Run Report > System Upgrade Assessment > PowerPack Encryption Validation). The report will identify all of the PowerPacks that are impacted.

  3. Open each PowerPack from the report, save it, and then click Build / Export > Create a New Build > Build. This process updates the encryption model for the PowerPack to the new version.

    As a best practice, you should download the updated PowerPacks, but you do not need to import the updated PowerPacks to your existing SL1 system before you upgrade to 12.3.0.