Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Page Properties
hiddentrue
idbamboo-plugin

Task Name

CC Migrate

Plugin Name

dm-ccmigrate-plugin-<version>.jar

YAML Reference

???

Description

Use the IBM-supplied Connector Migration Tool to automatically modify Jobs to use Connector Stages instead of the deprecated Plug-in and Operator Stages

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.

...

Configuring the CC Migrate Source Code Checkout Task

...

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

...

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

    Image RemovedImage Added
  2. Configure each task as described below

...

Using the Source Code Checkout

...

Provide the following details:

...

Input

...

Mandatory

...

Type

...

Description

...

Task description

...

N

...

Text field

Task

  1. Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).

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

  3. Complete the following settings:

N

Task description

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

Text field

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

Info

Suggested Value

Leave blank

Force Clean Build

N

Checkbox

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

Info

Suggested Value

Checked

  1. Click Save

...

Using the Execute Connector Migration

...

Provide the following details:

...

Input

...

Mandatory

...

Type

...

Description

...

Task description

...

N

...

Task

  1. Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).

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

  3. Complete the following settings:

Text fieldYText fieldYN

Task description

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

Info

Suggested Value

${bamboo.Domain}

Server

Y

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

Info

Suggested Value

${bamboo.ServerName}

Username

Text field

The username used to connect to IBM Information server 

Info

Suggested Value

${bamboo.DatastageName}

Password

Y

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

Info

Suggested Value

${bamboo.DatastagePassword}

Execute Settings

Project Name

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

  • -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

Y

Text field

Unique log file name.

Info

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

Info

Suggested Value

8

Fail plan when compile error

Checkbox

True = Build plan will fail when it encounter encounters a compilation error

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

  1. Click Save

...

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