Installation
Download the latest RPM distributable from the MettleCI software downloads website. The rest of these instructions assume this is located in your user’s HOME directory (~).
From that directory, install the package from the shell of your DataStage Development Engine using Red Hat Package Manager (RPM)
Code Block sudo rpm -U dm-unittest-harness-x.x-x.noarch.rpm # or for AIX... sudo rpm -U dm-unittest-harness-x.x-x.noarch.rpm --ignoreos
Verify that your rpm package installation has been successful. Note that this command uses the package name ('dm-unittest-harness') and not the RPM filename ('dm-unittest-harness-x.x-x.noarch.rpm').
Code Block sudo rpm -V dm-unittest-harness .....UG.. /opt/IBM/InformationServer/Server/DSComponents/bin/dm-unittest-harness-1.0-219.jar .....UG.. /opt/IBM/InformationServer/Server/PXEngine/bin/osh-dm
Copy your MettleCI licence file into the location:
/opt/dm/mci/mettleci.lic
unless the licence has already been installed by the Workbench.
Post-installation
To enable MettleCI Unit Testing for an existing DataStage project:
Log into your development DataStage Engine(s) and navigate to your DataStage project folder. This would typically be:
Code Block /opt/IBM/InformationServer/Server/Projects/<Your Existing Project>
Add the following Environment variable definition to the
DSParams
file under the[EnvVarDefns]
section:Code Block DM_ENABLE_UNIT_TESTING\MettleCI\-1\List/Disabled//Test//Intercept/\Disabled\3\Project\Unit Testing Configuration\
This will make the following Environment Variable available to add to the DataStage jobs for which you wished to enable unit testing:
...
To enable MettleCI Unit Testing for all newly-created DataStage projects:
Add the same entry described above to the DSParams for your ‘Template’ project, located in directory:
Code Block /opt/IBM/InformationServer/Server/Template
Uninstalling the Unit Test Harness
You can uninstall the MettleCI Unit Test Harness package like any other RPM package:
Code Block sudo rpm -e dm-unittest-harness
...