Before installing MettleCI Command Line Interface you will need to perform a pre-installation Java update to make sure your Java environment is compatible with MettleCI.
These instructions assume you have already sourced a MettleCI license file during the Workbench installation process. Note that the installation of MettleCI Workbench is not a prerequisite to installing the MettleCI Command Line Interface.
Installation
Download the latest MettleCI CLI RPM distributable from the MettleCI software download website.
As per the MettleCI Workbench installation, the
DM_WORKBENCH_USER
environment variable can be used to set file ownership to a user other than the defaultmciworkb
.Open a shell and navigate to the location of your install images. Install the mettleCI CLI using Red Hat Package Manager (RPM)
$> sudo rpm -U dm-mettleci-command-shell-x.x-x.noarch.rpm $> # or for IBM AIX... $> sudo rpm -U dm-mettleci-command-shell-x.x-x.noarch.rpm --nodeps --ignoreos
… where x.x.x is the build version of the workbench you downloaded.
If you are installing the MettleCI CLI alongside the MettleCI Workstation on a DataStage engine tier, you will already have a MettleCI license file which the Command Shell will use without need for configuration.
Linking to your MettleCI License file
By default, the config.properties
configuration file refers to the license file location by license.file=../mettleci.lic
(the parent directory). Save the license file and update the license.file
setting to refer to its location.
If you don’t already have a MettleCI license file, request one from your Data Migrators or IBM representative, as appropriate.
The user that runs the MettleCI Workbench service (defined by the DM_WORKBENCH_USER
environment variable - typically set to mciworkb
) must have Read/Write (minimum 600) permissions to the MettleCI Workbench license file (mettleci.lic
)
Verify your install/upgrade
Verify your MettleCi is running:
$> mettleci MettleCI Command Line. Build xxx (C)2018-2020 Data Migrators Pty Ltd mettleci>
Uninstall the Command Line Interface
You can uninstall the MettleCI Workbench package like any other RPM package:
$> sudo rpm -e dm-mettleci-command-shell
Downgrading Command Line Interface
If something goes wrong and you need to downgrade your version of MettleCI Command Line Interface, without performing an uninstall/reinstall, you can use the following command:
$> rpm -Uvh --oldpackage dm-mettleci-command-shell-x.x-x.noarch.rpm
… where x.x.x is the build version of the CLI you want to downgrade to.