Versions Compared

Key

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

...

  1. Download the latest Windows Installer (dm-unittest-harness-X.X-X-setup.exe) from . See Accessing the MettleCI software websiteSoftware Distribution.

  2. Run dm-unittest-harness-X.X-X-setup.exe using a user with Administrator privileges

  3. Allow Unit Test Harness installer to make changes on the “User Account Control” screen

    Image Modified

  4. Click next at the welcome screen

    Image Modified

  5. Select a location to install Unit Test Harness. This location is used for storing the uninstaller

    Image Modified

  6. Select Mettle Home location. This screen will only appear if you install MettleCI Unit Test Harness before MettleCI Workbench

    Image Modified

  7. Select DataStage Home directory.

    Image Modified

  8. CongratulationCongratulations! Installation of MettleCI Unit Test Harness is now completed

    Image Modified

Automated Installation

The installation of MettleCI Unit Test Harness version 1.0-353 and later can be automated via the /S option:

Code Block
Usage: 
start "" /wait <Unit Test Harness EXE file> /S /mcihome <MettleCI Home> /uthome <path/to.unittestharness> /dshome <path/to/datastage/home>

Sample output:

Code Block
C:\>start "" /wait dm-unittest-harness-1.0-353-setup.exe /S /mcihome C:\dm\mci /uthome C:\dm\mci-unittest-harness /dshome C:\IBM\InformationServer\Server\DSEngine

MettleCI Unit Test Harness installation completed

C:\>echo %errorlevel%
0

Enable MettleCI Unit Testing for DataStage projects

...

  1. Log into your development DataStage Engine(s) and navigate to your DataStage project folder. This would typically be:

    Code Block
    # Windows
    <DRIVE-LETTER>:\YOUR\PATH\TO\INFORMATION-SERVER-ROOT-FOLDER\Server\Projects\<Your Existing Project>
    or
    # Unix
    /your/path/to/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\

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
    <DRIVE-LETTER>:PATH\TO\INFORMATION-SERVER-ROOT-FOLDER\Server\Template

Upgrade MettleCI Unit Testing Harness

...

  • Uninstall the old version

  • Install the new version

Uninstall

The MettleCI UnitTest Harness uninstaller can be found under Windows Start Menu. Click on it, and the wizard will guide you through the uninstalling process.

...