Cloud Experts Documentation

Maximo Application Suite on ARO ( Azure Red Hat OpenShift )

This content is authored by Red Hat experts, but has not yet been tested on every supported configuration.

IBM Maximo Application Suite (MAS) is a set of applications for asset monitoring, management, predictive maintenance and reliability planning. When combined with Azure Red Hat OpenShift ( ARO ), this frees up your Maximo and operations team to focus on what is important to them ( Maximo ) rather than having to worry about managing and building clusters.

This document outlines how to get quickly get started with ARO and installing Maximo all through automation.

Prerequisites

Note: You must log into your ARO cluster via your oc cli before going through the following steps.

Prepare the Environment

Note: This guide re-uses environment variables from the Deploying ARO using azurerm Terraform Provider guide. If you have an existing cluster, you’ll need to set them appropriately for the cluster.

  1. Run this these commands to set some environment variables to use throughout (Terraform commands need to be run in the directory you ran Terraform)

Maximo environment variables.

You do need both an IBM entitlement key and a Maximo license ID and file. These can be obtained from IBM.

export IBM_ENTITLEMENT_KEY=XYZ
export MAS_CONFIG_DIR=~/tmp/masconfig
export DRO_CONTACT_EMAIL=name@company.com
export DRO_CONTACT_FIRSTNAME=First
export DRO_CONTACT_LASTNAME=Last
export MAS_INSTANCE_ID=inst1
export SLS_LICENSE_ID=
export SLS_LICENSE_FILE=
mkdir -p $MAS_CONFIG_DIR

OpenShift Environment Variables

export CLUSTER=${TF_VAR_cluster_name}

INGRESS_SECRET_NAME=$(oc get secret -n openshift-ingress -o json | jq -r '.items[] | select(.metadata.name|contains("ingress")) | .metadata.name')

az aro list --query \
    "[?name=='$CLUSTER'].{ ResourceGroup:resourceGroup,Location:location}" \
    -o tsv | read -r RESOURCEGROUP LOCATION

Prepare the Storage Accounts for MAS

  1. Change the default storage class
  oc patch storageclass managed-csi -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'
  1. Create an Azure Premium Disk for Maximo

    cat << EOF | oc apply -f -
    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: managed-premium
      annotations: 
        storageclass.kubernetes.io/is-default-class: 'true'
    provisioner: kubernetes.io/azure-disk
    parameters:
      kind: Managed
      storageaccounttype: Premium_LRS
    reclaimPolicy: Delete
    allowVolumeExpansion: true
    volumeBiningMode: WaitForFirstConsumer
    EOF
    
  2. Create an Azure Premium File Storage for Maximo

    cat << EOF | oc apply -f -
    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: azurefiles-premium
    provisioner: file.csi.azure.com
    parameters:
      protocol: nfs
      networkEndpointType: privateEndpoint
      location: $LOCATION
      resourceGroup: $RESOURCEGROUP
      skuName: Premium_LRS
    reclaimPolicy: Retain
    allowVolumeExpansion: true
    volumeBiningMode: Immediate
    EOF
    

Install IBM Maximo Application Suite with Ansible

IBM has provided an ansible playbook to automate the installation of Maximo and all the required dependencies making it very easy and repeatable to get started with Maximo.

Click hereexternal link (opens in new tab) to learn more about the OneClick Install of Maximo.

  1. Install the Maximo Ansible collection
ansible-galaxy collection install ibm.mas_devops
  1. Run the Ansible playbook
ansible-playbook ibm.mas_devops.oneclick_core

And that’s it!! … it will take about 90 minutes for the installation to complete follow along the ansible log messages if you like.

You can also open the OpenShift web console and view the projects and resources the playbook is creating.

MAS Projects

When the playbook finishes, you will see the following showing the installation is complete along with the MAS Admin Dashboard with username and password to use.

MAS Installation

Open the MAS Dashboard URL in your browser and log in with the given username and password.

MAS Admin

Note: If you are using the default aroapp.io domain that comes with ARO, the URL will show it’s insecure due to an untrusted CA. For a production level Maximo installation with ARO, the cluster should be created with a custom domain where you control the certificates. Follow these directionsexternal link (opens in new tab) from IBM in manually appling the certificates for MAS.

If you see a blue spinning circle from the admin page like this: MAS Blue Circle

In the browswer, change admin to api and hit enter. For example: change https://admin.inst1.apps.mobb.eastus.aroapp.io/external link (opens in new tab) to https://api.inst1.apps.mobb.eastus.aroapp.io/external link (opens in new tab)

This will return a message like the following: MAS API

Try to load the admin screen and this time it should work.

Install Maximo Applications ( Optional )

Optionally install Maximo applications you would like to use. In this example, we will install IT and Asset Configuration Manager.

On the Admin page, click on Catalog and then under applications click on Manage. MAS Manage

Select both IT and Asset Configuration Manager and then click on Continue. MAS Componenets

Keep the defaults and click on Subscribe to channel. Note that this can take 10+ minutes. MAS Subscribe

Once you see thate Manage is ready to be activated, click on Activate MAS Activate

Finally, click on Start activation on the next screen. Note that this step can take several hours. MAS Start Activation

Interested in contributing to these docs?

Collaboration drives progress. Help improve our documentation The Red Hat Way.

Red Hat logo LinkedIn YouTube Facebook Twitter

Products

Tools

Try, buy & sell

Communicate

About Red Hat

We’re the world’s leading provider of enterprise open source solutions—including Linux, cloud, container, and Kubernetes. We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Subscribe to our newsletter, Red Hat Shares

Sign up now
© 2023 Red Hat, Inc.