The MettleCI Connector Migration Tool plugin is used to automate the changing of Jobs to use Connector Stages instead of the deprecated Plug-in and Operator Stages. It uses the IBM-supplied Connector Migration Tool (AKA 'CCMT') which is provided as part of the installation media for each new version of DataStage.
The plugin will update and re-compile all Jobs containing the deprecated Stages.
Instructions
Artifacts
Go to Artifacts tab, and add a new definition for InfoServer Assets
| Name | Location | Copy pattern | Operations |
|---|---|---|---|
| InfoServer Assets | datastage | **/* | Share |
Tasks
Create 2 Tasks in the following order
- Source Code Checkout
- Execute Connector Migration Tool
You may add additional tasks in between Source Code Checkout and Execute Connector Migration Tool. However, Source Code Checkout must always come before Execute Connector Migration Tool.
| Input | Mandatory | Type | Description |
|---|---|---|---|
| Task description | N | Text field | Description of the Bamboo task |
| Disable this task | N | Checkbox | If checked, this task will be disabled |
| Repository | Y | Selection | The name of the repository |
| Checkout Directory | N | Text field | Alternate sub-directory to which the code will be checked out Suggested Value Leave blank |
| Force Clean Build | N | Checkbox | Removed the source directory and check it out again prior to each build Suggested Value Checked |
| Input | Mandatory | Type | Description |
|---|---|---|---|
| Task description | N | Text field | Description of the Bamboo task |
| Disable this task | N | Checkbox | If checked, this task will be disabled |
| Executable | Y | Selection | The name of the DataStage client capability to be used by this task At least one DataStage client capability needs to be defined |
| InfoServer Authentication | |||
| Domain | Y | Text field | The URL <domain name>:<port number> of the IBM Information Server Services tier Suggested Value ${bamboo.Domain} |
| Server | Y | Text field | The URL<domain name> of the IBM Information Server Engine tier Suggested Value ${bamboo.ServerName} |
| Username | Y | Text field | The username used to connect to IBM Information server Suggested Value ${bamboo.DatastageName} |
| Password | Y | Text field | The password for the username specified above (if you check the Change password box) Suggested Value ${bamboo.DatastagePassword} |
Execute Settings | |||
| Project Name | Y | Text field | The name of the IBM Information Server DataStage project containing the job or sequence to execute |
| Optional parameters | N | Text field | Optional parameters
Preview mode = list the jobs that needs Connector Migration, but will not modify the jobs |
Unique CCMigrate Log Filename | Y | Text field | Unique log file name. Suggested Value ${bamboo.buildKey}.log |
| Root ISX Directory | Y | Textfield | It must match the InfoServer Assets location specified in Artifacts tab |
| Max Threads | Y | Textfield | Number of threads uses for identify before and after status Suggested Value 8 |
| Fail plan when compile error | N | Checkbox | True = Build plan will fail when it encounter compilation error False (default) = Build plan will pass, even if there are compilation error |
Due to a known bug with Bamboo Remote Agent running on Windows. (If running Bamboo 6.10 or higher, the following no longer applies as the Bamboo Bug has been fixed)
If you need to run dm-ccmigrate-plugin via Remote agent you will need to do the following workaround
Remote Agent Workaround
- Configure Bamboo Remote Agent to run as an application user (via Windows Services)
- Add the following 2 paths to the application user path (not system path)
- %SystemRoot%\system32
- <DataStage Client Installation Path>\ASBNode\apps\proxy\cpp\vc60\MT_dll\bin
Bamboo documentation for this workaround
Service wrapper issue - https://jira.atlassian.com/browse/BAM-16205?_ga=2.64634735.17192666.1547599188-2066070865.1384855247
The above work around to overcome the follow 2 errors respectively
- 'chcp' is not recognized as an internal or external command, operable program or batch file.
- the Return Code -1073741515
The above work around may not solve all the problems that might appear as a consequence of this Bamboo bug.
If another similar error code appears (E.g. -1073741819) is recommended to:
- Copy the value of the system Path environment variable and append it to the local user Path environment variable that is configured to run the Bamboo remote agent service.
Related articles
Filter by label
There are no items with the selected labels at this time.