Maximo Application Suite on OpenShift Dedicated Google Cloud Platform ( OSD GCP )

IBM Maximo Application Suite (MAS) is a set of applications for asset monitoring, management, predictive maintenance and reliability planning. When combined with Red Hat OpenShift Dedicated on Google Cloud ( OSD GCP ), 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 OSD GCP and installing Maximo all through automation.

Prerequisites

• a OSD GCP Cluster (see Deploying OSD GCP )

Note: Please check the latest Maximo support matrix, at the time of this writing, OpenShift 4.14 is latest OpenShift version supported by Maximo.

• oc cli
• gcloud cli
• ansible cli
• ocm cli
• a Maximo License Key
  

Note: You must log into your OSD GCP cluster via your oc cli and into the RedHat OpenShift Cloud Manager ( ocm ) CLI before going through the following steps.

Prepare the Environment

Maximo environment variables.

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

GCP / OpenShift Environment Variables

Use the following defaults or adjust accordingly

Prepare the Storage Accounts for MAS

The first step is to add Filestore Storage to the cluster to provide ReadWriteMany access for Maximo.

1. Install the GCP Filestore CSI Driver Operator

2. Create the GCP Filestore storage class

3. Create a Filestore instance fo the Cluster CSI Driver

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 here to learn more about the OneClick Install of Maximo.

1. Install the Maximo Ansible collection

1. Run the Ansible playbook

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.

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.

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

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 directions from IBM in manually appling the certificates for MAS.

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

In the browswer, change admin to api and hit enter. For example: change https://admin.inst1.apps.mobb.eastus.openshiftapps.com/ to https://api.inst1.apps.mobb.eastus.openshiftapps.com/

This will return a message like the following:

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.

Select both IT and Asset Configuration Manager and then clikc on Continue.

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

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

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