Breadcrumbs

Installing the Windows Parallel Unit Test Harness

Installation

  1. Download the latest Windows Installer (dm-unittest-harness-X.X-X-setup.exe). See Accessing the MettleCI Software 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

    Step 1 - UAC.png


  4. Click next at the welcome screen

    Step 2 - Welcome.png


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

    Step 3 - Uninstaller Path.png


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

    Step 4 - MCI Home.png


  7. Select DataStage Home directory.

    Step 5 - DS Home.png


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

    Step 6 - Uninstall Complete.png


Automated Installation

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

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

Sample output:

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

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:

    # 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:

    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:

    <DRIVE-LETTER>:PATH\TO\INFORMATION-SERVER-ROOT-FOLDER\Server\Template

Upgrade MettleCI Unit Testing Harness

To upgrade MettleCI Unit Testing Harness, is as simple as

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

Uninstaller.png