Packaging

The Packaging feature is used to export custom change control actions from one CloudVision cluster and install them in another. Package IDs and version numbers can be used to update existing packages with version control.

Accessing Packaging

The Packaging feature is available under Settings tab in the navigation bar.

Figure 1. Accessing Packaging

From the Packaging screen, you can create, install, and review packages.There are two main sections when managing packages:Managed Packages and Created Packages.

Managed Packages have been imported from another CloudVision cluster and installed. Hover over the package to review the description.The only available function is to unistall the selected package.

Created Packages are editable and available for export to another CloudVision cluster.

Note: Packages can only be edited and exported from,the cluster where they were created.

Create a Package

When creating a package you can select the components to be included.You can select studios, actions, and dashboards to bundle and export. Additional actions to manage the installation and uninstallation of packages and components can be added.

Creating a Package

  1. From the Packaing screen, select Create Package.
  2. Enter a package name.
  3. Create a unique Package ID and enter a version number.The Package ID should be human readable.The version number must be three digits(x.x.x).
    Note: Make sure that the ID does not match the Package ID of an existing package, otherwise an existing package may be overwriten.
  4. Enter a description of the package.
    Figure 2. Creating a Package
  5. Click Add Component and use the dropdown to select actions to include in the package. Selected actions will appear under Contents
    Note: Actions may be executed at different speeds.Limit the number of components in a package to those that are related and likely to change together, such as a pair of actions that run before and after a process.
  6. (Optional) Click Edit below any component name to create a unique Component ID.
  7. Click Create Package. The package will appear under Created Packages.
  8. Click Export on the package to download the .tar package file.
  9. Save the file to the appropriate repository so that it can easily be located for import and installation in another CloudVision cluster.

Installing a Package

Packages that have been exported as .tar files from another CloudVision cluster can be imported and installed.

  1. In the cluster that a packege is to be installed, open the Packaging screen and click Install Packages.
  2. Select or drag-and-drop the appropriate .tar file into the modal. Multiple packages may be selected and installed at the same time.
    Note: Check the version number and Package ID before installation to avoid overwriting an existing package.
    Figure 3. Installing Packages
  3. Select Upload.

Updating a Package

Updating a package will overwrite an existing package.

  1. Export the package to be overwritten.
  2. If the package to be overwritten is listed under Created Packages it must be deleted.
  3. Create a new package using the same name as the package to be updated.
  4. Enter the package ID with the same package ID of the original package.
  5. Increase the version number of the original package sequentially.
  6. Proceed to follow the steps for uploading and installing a package,
    Note: Before installing an updated package, verify that you select the .tar file with the appropriate version number.