Versions Compared

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.


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

  2. Create 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.

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




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


Remote Agent Workaround

Atlassian Bamboo Remote Agents running on Windows (before Bamboo v6.10) 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