Versions Compared

Key

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

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

Info

These instructions assume you have already obtained a MettleCI license file. If necessary, you can reuse the license file used by MettleCI Workbench. The installation of Workbench is not a prerequisite to installing the MettleCI Command Line Interface.

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.

Info

MettleCI Workbench requires the account running the Workbench Service to have read and write permissions to the MettleCI License file.

...

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.