Table of Contents

Search

  1. Preface
  2. Understanding the Repository
  3. Using the Repository Manager
  4. Folders
  5. Managing Object Permissions
  6. Local and Global Shortcuts
  7. Team-Based Development with Versioned Objects
  8. Labels
  9. Object Queries
  10. Team-Based Development with Deployment Groups
  11. Copying Folders and Deployment Groups
  12. Exporting and Importing Objects
  13. Exchanging Metadata
  14. Copying Objects
  15. Metadata Extensions
  16. Appendix A: MX Views Reference

Repository Guide

Repository Guide

Steps to Copy a Deployment Group

Steps to Copy a Deployment Group

Use the Copy Deployment Group Wizard to copy objects in a deployment group. You can perform all of the tasks listed in Using the Copy Wizards. You can also complete the following tasks:
  • Choose deployment folders.
    You can choose the folders in the target repository you want to deploy.
  • Apply labels to source and target objects.
    You can apply labels to the deployment group objects in the source and target repositories. For example, you may want to apply a label to the source and target objects that specifies when the source object version was deployed and when the target object version was created.
  • Move labels
    . You can move labels from version to version in source and target repositories. For example, you might want to move a label from the last version to the latest version before you deploy an object. Or, you might want to deploy an earlier version of an object and apply the latest label to the object.
  • Clear the static deployment group when you finish copying.
    You can remove the copied objects from a static deployment group when you finish copying them into the target repository.
Before you copy a deployment group, verify that existing objects in the target repository are not checked out or locked. Also, copy dependent shared folders for shortcuts in the deployment group.
If objects in the target repository are locked, by default the deployment operation waits until either the locks are acquired or you cancel the deployment. If you use
pmrep
to copy the deployment group, you can specify a deployment timeout period. If
pmrep
does not acquire the object locks within the timeout period, the deployment operation fails.
The default behavior is different if you attempt to replace a folder and the target folder is locked. The deployment operation does not wait for the locks to be released. The deployment fails immediately, and an error message indicates that the target folder is in use.
  1. Connect to the source and target repositories.
  2. Select the deployment group to copy.
  3. Drag or paste the deployment group to the target repository.
    The Copy Deployment Group Wizard appears, displaying the folder name and target repository name.
  4. The Copy Deployment Group Wizard prompts you to select a mode:
    • Typical.
      The wizard uses the defaults for shortcuts to local and global shared folders.
    • Advanced.
      You can override the defaults for shortcuts to local and global shared folders. You can choose the shared folders to associate shortcuts. The wizard might have to determine how the folders are related before establishing shortcuts.
  5. Click Next. The Copy Deployment Group Wizard prompts you for more information based on the content of the folders and the copy mode you selected.
    The Next button is disabled if object locks cannot be acquired in the target repository. When the objects in the target repository become available, the Next button is enabled. To stop the replacement, click Cancel. The wizard rolls back all changes.
