Versions Compared

Old Version 1

changes.mady.by.user John McKeever

Saved on

compared with

New Version 2

changes.mady.by.user John McKeever

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Info

The plugin will update and re-compile all Jobs containing the deprecated Stages. 


Instructions

Artifacts

Image Removed

Go to Artifacts tab,
Panel
titleContents

Table of Contents


Configuration Steps

  1. Navigate to the Artefacts configuration tab for your job and add a new definition for InfoServer Assets:

    NameLocationCopy patternOperations
    InfoServer Assetsdatastage**/*Share
Tasks

  1. Image Added

Image Removed

  1. Create

2

  1. two Bamboo Tasks in the following order:

    1. Source Code Checkout
    2. Execute Connector Migration Tool
    Info

    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.

Image Removed

  1. Image Added

  2. Configure each task as described below

Source Code Checkout Settings

Provide the following details:

InputMandatoryTypeDescription
Task descriptionNText fieldDescription of the Bamboo task
Disable this taskNCheckboxIf checked, this task will be disabled
RepositoryYSelectionThe name of the repository
Checkout DirectoryNText field

Alternate sub-directory to which the code will be checked out

Info
titleSuggested Value

Leave blank


Force Clean BuildNCheckbox

Removed the source directory and check it out again prior to each build

Info
titleSuggested Value

Checked

Image Removed



Image Added

Execute Connector Migration Settings

Provide the following details:


InputMandatoryTypeDescription
Task descriptionNText fieldDescription of the Bamboo task
Disable this taskNCheckboxIf checked, this task will be disabled
ExecutableYSelection

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
DomainYText field

The URL <domain name>:<port number> of the IBM Information Server Services tier


Info
titleSuggested Value

${bamboo.Domain}


ServerYText field

The URL<domain name> of the IBM Information Server Engine tier

Info
titleSuggested Value

${bamboo.ServerName}


UsernameYText field

The username used to connect to IBM Information server 

Info
titleSuggested Value

${bamboo.DatastageName}


PasswordYText field

The password for the username specified above (if you check the Change password box)

Info
titleSuggested Value

${bamboo.DatastagePassword}


Execute Settings

Project NameYText fieldThe name of the IBM Information Server DataStage project containing the job or sequence to execute
Optional parametersNText field

Optional parameters

  • -R to run the process in preview mode
Info

Preview mode = list the jobs that needs Connector Migration, but will not modify the jobs


Unique CCMigrate Log Filename

YText field

Unique log file name.

Info
titleSuggested Value

${bamboo.buildKey}.log


Root ISX DirectoryYTextfield

It must match the InfoServer Assets location specified in Artifacts tab


Max ThreadsYTextfield

Number of threads uses for identify before and after status

Info
titleSuggested Value

8


Fail plan when compile errorNCheckbox

True = Build plan will fail when it encounter compilation error

False (default) = Build plan will pass, even if there are compilation error

WarningDue to a known bug with Bamboo Remote Agent

Image Added

Image Removed

Remote Agent Workaround

Atlassian Bamboo Remote Agents running on Windows

.

(

If running

before Bamboo

6

v6.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

  1. Configure Bamboo Remote Agent to run as an application user (via Windows Services)
  2. 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

https://confluence.atlassian.com/bamkb/bamboo-or-remote-agent-does-not-pick-up-the-path-environment-variable-correctly-when-running-as-a-windows-service-323982768.html

Service wrapper issue - https://jira.atlassian.com/browse/BAM-16205?_ga=2.64634735.17192666.1547599188-2066070865.1384855247

Info

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
Info

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.

) exhibit a problem for which you may need to implement a workaround documented here.



Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@12973
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ( "ccmigrationtool" , "ccmt" , "dm-ccmigrate-plugin" , "connector" , "migration" , "ccmigrate" , "kb-how-to-article" , "mettleci" , "plugins" ) and type = "page" and space = "MCI"
labelsdm-ccmigrate-plugin CCMT Connector Migration CCMigrate CCMigrationTool

Page Properties
hiddentrue


Related issues