IBM Maximo Application Suite installation with Ansible collection

To automate some of the manual steps that are involved with installing Maximo® Application Suite and its components, use the Ansible collection roles that match your installation path or use case.

The IBM® Maximo Application Suite development team maintains a public Ansible collection that automates the installation and configuration of Maximo Application Suite and its dependencies. The Maximo Application Suite DevOps Ansible collection includes a number of automated tasks, referred to as roles and playbooks. These automated tasks can be used to streamline processes from having a simple Red Hat® OpenShift® cluster, to having Maximo Application Suite including multiple applications and its required dependencies.

It also provides a docker container, which contains all the prerequisites to run the Ansible automation on any local machine.

For example, from Maximo Application Suite 8.9, you can use the role variable mas_annotations to install the Maximo Application Suite in production or nonproduction mode. The mas_annotations is an optional variable, which accepts a comma-separated list of annotations that need to be added to the Maximo Application Suite CR. To deploy your Maximo Application Suite in nonproduction mode, set this variable to mas.ibm.com/operationalMode=nonproduction. For more information, see Maximo Application Suite Ansible collection examples.

Note: The Maximo Application Suite Ansible collection is developed by the IBM Maximo Application Suite development team. If you need help or have issues, contact IBM Support or raise an issue directly in the GitHub repository.

For more information about how to help with the development of new roles and collections or improvements to the existing ones, see Contributing.

  • Ansible® role documentation contains terms and variables, prefixed by W3 or ARTIFACTORY that are intended for internal IBM use only. Ignore these variables if they do not apply to your role, use-case, environment, or scenario.

Mapping documentation tasks to Ansible roles

Each documentation task that contains an Ansible role begins with a Tip icon Tip that links to the Ansible role that applies to the task.

For reference, the following documentation tasks map to Ansible roles:

Documentation task Ansible role
Setting up Red Hat OpenShift Container Storage ocs
IBM operator catalog ibm_catalogs
Installing IBM Cloud Pak® foundational services for IBM Cloud Pak for Data common_services
IBM Certificate Manager cert_manager
Note: Starting in IBM Maximo Application Suite 9.0, 8.11.7, and 8.10.10, the User Data Services (UDS) is deprecated and replaced with IBM Data Reporter Operator (DRO).

For more information, see Data Reporter Operator.

uds
IBM Data Reporter Operator dro
Installing IBM Cloud Pak for Data cp4d
Db2 Warehouse db2
Watson Studio cp4d_service

Specify wsl service name.

Watson Machine Learning cp4d_service

Specify wml service name.

Installing MongoDB mongodb
Installing Object Storage cos

Specify cos_type as ibm for IBM Cloud® Object Storage, or ocs Red Hat OpenShift Container Storage.

Installing Suite License Service sls
Recommended: Installing Suite Applications from Operator Hub suite_app_install
Activating applications suite_app_config
Installing Red Hat OpenShift Container Platform on IBM Cloud ocp_provision
Installing Cloud Internet Services suite_dns
Installing Apache Kafka for IBM Maximo Manage
Installing Apache Kafka for IoT tool
kafka
Installing the NVIDIA operator nvidia_gpu
Configuring Red Hat OpenShift cluster monitoring

Installing Grafana

cluster_monitoring
Converting IBM Maximo Application Suite from manual deployment to channel subscription

This Operator Lifecycle Manager (OLM) conversion script and role is available from Maximo Application Suite 8.10.

convert_to_olm