The following table lists the dialog boxes and prompts that may appear when you copy a deployment group:
Copy Deployment Group Wizard Dialog Box
Modes
Description
Select Deployment Folders
Typical, Advanced
Folders you want to deploy objects to.
Override Deployment Folder
Typical, Advanced
Overrides the default selections for deployment folders.
Select Labels
Typical, Advanced
Selects a label in the source repository to apply to the copied object versions, and selects a label in the target repository to apply to the newly created object versions.
Clear Source Deployment Group
Typical, Advanced
Removes objects from the deployment group after the wizard completes the deployment operation.
Source/Target Comparison
Typical, Advanced
Specifies if objects in the target folder have been created or modified since the last copy.
Sequence Generators and Normalizers
Typical, Advanced
Retains current values for Sequence Generator and Normalizer transformations and XML generated keys. XML generated keys include primary and foreign keys in XML transformations.
Mapping Variables
Typical, Advanced
Retains persistent values for mapping variables.
Dependency Information
Typical, Advanced
Copies dependency information for objects in mappings if it exists. The dependency information exists if you set the general options for the Designer to save MX data. The dependency information is organized in a format that enables reporting tools to skip steps such as fetching the entire mapping and parsing expressions when collecting information for reporting.
Retain Workflow Variable Persisted Values
Typical, Advanced
Retains persistent values.
Retain Workflow Run History
Typical, Advanced
Retains existing workflow run history in the target repository or folder. When you copy a deployment group, you cannot copy the workflow run history from the source repository or folder.
Retain Integration Service Assignment
Typical, Advanced
Retains the assigned Integration Service for workflows.
Database Connections
Typical, Advanced
Lists all database connections in the folder, indicating the connections for which you do not have permission to copy.
Message Queue Connections
Typical, Advanced
Lists all message queue connections in the folder.
FTP Connections
Typical, Advanced
Lists all FTP connections in the folder, indicating the connections for which you do not have permission to copy.
External Loaders
Typical, Advanced
Lists all external loader connections in the folder, indicating the connections for which you do not have permission to copy.
Application Connections
Typical, Advanced
Lists all application connections in the folder, indicating the connections for which you do not have permission to copy.
MMD Plug-in
Typical, Advanced
Lists plug-in application information upon which the source folder depends if the plug-in information does not exist in the target repository.
Integration Services
Typical, Advanced
Selects an Integration Service to associate with workflows. If the target repository contains less than two Integration Services, the wizard skips this step.
Local Shared Folders
Typical
Lists local shared folders in the target repository that you need to copy first. To preserve shortcuts and prevent invalid mappings, click Cancel and copy all listed local shared folders before copying the folder.
Outdated Shared Folders
Typical
Lists outdated folders in the target repository that you need to copy first. To preserve shortcuts and prevent invalid mappings, click Cancel and copy all listed local shared folders before copying the folder.
Select Shared Folders
Advanced
Lists the folder that contains shortcuts and the folder to which you can establish shortcuts. You can choose to accept or override the shared folder.
Override Shared Folder
Advanced
Lists folders you can select to establish shortcuts if you choose to override the default folder selection in the Select Shared Folders dialog box.
Compare Folder
Advanced
Compares folders if the folders you choose in the Override Shared Folder dialog box are different. You can compare the folders using a one-way comparison. To compare the folder objects using two-way comparison, use the Compare Folders Wizard before you start the Copy Folder Wizard.
Compare Shared Folder -Compare Results
Advanced
Lists the results from the folder comparison, displays objects that exist in the local shared folder but not in the global shared folder, and displays objects that are older or newer than matching objects in the global shared folder. When you compare the folders using a one-way comparison, you can check the folder objects that excludes the mapping variable values.
If there are differences between the folders, a message warns you that shortcuts to missing objects will be removed. The wizard takes you back to Select Shared Folders dialog box.
Copy Definition
Typical, Advanced
Copies the deployment group from the source repository to the target repository.
Deployment Group Exists
Typical, Advanced
Replaces an existing deployment group in the target repository. Shows either the existing copies of the deployment group in the repository or all the deployment groups in the repository.
Replace Conflicting Objects
Typical, Advanced
Replaces conflicting objects in the target non-versioned repository. You can choose to replace the conflicting object in the target repository with the object in the deployment group. Does not appear for versioned repositories.
Owner and Group
Typical, Advanced
Selects the owner for the copied deployment group in the target repository. Default is the current user.
Post-Validation
Typical, Advanced
Validates the objects in the target repository after you copy a deployment group to verify that the objects and dependent objects are valid.
Complete Deployment
Typical, Advanced
Copies the deployment group immediately after you complete the wizard and generates a deployment control file to use with the
pmrep
command line program. Or, both copies the deployment group and creates the deployment control file. You can select to create the deployment control file without copying the deployment group.
If you do not specify an absolute path, the Repository Manager generates the deployment control file in the directory where the Repository Manager runs.
The Repository Manager generates the deployment control file encoded in UTF-8 format.

0 COMMENTS

We’d like to hear from you!