Replication Export Details

The following sections explain how replication export processing is done for each kind of object that is exported.

Dependency Analysis

The export procedure automatically identifies all dependencies associated with the selected applications set, such as components, component templates, global processes, environments, resources, resource groups, agent pools, plugins, statuses, notification schemes, resource roles, and security roles. Inactive component versions, snapshots, and environments are excluded from the export. The rest of the objects are exported regardless of their status.

If the Include Snapshots option is selected, the export procedure automatically identifies all the versions used in snapshots and adds those versions to the exported file. Therefore, even if the Versioned Objects parameter is set to Latest, earlier versions will be added to the exported file if they are used in snapshots and the Include Snapshots option is selected.

Environments

Environments selected in the export wizard are exported.

List of items exported with an environment:

  • List of Resources (only resources associated with selected environments are included)
  • Associated Pipeline (included only if all environments in the pipeline are selected for export)

Applications

Applications selected in the export wizard are exported.

List of items exported with an application:

  • List of Environments (only environments selected for export are included)
  • List of Components
  • Component Mapping
  • Application Processes
  • Application Snapshots
  • Tasks Definition
  • PropSheet
  • Associated Pipeline

Inactive applications and environments within the application are not exported.

Components

List of items exported with a component:

  • Component Versions (both full and incremental versions are supported)
  • Component Processes
  • Post-processing scripts
  • Tasks Definition
  • Templates
  • PropSheet

Global Processes

List of items exported with a global process:

  • PropSheet
  • Post-processing scripts

Although a Global Process is a versioned object, only the latest version of a Global Process is exported from the source environment. This happens because users can't use a Global Process version on the source server other than the latest one.

Component Templates

List of items exported with a component template:

  • Processes
  • PropSheet

Pipelines

Only those pipelines that are associated with applications are exported.

Environments

Only those environments that are associated with applications are exported.

List of items exported with an environment:

  • Resource Set

Resources

Only objects used in environment resource sets are exported.

Resource Groups

Only objects used in environment resource sets are exported.

Agent Pools

Linked agents are not included in the export. Only agent pools used in exported resource sets are exported.

Plugins

If the Include plugins option is selected, the export procedure automatically determines which plugins are used in the exported processes and includes them in the data file. Only used plugins are included.

Statuses

Only statuses used in exported component versions and snapshots are included.

Notification Schemes

Only notification schemes used in exported applications are included.

Resource Roles

Only resource roles used in exported resources are included.

Security Roles

Only security roles used in exported processes, notification schemes, and version statuses are included.

Export Errors

You cannot export a process version if it invokes another process that has already been deleted, uses a plugin that has been removed from the system, or references a security role that has been removed. In these cases, the export procedure tries to remove the specific version of the process from the exported file. However, if after the process version is removed there are no versions of the process selected that can be exported, an error is generated and the export operation cancelled.

You cannot export component and global processes that contain recursive process invocation; for example, where process A invokes process B and process B in turn invokes process A. If you attempt this, the export procedure will immediately fail. Export parameters should be set up to exclude any recursive process invocation.