Versions Compared

Version Old Version 7 New Version 8
Changes made by

Drew Nuttall-Smith

John McKeever

Saved on

Key

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

Before installing MettleCI Workbench Command Line Interface you will need to perform a pre-installation Java update to make sure you Java environment is compatible with MettleCI.

Info

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

  1. Download the latest MettleCI Command Shell distribution package from http://software.mettleci.io/. Note that Data Migrators provide a single multi-platform distribution package which supports both Unix and Windows.

    Unzip and configure your downloaded package like this:

    Code Block$> cd /opt/dm/mci/ $> sudo mkdir cli $> cd cli $> sudo unzip ~/command-shell-1.1-49-dist.zip $> sudo -R chown mciworkb:dstage * $> sudo chmod 777 mettleci $> sudo ./mettleci MettleCI Command Line (C)2019 Data Migrators Pty Ltd Enter [namespace] [command] [options] or 'help' for more information, 'exit' or 'quit' to leave. Unable to load license file $>

    CLI RPM distributable from the MettleCI software download website.

  2. Open a shell and navigate to the $HOME directory of your DataStage Development Engine. 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.

  3. Navigate to /opt/dm/mci/cli and use your favourite editor to open the config.properties file.

  4. If you don’t have one already, request a trial license for MettleCI from the link on the same site. This will be delivered to you via email as a file attachment. Save the file to the same directory into which you unzipped your MettleCI Command Shell distribution package.

  5. Modify the license.file=mettleci.lic to point to your MettleCI License file. This will typically be license.file=../mettleci.lic (the parent directory) if you are installing the MettleCI CLI alongside the MettleCI Workstation on a DataStage engine tier.

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-x.x-x.noarch

Downgrading Workbench

  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-command-shell-x.x-x.noarch.rpm

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