| 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 sourced obtained a MettleCI license file during the Workbench installation process. Note that the installation of MettleCI . 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
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.
As per the MettleCI Workbench installation, the
DM_WORKBENCH_USERenvironment 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)
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.
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. |
Linking to your MettleCI License file
...
| Info |
|---|
The user that runs the MettleCI Workbench service (defined by the |
Modify the MettleCI CLI configuration
The 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:-
| Code Block | ||
|---|---|---|
| ||
# 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 # Windows # ds.client.path=C:\\IBM\\InformationServer\\Clients\\Classic |
| Info |
|---|
The MettleCI CLI will continue to work if |
Verify your install/upgrade
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
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
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.