This is documentation for Semarchy xDI 2023.2, which is no longer supported.

For more information, see our Global Support and Maintenance Policy.

Manage Package Manager Versions

A Package Manager is a versioned container for deliveries sources to build and deploy.

Overview

Each Package Manager defined in a Delivery Project has its lifecycle and versions that change over time.

A Package Manager Version corresponds to a consistent set of sources deployed together to environments.

Package manager versions example

The following table illustrates the concept of Package Manager Version. Each version contains different sets of sources.

Package Manager Version Sources contained in the version

Version 1.0

Process_A

Version 1.1

Process_A, Process_B

Version 1.2

Process_A, Process_B_updated

Version 2.0

Process_C

Create a Package Manager Version

To create a package manager version:

  1. In the Navigator view, expand the Delivery Projects node, then expand the delivery project.

  2. Double-click the name of the package manager you want to edit.
    The Package Manager editor opens. In this editor’s table, each Package Manager Version appears as a row in the table and each column corresponds to an Environment into which the package manager version can be deployed.

  3. Click the Add Version button in the table’s toolbar.

  4. Enter a Name for the package editor version. That name is automatically generated.
    ana package editor add version

  5. Import sources in the version:

    1. Click the ana packages import 16x16 Import Packages button in the list of Sources to import sources to the version.

    2. In the Import Packages dialog, click the Add button to select a source package archive generated with Semarchy xDI Designer or drop that file on the dialog.

    3. Repeat the previous operations for all your sources, and then click OK

Manage Sources in a Version

You can manage sources existing package manager version:

  • Import new or replacement sources

  • Delete existing sources

Import Sources

To import new sources or to update existing ones in a version:

  1. In the Navigator view, expand the Delivery Projects node, then expand the delivery project.

  2. Double-click the name of the package manager you want to edit.
    The Package Manager editor opens.

  3. Double-click the version in the package editor.

  4. Import sources in the version:

    1. Click the ana packages import 16x16 Import Packages button in the list of Sources to import sources to the version.

    2. In the Import Packages dialog, click the Add button to select a source package archive generated with Semarchy xDI Designer or drop that file on the dialog.

    3. Repeat the previous operations for all your sources, and then click OK

When importing sources Semarchy xDI Production Analytics automatically checks the consistency of the version with the deployments. Warning or error indicators appear on the deployment cards to indicate possible issues.

Delete Sources

To delete sources from an existing package manager version:

  1. In the Package Manager editor, double-click the version.

  2. In the Version dialog, select a source and click the Delete button.

Duplicate an Existing Version

You can create a copy of an existing package manager version by clicking the Duplicate button on the package manager version card in the package manager editor.

ana package editor dupplicate

This action creates a new version with an automatically computed name, with the same sources as the duplicated version.

Rename a Version

To rename an existing package manager version:

  1. In the Package Manager editor, double-click the package manager version card.

  2. Change the Name value in the Version dialog.

  3. Click OK

Remove a Version

You can remove an existing package manager version by clicking the Delete button on the package manager version card in the package manager editor.

Deleting a version cannot be undone.