Versions Compared

Old Version 8

changes.mady.by.user John McKeever

Saved on

compared with

New Version Current

changes.mady.by.user John McKeever

Saved on

Key

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

Task Name

CC MigrateConnector Migration

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.

...

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

Configuring the Connector Migration Source Code Checkout Task

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

Name

Location

Copy pattern

Operations

InfoServer Assets

datastage

**/*

Share

...

  1. Create two Bamboo Tasks in the following order:

    1. Source Code Checkout

    2. Execute Connector Migration Tool

  2. Configure each task as described below

Info

...

Note that 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.

...

Configure each task as described below

Source Code Checkout Settings

Provide the following details:

...

Input

...

Mandatory

...

Type

...

Description

...

Task description

...

N

...

Using the Source Code Checkout Task user interface

  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:

Input

Mandatory

Type

Description

Task description

N

Text fieldCheckboxSelectionText fieldCheckbox

Task description

Description of the Bamboo task

Disable this task

N

If checked, this task will be disabled

Repository

Y

The name of the repository

Checkout Directory

N

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

Info

Suggested Value

Leave blank

. It is recommended that you leave this option empty.

Force Clean Build

N

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

Info

Suggested Value

Checked

Image Removed

Execute Connector Migration Settings

Provide the following details:

. It is recommended that you check this option.

  1. Click Save

Using the Execute Connector Migration Task user interface

  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:

NSelectionInfoServer AuthenticationText field

Suggested Value

. It is recommended you use the value ${bamboo.Domain}.

Suggested Value

. It is recommended you use the value ${bamboo.ServerName}.

Text field

Suggested Value

server. It is recommended you use the value ${bamboo.DatastageName}.

Text field

Suggested Value

. It is recommended you use the value ${bamboo.DatastagePassword}.

Text fieldPreview mode = list

  • ‘preview’ mode (i.e. List the jobs that

needs

  • require Connector Migration, but

will

  • do not modify the jobs)

Y

Suggested Value

It is recommended you use the value ${bamboo.buildKey}.log.

TextfieldY

Suggested Value

8

. If you don’t have a reason to choose otherwise it is recommended you use the value 8.

N

Task description

Description of the Bamboo task

Disable this task

Checkbox

If checked, this task will be disabled

Executable

Y

The name of the DataStage client capability to be used by this task

At least one DataStage client capability needs to be defined

Domain

Y

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

Info

Server

Y

Text field

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

Info

Username

Y

The username used to connect to IBM Information server 

Info

Password

Y

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

Info

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

Optional parameters

  • -R to run the process in preview mode

Info

Unique CCMigrate Log Filename

Text field

Unique log file name.

Info

Root ISX Directory

Y

It must match the InfoServer Assets location specified in Artifacts tab

Max Threads

Textfield

Number of threads uses for used to identify before and after status

Info

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

...

  • errors

  1. Click Save

Note

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.

...

Using the Source Code Checkout Task in a YAML pipeline

Code Block
languageyaml
<TBC>

Using the Execute Connector Migration Task in a YAML pipeline

Code Block
languageyaml
<TBC>