IBM Maximo: Install Maximo Application Suite using MAS CLI
Prerequisites
MAS License File
Access the IBM License Key Center.
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.
IBM Entitlement Key
Access the Container Software Library using your IBMId to obtain your entitlement key.
This values will be defined at:
export IBM_ENTITLEMENT_KEY=YOUR_KEY
mas-catalog-version
Access the [1] to get MAS catalog version
This values will be defined at:
export MAS_CATALOG_VERSION=v9-260326
Running the MAS CLI
Pull the image and run the MAS CLI container. From a terminal:
mkdir -p mas-cli-workspace podman run -it --rm -v $(pwd)/mas-cli-workspace:/mnt/home:Z --pull always quay.io/ibmmas/cli:latest
for Mac (Apple Silicon M1) add --arch arm64
Result
IBM Maximo Application Suite CLI Container v3.xx.0 ... Available commands: - mas install to launch a MAS install pipeline - mas uninstall to launch a MAS uninstall pipeline ...
Exit the container using the following command:
[ibmmas/cli:X.XX.X]mascli$ exit
Installing MAS Core via MAS INSTALL
Installing MAS Core + Manage + Health
Run the container:
mkdir -p mas-cli-workspace cp license.dat mas-cli-workspace/. podman run -it --rm -v $(pwd)/mas-cli-workspace:/mnt/home:Z --pull always quay.io/ibmmas/cli:latest
for Mac (Apple Silicon M1) add --arch arm64
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
Documentation
- https://github.com/ibm-mas/ansible-devops
- https://github.com/ibm-mas/ansible-airgap
- https://github.com/ibm-mas/cli