Configuring MettleCI Workbench to use Custom App and Data Directories

In the event that there are constraints which prevent using the usual Mettle Home directory /opt/dm/mci for storage, it is possible to move the ‘MettleHome’ directory to a different location residing in a data area. For example, this would be useful in a grid environment where /opt/dm/mci is not on shared storage but the data area is on shared storage.

Steps for moving ‘MettleHome' to /data/mci are as follows:

1. Shutdown the workbench service

2. Edit /opt/dm/mci/config.yml and change mettleHome to /data/mci

3. Leave the following files in /opt/dm/mci :-

   • config.yml

   • dm-mettleci-workbench

   • mci.log

   • mettle-ui-x.x-xxx.jar

   • METTLE_UI.pid

   • start-mettleci.sh

   • Any .p12 files (except mettleci-trust.p12)

   • Any .key files

   • .secrets/git-credentials-keystore-password

4. Move all other files plus mettleci-trust.p12to the new mettleHome directory

5. Ensure that ownership of files on /data/mci match those of /opt/dm/mci. By default this is mciworkb:dstage

6. Start the workbench service

7. Edit /opt/IBM/InformationServer/Server/PXEngine/bin/osh-dm and change export DM_METTLE_HOME to /data/mci

Workbench and unit testing will now work fine. You don’t need to bounce DataStage for changes to take effect.

Installing an update to the Unit Test harness will overwrite osh-dm, so…

• When upgrading the Parallel Unit Test Harness you must re-apply Step 7

• When upgrading the Workbench you will not need to re-apply Step 7