Import component versions

This topic provides an overview of the version import and explains how to import artifacts into Deployment Automation.

Overview

After defining a component's source and processes, you import its artifacts into the Deployment Automation artifact repository, CodeStation.

By default, a complete copy of an artifact's content is copied to CodeStation. The original artifacts are untouched. This provides tamper-proof storage and the ability to review and validate artifacts with the Deployment Automation user interface.

If you use a source configuration type that supports maintaining versions externally, you can limit CodeStation to using references to the artifacts instead of actually copying the artifacts.

Each time a component is imported, including the first time, it is versioned. Versions can be assigned automatically by Deployment Automation, applied manually, or come from a build server. Every time a component's artifacts are modified and re-imported, a new version of the component is created.

A component may have several unique versions in CodeStation. A version can be full or incremental. A full version contains all component artifacts, while an incremental version contains only the artifacts modified since the previous version was created.

Note: Typically, you can use the DA VFS plugin to download and deploy the artifacts as part of your component and global processes.

For administrative information, see Configure component version import.

Back to top

Import versions automatically

When the Import Versions Automatically check box is selected for a component, the source location is periodically polled for new versions, and any found are automatically imported. The default polling period is 15 seconds, which you can change in System Settings. For details, see Create components.

If you have multiple versions of files that you are trying to import into Deployment Automation at once, such as Dimensions CM baselines, only the latest version is imported through automatic import. If you need earlier versions, you must import them manually.

Caution: If the polling period is too short, the loading of the previous polling may be interrupted, causing partial import of the component version. We recommend that you do not set this option to less than default 15 seconds. You may set it higher as needed.

You can also set a quiet period. Specified in minutes, the quiet period gives time for any changes detected in a particular polling period to be imported before the next polling period starts. This prevents any changes done during processing to be missed in the next polling period.

Back to top

Import versions manually

If the Import Versions Automatically check box is not selected for a component, you must manually import the files and assign the versions.

To import versions manually:

  1. Navigate to Management > Components > [select component].

  2. Select the Versions tab and click Import. The system imports any new version of the component artifacts that it detects in the source configuration location for the component.

Back to top

Maintain versions externally

If you clear the Copy to CodeStation option for a component, Deployment Automation will maintain the full versions for that component only in the integrating source configuration tool.

Keeping artifacts in an external source has the following limitations to the component version management:

  • On the Versions > Artifacts page, you can download all versions in bulk but not individually.
  • Version information is obtained only during the version import. If you modify an artifact version in the source configuration tool, metadata stored about that version is not updated in CodeStation.
  • Changing connection parameters to external systems may affect the ability to download existing versions. For example, if credentials to a Dimensions CM server have changed or a file share location has been moved, the metadata stored for existing versions will not include the updated information.

    To mitigate this, if you want to download an earlier version, edit the component details and clear the Use Latest Component Properties for Version Download option. Selecting or clearing this option enables you to download versions from the current or original location, based on the component property settings. If you have changed the repository or connection parameters more than once between imports, you may not be able to download some versions.

    Caution: If you modify the source directory, you will not be able to download it again. The download procedure now strictly verifies that the content matches what was originally imported, including file set and size .

To ensure better performance, versions that are not stored in CodeStation are cached in local storage in the server profile. By default, versions are kept in local storage for 24 hours and then deleted. When a new download request is initiated, the server checks local storage first and provides the content from there if it is found. Otherwise, the server downloads the version and puts it in local storage. If needed, you can change the cache time in your server settings.

To change the cache time:

  1. Navigate to your Deployment Automation user profile directory, for example:

    Windows: C:\Users\<username>\.microfocus\da\conf\server

    UNIX/Linux: /opt/MicroFocus/da/<username>/.microfocus/da/conf/server

  2. Edit the da_config.xml and set the scheduledTimeInHRS property to the time you want the local storage cache to be retained, for example:
    <versionCacheCleanUpConfig>
        <scheduledTimeInHRS>12</scheduledTimeInHRS>
    </versionCacheCleanUpConfig>                   

If you later decide to select Copy to CodeStation, Deployment Automation begins copying the full version to CodeStation. The inventory maintains its integrity.

Back to top

View the version import queue

As versions are being imported for various components, you can view the version import requests that are running or waiting to run.

To view the queue of component version imports, click the Component Version Import View icon in the dashboard of the Deployment Automation user interface. It expands the Component Version Import View pane. The number on the icon indicates the number of import requests in the queue.

In the Component Version Import View pane, you can:

  • View information about each request, such as import type, time scheduled, who did the import, and status.
  • Open the page for the component by clicking the component name link.
  • View the list of current import requests.

Back to top

See also: