Advanced Deployment

Semarchy xDI Production Analytics provides advanced capabilities to manage deployments.

These include restoring previous deployment builds and analyzing deployments for possible issues.

Restore a Previous Build

When a deployment is performed, Analytics stores a copy of the built deliveries. You can restore previous builds using three operations:

Restore a Build with the Original Metadata Configuration

To restore a build with the original metadata configuration:

  1. In the Package Manager editor, click the Builds button in the deployment card.
    The Build History dialog opens.

  2. In the Builds list, select the build to restore.

  3. In the Processes list, review the differences between the built sources and the current sources from the package manager version. Sources that differ appear with a Warning icon. Other sources appear with an OK icon.

  4. Review the Metadata configuration values for all the differences with the current Metadata Configuration values.

    • You can filter the Metadata displayed by selecting one or more sources in the Processes list. Hold the Ctrl or Shift key for multiple selections.

    • Values matching the existing Configuration appear with a green check icon. Different values appear with a warning icon.

  5. Click the ana packages publishAll 16x16 Deploy button to restore the selected build.

ana package editor builds list

Re-build and Deploy with the Current Metadata Configuration

To re-build and deploy with the current metadata configuration:

  1. In the Package Manager editor, click the icon in the lower-left corner of the deployment card to make this deployment the current working deployment for the environment.

  2. In the deployment card, click the Deploy button.
    ana package editor redeploy

Analytics applies the current metadata configuration values to the sources in the package manager version and publishes the deliveries to the environment’s runtimes, and the deployment appears with a Deployed indicator.

ana package editor deployed

Download Previous Build Deliveries

To download previous build deliveries:

  1. In the Package Manager editor, click the Builds button in the deployment card.
    The Build History dialog opens.

  2. In the Builds list, select the build containing the deliveries to download.

  3. Click the Download button.
    The deliveries are downloaded locally and you can install them manually on a runtime.

ana package editor download build

Analyze Deployments

When a package manager version is deployed to an environment Analytics can analyze the deployment and provide the detailed build and deployment status for each source process.

Analyze a Deployment

To analyze a deployment:

  1. In the Package Manager editor, click the Analyze button in the deployment card.

  2. The Analysis Report dialog opens.

deployment analysis

In the Analysis Report:

  • The Processes column contains the source process name with an icon indicating if that source process is valid or if warnings were detected.

  • The Build column indicates the Build Status of this source process.

  • The other columns, named after the runtimes, indicate the corresponding Delivery Status in each runtime.

Table 1. Build Status
Status Description Resolution

Missing Metadata

The source process imported in this version uses metadata values that have not been configured. This usually occurs when new sources were imported into the version after the initial deployment.

Set the values for the missing Metadata and re-deploy the version in the environment.

Build not Found

The build corresponding to the source process cannot be found. The build may have been manually deleted after the deployment or the sources were imported in the version after the initial deployment.

Re-deploy the version in the environment.

Version Mismatch

The build source process does not match the current source process. This usually occurs when new sources were imported into the version after the initial deployment.

Re-deploy the version in the environment.

Metadata Mismatch

The build metadata values do not match the current metadata values. This usually occurs if the configuration was updated since the previous deployment.

Re-deploy the version in the environment.

Valid

The build is up to date.

No action is required.

Table 2. Delivery Status
Status Description Resolution

Delivery not Found

The delivery was not found in the runtime. This may occur when a runtime was added to the environment after the deployment or if the delivery was manually deleted.

Re-deploy the version in the environment.

Runtime not Found

Analytics could not connect the runtime.

Check the connectivity to the runtime and restart the analysis.

Delivery Mismatch

The delivery currently deployed in the runtime does not match the current package manager version and metadata.

Re-deploy the version in the environment.

Deployed

The deployed delivery is up to date.

No action is required.

Analyze Multiple Deployments

Analytics can analyze multiple deployments and indicate the package Managers that require attention.

  1. In the Navigator tree view, select either:

    • The Delivery Projects node.

    • A Delivery Project under that node.

    • A Package Manager node under a delivery project.

  2. Right-click and select Validate

Analytics analyzes all the deployments under the selected node and displays in the Navigator view icons indicating the level of attention required.