Installing Cloud Pak for Data on an Azure instance of Maximo Application Suite

To install Cloud Pak for Data on an existing Maximo® Application Suite instance on Azure, you clone a Git repository and run a script.

About this task

If you installed Maximo Application Suite core and Maximo Manage, your Maximo Application Suite instance does not include Cloud Pak for Data. If you want to deploy certain applications and add-ons in the Suite, such as Maximo Monitor, you must first install Cloud Pak for Data.

To install this application, you clone a Git repository, locate the installation script, and run it. When you run the script, you must provide the Azure deployment values that identify the Maximo Application Suite instance, such as boot node’s resource group, and your entitled registry key. The installation script retrieves the Suite's <unique-string> and the Red Hat® OpenShift® cluster details from the resource group’s deployment object. If the cluster credentials, that is the username and password, are changed since you installed the Suite, you must provide the updated credentials when you run the script.

You run the script on your local machine or on the boot node in the Suite's Red Hat OpenShift cluster.

Installing Cloud Pak for Data

Complete the following steps to install Cloud Pak for Data in your Maximo Application Suite instance:

Procedure

On the machine where you want to run the script, in a command shell, log in to the Azure service by running the following command.
```
az login
```
It opens a new browser window where you can log in with the Azure credentials. After login, you can close the browser window and continue the next steps from the command shell.
Clone the Git repository that contains the script by running the following command:
```
git clone https://github.com/ibm-mas/multicloud-bootstrap.git
```
Make the script executable by running the following commands:
```
cd multicloud-bootstrap/azure
chmod +x deploy-cp4d.sh
```
View the script's usage information by running the following command:
```
./deploy-cp4d.sh -h
```
Specify the required options and run the script.
- Use the r option to specify the resource group name of the boot node, for example: -r mas-ocp-deploy-rg
- Use the e option to specify the entitled registry key that you provided when you installed the Suite, for example: -e <entitlement-key>
- Use the u and p options to specify the Suite's Red Hat OpenShift cluster credentials, for example: -u <ocp-user> -p <ocp-password>
- The following sample command installs Cloud Pak for Data by using all of these example options:
- The script takes 60 minutes to
```
./deploy-cp4d.sh -r <bootnode-resource-group> -e <entitlement-key>-u <ocp-user> -p <ocp-password>
```
  installation Cloud Pak for Data into the Maximo Application Suite instance.
- Verify that the script completed successfully. If the script is successful, output that is similar to the following text is displayed:
```
:: Script Inputs ::
  Resource group = mas-ocp-deploy-rg
…
:: OpenShift Details ::
…
OpenShift Login is successful.
… 
==== MAS configuration started ====
==== MAS configuration completed ====
==== Execution completed at Mon Mar 25 14:02:56 IST 2022 ====
```
- Maximo Application Suite core with Cloud Pak for Data is deployed.
- Db2® Warehouse service of Cloud Pak for Data is enabled.
  For information about troubleshooting, see IBM® Support notes for zen-databases failure.
Login to the Cloud Pak for Data admin console.
Select the service catalog and search for Db2 Warehouse.
Click Provision instance of Db2 Warehouse service.
Configure the database.

What to do next

You can now deploy the following applications and industry solutions that depend on Cloud Pak for Data:

Maximo Application Suite
Maximo Monitor /IoT tool
Maximo Health
Maximo Predict
Maximo Collaborate
Maximo Health and Predict - Utilities