Installation

1. Download the latest MettleCI Command Shell distribution package (see Accessing the MettleCI Software Distribution). Note that Data Migrators provide a single multi-platform distribution package which supports both Unix and Windows.

2. 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 default mciworkb.

3. Open a shell and navigate to the location of your install images. Install the mettleCI CLI using Red Hat Package Manager (RPM)

   Code Block
   $> 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.

4. 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.

...

Modify the MettleCI CLI configuration

By default, the MettleCI CLI checks the PATH environment variable to find the DataStage Client executablesThe MettleCI CLI locates all required DataStage executables relative to a known DataStage Client or Engine directory.

Edit the config.properties file to comment and uncomment lines appropriately so the file specifies configuration settings for UNIX:-

# MettleCI Command Line Interface Configure File
# (C)2018-2022 Data Migrators Pty Ltd
# This line is mandatory and tells the CLI where to find your MettleCI License
# file. If you are installing the CLI on the same tier as MettleCI Workbench
# then you should configure this line to point to the same license file used by
# Workbench (and referenced in its config.yml file).  This might be...
# Unix
license.file=../mettleci.lic
# Windows
# license.file=mettleci.lic

# If the DataStage client executables directory is not on your system path you
# should uncomment one of the following lines and ensure it correctly points to
# a directory containing the DataStage dsadmin executable.  Note that double
# backslashes are required for Windows systems.
# Unix
ds.client.path=/opt/IBM/InformationServer/Server/DSEngine/bin
# Windows
# ds.client.path=C:\\IBM\\InformationServer\\Clients\\Classic

Verify your install/upgrade

1. Verify your MettleCi is running:

   Code Block
   $> mettleci MettleCI Command Line. Build xxx (C)2018-2020 Data Migrators Pty Ltd mettleci>

Uninstall the Command Line Interface

1. You can uninstall the MettleCI Workbench package like any other RPM package:

   Code Block
   $> sudo rpm -e dm-mettleci-command-shell

Downgrading Command Line Interface

1. 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:

   Code Block
   $> 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.