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:17.3.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 17.3.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/17.3.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 | ✓ | ✓ |
| update | ✓ | ✓ |
| upgrade | ✓ | ✓ |
| uninstall | ✓ | ✓ |
| must-gather | ✓ | ✕ |
| configure-airgap | ✓ | ✕ |
| mirror-images | ✓ | ✕ |
| mirror-redhat-images | ✓ | ✕ |
| setup-registry | ✓ | ✕ |
| teardown-registry | ✓ | ✕ |
| provision-fyre | ✓ | ✕ |
| provision-roks | ✓ | ✕ |
| provision-rosa | ✓ | ✕ |
| configtool-oidc | ✓ | ✕ |
| facilities-external-db | ✓ | ✕ |