Installing Maximo Monitor with TRIRIGA Application Suite

Complete the following steps to install and configure IBM® Maximo® Monitor with IBM TRIRIGA® Application Suite. You can then configure the IBM Maximo Monitor integration with TRIRIGA Application Suite to unify your location hierarchies and enable more advanced IoT device monitoring and analytics in your workspaces.

Before you begin

Ensure that TRIRIGA Application Suite is installed.

Ensure that you have the following information:

IBM Maximo Application Suite license and entitlement details.
Maximo Application Suite Artifactory credentials.
IBM Suite License Service details and contact username and email.
IBM Data Reporter Operator username and email address.

Note: A separate instance of Db2 is installed for IBM Maximo Monitor, which is configured for an analytics workload. The TRIRIGA Application Suite Db2 database requires a different workload setting so cannot be used. If you are using Db2 for TRIRIGA Application Suite, ensure that you specify a different Db2 database name during the installation.

About this task

Maximo Application Suite Core, Maximo Application Suite IoT, and IBM Maximo Monitor are installed in a separate namespace from TRIRIGA Application Suite.

A separate Suite License Service and Data Reporter Operator are installed for Maximo Application Suite.

IBM Maximo Monitor must use the same persistent storage as TRIRIGA Application Suite. During installation, the appropriate storage classes are automatically detected.

Procedure

Install Python 3 by entering the following commands:

For example, on Ubuntu Linux®:

sudo apt update
sudo apt install python3
sudo DEBIAN_FRONTEND=noninteractive apt install -y python3-venv

Create a local virtual environment by entering the following commands:
```
python3 -m venv localvenv
```
```
source ./localvenv/bin/activate
```

Install Red Hat® Ansible® and Ansible-playbook by entering the following commands:

python3 --version

python3 -m pip install ansible junit_xml pymongo xmljson jmespath kubernetes==12.0.1 openshift==0.12.1

ansible --version

ansible-playbook --version

Install the Red Hat OpenShift® CLI by entering the following commands:

wget -q https://mirror.openshift.com/pub/openshift-v4/x86_64/clients/ocp/4.14.7/openshift-client-linux-4.14.7.tar.gz

tar -zxf openshift-client-linux-4.14.7.tar.gz

mv oc kubectl /usr/local/bin/

rm -rf openshift-client-linux-4.14.7.tar.gz

oc version

Log in to the TRIRIGA Application Suite cluster by entering the following command:
You can get the OC login command from your Red Hat OpenShiftcluster UI.
```
oc login --token=xxxx --server=https://myocpserver
```
Get the IBM MAS DevOps Ansible Collection by entering the following command:
```
ansible-galaxy collection install ibm.mas_devops --force
```
Create a mas_configs folder in the root directory, create an entitlement.lic, and add your Maximo Application Suite license to the entitlement.lic file by entering the following commands:
```
mkdir /root/mas_configs
```
```
vi /root/mas_configs/entitlement.lic
```

Create a MAS directory to clone the Git repository of Ansible DevOps:

mkdir /root/MAS

cd /root/MAS

git clone https://github.com/ibm-mas/ansible-devops.git

cd /root/MAS/ansible-devops/

git pull

Build the ansible collection by entering the following commands:

cd /root/MAS/ansible-devops/ibm/mas_devops/

ansible-galaxy collection build --force

ansible-galaxy collection install ibm-mas_devops-100.0.0.tar.gz --ignore-certs --force

rm ibm-mas_devops-100.0.0.tar.gz

Export the following variables and use the Ansible playbook to install Maximo Application Suite core.

export ARTIFACTORY_USERNAME=""

Enter the Maximo Application Suite artifactory username.

export ARTIFACTORY_TOKEN=""

Enter the Maximo Application Suite artifactory token.

export MAS_CHANNEL="9.0.x-dev"

export MAS_CATALOG_VERSION="v9-master-amd64"

export MAS_INSTANCE_ID="tas"

export MAS_WORKSPACE_ID="tas"

export MAS_ICR_CP="docker-na-public.artifactory.swg-devops.com/wiotp-docker-local"

export MAS_ICR_CPOPEN="docker-na-public.artifactory.swg-devops.com/wiotp-docker-local/cpopen"

export MAS_ENTITLEMENT_USERNAME=""

export MAS_ENTITLEMENT_KEY=""

export IBM_ENTITLEMENT_KEY=${MAS_ENTITLEMENT_KEY}

export SLS_LICENSE_ID="xxxxxxxxxxxx"

export SLS_INSTANCE_NAME="mas-sls"

Ensure that the SLS_INSTANCE_NAME value is unique.

export SLS_NAMESPACE="mas-sls"

Ensure that the SLS_NAMESPACE value is unique.

export MAS_CONFIG_DIR="/root/mas_configs"

export SLS_LICENSE_FILE="/root/mas_configs/entitlement.lic"

export UDS_CONTACT_EMAIL="xxx@xxx.com"

export UDS_CONTACT_FIRSTNAME="xxx"

export UDS_CONTACT_LASTNAME="xxx"

export DRO_CONTACT_EMAIL="xxx@xxx.com"

export DRO_CONTACT_FIRSTNAME="xxx"

export DRO_CONTACT_LASTNAME="xxx"

ansible-playbook playbooks/oneclick_core.yml

Export the following variables and use the ansible playbook to install IBM Maximo Monitor IoT.
The installation takes approximately 1.5 hours.

Important: Ensure that DB2_INSTANCE_NAME is not the same as the existing TRIRIGA Application Suite Db2® instance.
```
export DB2_INSTANCE_NAME="db2u-mas" 
```
```
export MAS_APP_CHANNEL="9.0.x-stable"
```
```
ansible-playbook ibm.mas_devops.oneclick_add_iot
```
Export the following variables and use the ansible playbook to install IBM Maximo Monitor.
The installation takes approximately 45 minutes.
```
export MAS_APP_CHANNEL="9.0.x-stable"
```
```
ansible-playbook ibm.mas_devops.oneclick_add_monitor 
```
Configure the IBM Maximo Monitor integration with TRIRIGA Application Suite, see Integrating with IBM TRIRIGA Application Suite.