Prerequisites

IBM Entitlement Key

Access the Container Software Library using your IBMId to obtain your entitlement key.

MAS License File

From the Get Keys menu, select IBM AppPoint Suites, then select IBM MAXIMO APPLICATION SUITE AppPOINT LIC and complete the form with the following information:

Field	Content
Number of Keys	Number of AppPoints that will be used in this installation.
Host ID Type	A unique value (for example, Ethernet Address). This value will be used in SLS_LICENSE_ID=46d9....
Host ID	Enter any 12-digit hexadecimal string.
Hostname	Set to the hostname of your OCP instance. Any value is acceptable.
Port	Set to 27000

Leave all other values as default. Click Generate and download the license file (license.dat). Save the file for later use.

Running the MAS CLI

Pull the image and run the MAS CLI container.

Linux

mkdir -p mas-cli-workspace
podman run -ti -v mas-cli-workspace:/mnt/home --pull always quay.io/ibmmas/cli:latest

Mac (Apple Silicon M1)

mkdir -p mas-cli-workspace
podman run -ti -v mas-cli-workspace:/mnt/home --arch arm64 --pull always quay.io/ibmmas/cli:latest

Result

IBM Maximo Application Suite CLI Container v3.12.0
...
Available commands:
- mas install to launch a MAS install pipeline
- mas uninstall to launch a MAS uninstall pipeline
- mas provision-fyre to provision an OCP cluster on IBM DevIT Fyre (internal)
...

Exit the container using the following command:

[ibmmas/cli:3.12.0]mascli$ exit

Installing MAS Core via MAS INSTALL

Installing MAS Core + Manage + Health

Run the container:

podman run -ti --pull always quay.io/ibmmas/cli

In another terminal, copy the license file to the container:

podman cp license.dat <CONTAINER_ID>:/tmp/license.dat

Return to the terminal where the container shell is running and prepare the environment:

mkdir -p /masconfig

Login to OpenShift:

oc login --token=sha256~XXXX --server=https://api.ocp-XXXX:6443

Export the entitlement key:

export IBM_ENTITLEMENT_KEY=YOUR_KEY

Run the MAS installation:

mas install --mas-catalog-version v9-250501-amd64 --ibm-entitlement-key $IBM_ENTITLEMENT_KEY \
 --mas-channel 9.0.x --mas-instance-id inst1 --mas-workspace-id maswks --mas-workspace-name "Mas Workspace" \
 --non-prod \
 --storage-class-rwo "ocs-storagecluster-ceph-rbd" --storage-class-rwx "ocs-storagecluster-cephfs" \
 --storage-pipeline "ocs-storagecluster-cephfs" --storage-accessmode "ReadWriteMany" \
 --license-file "/tmp/license.dat" \
 --mongodb-namespace "mongoce" \
 --manage-channel "9.0.x" \
 --is-full-manage "true" \
 --manage-jdbc "workspace-application" \
 --manage-components "base=latest,health=latest" \
 --manage-server-bundle-size "dev" \
 --manage-demodata \
 --manage-base-language "EN" \
 --manage-secondary-languages "PT-BR,ES" \
 --manage-server-timezone "GMT" \
 --db2-manage \
 --db2-channel "v110509.0" \
 --db2-namespace "db2u" \
 --db2-type "db2wh" \
 --db2-timezone "GMT" \
 --db2-cpu-requests "4000m" \
 --db2-cpu-limits "6000m" \
 --db2-memory-requests "8Gi" \
 --db2-memory-limits "12Gi" \
 --db2-backup-storage "100Gi" \
 --db2-data-storage "100Gi" \
 --db2-logs-storage "100Gi" \
 --db2-meta-storage "20Gi" \
 --db2-temp-storage "100Gi" \
 --accept-license --no-confirm

Other Installation Options

If you require different installation options, see the article IBM Maximo: MAS CLI Options.

Accessing MAS Core

1) Log in to the OpenShift Cluster Web Console 2) Navigate to Networking > Routes 3) Select the mas-inst1-core project 4) Click the inst1-admin route to open it in a new browser tab

Retrieving Credentials

1) Log in to the OpenShift Cluster Web Console 2) Navigate to Workloads > Secrets 3) Select the mas-inst1-core project 4) Filter by superuser 5) Open the secret inst1-credentials-superuser 6) Click Reveal to view the credentials

IBM Maximo: Install Maximo Application Suite using MAS CLI