Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Installation

  1. 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 (~).

  2. 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
  3. 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
  4. 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:

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

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

  1. You can uninstall the MettleCI Unit Test Harness package like any other RPM package:

    Code Block
    sudo rpm -e dm-unittest-harness

...