The Connector Migration Tool is a utility provided as part of the Information Server product, and can be used to identify and optionally upgrade deprecated stages in DataStage jobs.
MettleCI provides an intelligent wrapper around the Connector Migration Tool to identify and upgrade the relevant jobs, also reporting issues that cannot be resolved by the Connector Migration Tool itself.
You can use the Execute Connector Migration Tool task to invoke the Connector Migration Tool and log its output to the Bamboo log.
Task Availability
Configuration Steps
- Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).
- Click the name of an existing Export DataStage Asset task, or click Add Task and then search 'DataStage' to easily locate the Export DataStage Asset task type, in order to create a new task.
Complete the following settings:
Task Description A description of the task, which is displayed in Bamboo Disable this task Check, or clear, to selectively run this task Executable From the pulldown list, choose a 'Datastage Capability' Domain Enter the Domain of the Datastage instance (Host Name of the Services Tier) Server Enter the Server of the Datastage instance (Host Name of the Engine Tier) Username Enter the Datastage Username Password Enter the Datastage Password Project name DataStage Project the Connector Migration Tool is to be run against Optional parameters Refer to step 3 of the Connector Migration Tool command line reference information for additional options that can be incorporated into the execution
Note: the MettleCI function already uses the -d optional part of its default operation
Unique CCMigrate Log Filename Name of the log file generated by the Connector Migration Tool Root ISX Directory File pattern to locate ISX files. Set to **/* for all files under the default location.
Note: preferable to specify as a bamboo Artifact
Max Threads Sets the maximum number of concurrent executions of the Connector Migration Tool Fail plan when compile error Conditionally abort the plan and return status of Fail if a migrated job fails to compile