The MettleCI Workbench is browser-based application which is served from a lightweight agent that resides on your DataStage development environment’s Engine Tier.
In order to be able to install Workbench, you must be in a terminal session either logged in as root or as a user that can sudo as root.
Before installing MettleCI Workbench you will need to perform a pre-installation Java update to make sure your Java environment is compatible with MettleCI.
Pre-install steps if operating workbench with a non-default user
By default, the MettleCI Workbench installer creates a new user called mciworkb (if it doesn’t already exist) and sets its primary group to dstage. All files created during the installation are owned by that user and group.
If your environment requires you to use a different user, do the following:
As
root, create an environment variable calledDM_WORKBENCH_USERand set it to the name of the user you want to use.
The Workbench installer will use the non-default user’s primary group to set the ownership of most of the folders and files in the MettleCI Home directory.
Installation / Upgrade
Before you perform an upgrade:
Record the ownership and permissions for the MettleCI Home folder (usually ‘/opt/dm/mci’)
Back up the MettleCI Home folder.
Download the latest RPM distributable from the MettleCI software download website. The rest of these instructions assume this is located in your user’s HOME directory (~).
From that directory, install the package from the shell of your DataStage Development Engine using Package Manager (RPM) (NOTE: For new installations this will create a user called
mciworkb. A full set of changes that this process performs are listed in the Installation Details section below.)$> sudo rpm -U dm-mettleci-workbench-x.x-x.noarch.rpm $> # or for IBM AIX... $> sudo rpm -U dm-mettleci-workbench-x.x-x.noarch.rpm --nodeps --ignoreos
… where x.x.x is the build version of the workbench you downloaded.
Request a MettleCI licence from your Data Migrators contact, or request an evaluation licence from the MettleCI software download website. The license will be installed during the first step of the Post Installation wizard process.
Copy the MettleCI licence file which was emailed to you into the
/opt/dm/mci/directory created for you by the RPM installation process.https://datamigrators.atlassian.net/wiki/spaces/MCIDOC/pages/459997264/Configuring+MettleCI+WorkbenchStart the MettleCI Workbench service using the following command
$> sudo service dm-mettleci-workbench start $> # or for AIX... $> mciworkbench.rc start
Verify your install/upgrade
Verify your Workbench service is running:
$> sudo service dm-mettleci-workbench status $> # or for AIX... $> mciworkbench.rc status
Opening the following URL in your browser:
http://[SERVER_URL]:8080. and check the build number at the bottom of your Workbench browser screen. This should match the number in the number in the filename of the latest RPM distributable you downloaded and installed. If not, see the troubleshooting article A Workbench update doesn't appear to have installed.
Post-installation
Configure your MettleCI environment by opening the following URL in your browser:
http://[SERVER_URL]:8080to start a wizard-based process.Follow the setup wizard to provide the various configuration information MettleCI requires.
Uninstall Workbench
You can uninstall the MettleCI Workbench package like any other RPM package:
$> sudo rpm -e dm-mettleci-workbench-x.x-x.noarch
You'll need to use a similar command to uninstall the Unit Test Harness too.
Downgrading Workbench
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:
$> 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.