Document toolboxDocument toolbox

How do we safely update DataStage where the MettleCI Unit Test Harness has been Installed?

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:

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

 

© 2015-2024 Data Migrators Pty Ltd.