IBM Maximo Application Suite CLI Utility¶
The CLI comes in two flavours; container image and standalone binary.
The standalone CLI is available for three platforms, and available from the downloads page on each GitHub release.
Container Image¶
The best way to use the MAS CLI is to use the container image we publish to quay.io:
docker run -ti --rm -v ~:/mnt/home --pull always quay.io/ibmmas/cli mas install --help
Tip
If you want to stick with a specific release of the image you can attach a version tag to the docker run command: docker run -ti --rm -v ~:/mnt/home quay.io/ibmmas/cli:18.10.0
The container image provides an out of the box environment for managing MAS on OpenShift, with numerous dependencies pre-installed (see cli-base for details). The Maximo Application Suite Ansible Collection is included in these dependencies, so even if you prefer to drive Ansible directly the CLI image can be a useful tool:
docker run -ti --rm -v ~:/mnt/home --pull always quay.io/ibmmas/cli ansible-playbook ibm.mas_devops.mas_install_core
Standalone Binary¶
Introduced in Summer 2024, the standalone binary is a new way to use the MAS CLI, you can download version 18.10.0 of the CLI for following platforms using the links below:
For example, to install the CLI and launch a MAS install on Linux:
wget https://github.com/ibm-mas/cli/releases/18.10.0/mas-cli-linux-amd64
cp mas-cli-linux-amd64 /usr/local/bin/mas-cli
mas-cli install --help
Function support¶
Not all functions supported in the container image are available in the standalone CLI binary:
| CLI Function | Image | Binary |
|---|---|---|
| install | ✓ | ✓ |
| aiservice-install | ✓ | ✓ |
| update | ✓ | ✓ |
| upgrade | ✓ | ✓ |
| uninstall | ✓ | ✓ |
| must-gather | ✓ | ✕ |
| configure-airgap | ✓ | ✕ |
| mirror-images | ✓ | ✕ |
| mirror-redhat-images | ✓ | ✕ |
| setup-registry | ✓ | ✕ |
| teardown-registry | ✓ | ✕ |
| provision-fyre | ✓ | ✕ |
| provision-roks | ✓ | ✕ |
| provision-rosa | ✓ | ✕ |
| configtool-oidc | ✓ | ✕ |