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.