Follow these steps to get up and running with MettleCI as quickly and easily as possible with one of your existing DataStage Projects.

1. Gather your required information

Note that before you proceed with MettleCI installation and configuration you should have the following information to hand:

...

Status
colour Green title Milestone

: You’ve verified that you can connect to DataStage, Git, and Work Item Management using your credentials/SSH keys.

2. Install MettleCI Workbench

Start by installing MettleCI Workbench on your DataStage development Engine tier host.

...

Status
colour Green title Milestone

: You can log in to the MettleCI Workbench using your DataStage credentials.

3. On-board your first DataStage project

a3a. Establish version control baseline

Extract a whole-of-Project archive (.isx) containing only the design information, not ‘executables’ (AKA ‘binaries’) or ‘dependent items’. Need a link to the IBM documentation for Information Server Manager and / or command line utilities to do this. ( Lar: This is the one I refer to whenever I need to use istool … ( We’ve had bad results sometimes from using ISM, so I tell users to use istool ) https://www.ibm.com/support/knowledgecenter/en/SSZJPZ_11.7.0/com.ibm.swg.im.iis.iisinfsv.assetint.doc/topics/istoolexp.html … it’s pretty dense). Do not include any executables (i.e. binaries) nor any dependent items. See IBM’s instructions on using the istool to perform ISX exports here.

Process the archive and check it into the corresponding Git repository by following the instructions for Bulk Check-in Using MettleCI Command Shell and Git.

b3b. Register the Project in MettleCI Workbench

...

Status
colour Green title Milestone

: MettleCI Workbench can operate on the DataStage project, and it is listed in the drop-down project list at the top of the Workbench.

4. Try MettleCI Compliance

a4a. Create your compliance rule Git repository

...

Status
colour Green title Milestone

: You have an operational Git repository containing a set of template MettleCI Compliance Rules.

b4b. Execute Compliance against a DataStage Job

...

Status
colour Green title Milestone

: Compliance results for one of your DataStage jobs.

5. Try MettleCI Unit Testing

a5a. Install the Parallel Unit Test Harness (if you use Parallel jobs)

Follow the steps to install the Parallel Unit Test harness.

b5b. Create your first Unit Test

...