Versions Compared

Old Version 41

changes.mady.by.user Alan Prothero

Saved on

compared with

New Version 42

changes.mady.by.user John McKeever

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. If something goes wrong and you need to downgrade your version of MettleCI Workbench, without performing an uninstall/reinstall, you can use the following command:

    Code Block
    $> rpm -Uvh --oldpackage dm-mettleci-workbench-x.x-x.noarch.rpm

    … where x.x.x is the build version of the workbench you want to downgrade to.

Separating Workbench Application 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. Move files in /opt/dm/mci/ to /data/mci but leave the following files in place:-

    • config.yml

    • dm-mettleci-workbench

    • mci.log

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

    • METTLE_UI.pid

    • start-mettleci.sh

  4. Ensure that permissions on /data/mci match those of /opt/dm/mci. By default this is mciworkb:dstage

  5. Start the workbench service

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

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

Note

Installing an update to the Unit Test harness will overwrite osh-dm, so you will need reapply Step 6 after each Unit Test Harness Upgrade.

Workbench upgrades will not require the reapplication of Step 6.

 Sysadmin Notes: Installation Details

Info

This section is purely informational, and requires no action

When executed, the MettleCI RPM package installer performs the following actions:

  • Creates a MettleCI service user account if it doesn’t already exist. By default, this user is called mciworkb and is a member of the group DataStage is configured to use (commonly dsadmin). An alternative MettleCI user and group can be specified.

  • Creates the MettleCI home directory (default /opt/dm/mci), owned by the MettleCI service user, with the following contents:

    Code Block
    $> ls -al /opt/dm/mci/
total 52292
-r-xr----- 1 root         dstage     1766 Oct  7 11:11 dm-mettleci-workbench
-rwxrwxr-x 1 mciworkb     dstage 53531885 Oct  7 11:11 mettle-ui-1.0-449.jar
drwxrwxr-x 2 mciworkb     dstage        6 Oct  7 11:11 reports
drwxrwxr-x 2 mciworkb     dstage        6 Oct  7 11:11 specs
-rwx------ 1 mciworkb     dstage     1675 Oct  7 11:11 workbench_rsa
-rwxr-xr-x 1 mciworkb     dstage      414 Oct  7 11:11 workbench_rsa.pub

  • Copies the workbench jar file (mettle-ui-x.x-x.jar) to the MettleCI home

  • Creates an SSH key pair for Git integration as workbench_rsa.pub (public key) and workbench_rsa (private) in the MettleCI home

  • Changes permissions on the private Git SSH key to 700

  • Creates a SysVinit service for the workbench

Running the MettleCI Workbench setup wizard has the following effect:

...

Creates a config.yml file in the MettleCI Home directory

...

...

Related pages