Question

How do I upgrade or patch my DataStage installation if I have the MettleCI Unit Test Harness installed on my engine?

Answer

Because the MettleCI unit test harness is implemented as a ‘wrapper' around the osh executable, and changes the file layout in the PXEngine/bin directory, there are considerations to be taken into account when upgrading the instance of DataStage that the harness interacts with.

The recommended practice is to uninstall harness before applying any Information Server/DataStage patch, fix pack or upgrade to the engine tier. This reverses the installation and restores the file layout to the non-symlinked version. It does the same set of checks as install to ensure it doesn't do anything destructive.

The uninstall process varies depending on whether the engine is Windows or Unix. See the following links:

• Installing or Upgrading the Parallel Job Unit Test Harness on Windows

• Installing or Upgrading the Parallel Job Unit Test Harness on Unix

On Windows you will need to delete the installed service, and on Unix you will use rpm to remove the installed the package (rpm -e). It is prudent to first make a backup of your MettleCI installation directory somewhere convenient, so you can restore the MettleCI license and configuration files as necessary.

After the DataStage patch has been applied, reinstall the latest version of Unit Test Harness following the instructions appropriate to your environment.

See also

• How the Parallel Unit Test Harness Integrates with DataStage?

• Updating DataStage Stops the MettleCI Unit Test Harness Working for Parallel Jobs