Configuration settings

Use the Suite administration Configurations page to access and manage the IBM® Maximo® Application Suite configuration settings for your environment.

Tip: When you deploy a Maximo Application Suite application, you are prompted for the required settings for the application and for any supporting tools. You can preconfigure these settings to require no further input during deployment. For more information, see Deploying and activating applications.

The following sections describe the Maximo Application Suite configurations and the required parameters.

Configuration scope

Maximo Application Suite configurations are set at a defined scope, such as system or application.

Storing configuration values as secrets

Maximo Application Suite uses OpenShift for managing digital authentication credentials (secrets).

Input parameters that are stored as secrets are identified by a capital S.

After you submit a parameter as a secret, the secret value cannot generally be viewed by using the Maximo Application Suite user interface. Only secret parameters that are labeled with an eye icon can be viewed.

OpenShift administrators can view Maximo Application Suite secret values at: OpenShift dashboard > Projects > {mas-instance-name}-core > Workloads > Secrets.

Custom certificates

If the service that you are connecting to uses TLS (Secure Sockets Layer), you must add the certificate of the CA that issued the service's certificate. You can add more than one certificate if it is using Intermediate CAs.

Configuration parameters

The following parameters are configurable:

Storage

The storage configurations control Maximo Application Suite storage options at the system and application scope.

Db2 Warehouse

Db2 is used for Maximo Application Suite application data and data analytics storage.

Configuration parameters

The following parameters are configurable:

Tip: If your Db2 Warehouse is running under Cloud Pak for Data you can obtain the database name, SSL port number and certificate from the Cloud Pak for Data administration console.

Maximo Monitor and IoT Tool requirements

The System-scoped Db2 Warehouse configuration for the Maximo Monitor application and the IoT Tool must fulfill the following requirements:

Required by

Note: The Db2 database connection can also be shared with other Maximo Application Suite applications that require database connectivity. For example, when you deploy Maximo® Health and Maximo® Predict, you can select to share the main Maximo Application Suite JDBC Db2 connection, or you can set up a unique database connection for these applications.

CouchDB

CouchDB is a required component for Maximo® Assist. Beginning with Maximo Assist 8.2, CouchDB is embedded and automatically deployed with Maximo Assist. You do not have to manually install it. For more information, see Install CouchDB.

Configuration parameters

The following parameters are configurable:

Required by

MongoDB

MongoDB is a core component of Maximo Application Suite and is used by Maximo Application Suite and its applications to store configuration data. The MongoDB data storage is configured during the initial setup.

Important: Changing the MongoDB configuration after setup requires careful coordination and data migration to avoid service disruptions. If you need to change the MongoDB configuration after the initial setup, contact support.

Configuration parameters

The following parameters are configurable:

Upload a CA certificate.

Required by

Object Storage

Object Storage is a required component for Maximo® Assist. For more information, see Install Ceph Object Storage.

Configuration parameters

The following parameters are configurable:

Upload a CA certificate.

Required by

Users and identity

Maximo Application Suite supports local user authentication by MongoDB and authentication by using Lightweight Directory Access Protocol (LDAP) or Security Assertion Markup Language (SAML).

LDAP

To use LDAP user registry with Maximo Application Suite, you need the following LDAP server information:

Configuration parameters

The following parameters are configurable:

Upload a CA certificate.

Required by

SAML

Configuring SAML user authentication for use with Maximo Application Suite is a multistep process:

  1. Create SAML service provider information
    Your Maximo Application Suite server acts as service provider for the SAML identify provider (IdP). You need to provide a preferred service provider name and select a name identifier format, or you can use the default values. The information is written to a service provider metadata file that you use to configure your SAML provider. For more information, see SAML server.
  2. Register with the SAML provider.
    Configure your SAML IdP to recognize Maximo Application Suite. Use the downloaded SP file and follow the information for your SAML provider to complete this step.
  3. From your SAML IdP, download the SAML IdP metadata XML file to Maximo Application Suite.

Configuration parameters

The following parameters are configurable:

Required by

User registry synchronization

User registry synchronization simplifies Maximo Application Suite user management by synchronizing users and groups between an LDAP server and your local Maximo Application Suite user registry. For more information, see User registry synchronization.

Configuration parameters

The following parameters are configurable:
LDAP domain attributes:

User synchronization:

Group synchronization:

Other:

Upload a CA certificate.

Required by

SMTP

An SMTP server connection is required to enable email notifications for Maximo Application Suite system events, such as new user welcome emails and password reset communication. For more information, see SMTP.

Configuration parameters

The following parameters are configurable:

Upload a CA certificate.

Required by

Push notifications

The Maximo Assist Collaborate feature uses push notifications with your mobile service.

Configuration parameters

The following parameters are configurable:

Upload a CA certificate.

Required by

Analytics and licensing

These configurations manage the Maximo Application Suite license and usage management.

Behavior Analytics Services

The Behavior Analytics Services operator (BAS) collects and processes Maximo Application Suite license and usage information.

For more information about how to configure Behavior Analytics Services, see Configure Behavior Analytics Services.

Configuration parameters

The following parameters are configurable:

Upload a CA certificate.

Required by

Suite License Service

The Suite License Service (SLS) stores and manages the Maximo Application Suite license.

For more information about how to configure Suite License Service, see Configure Suite License Service.

Configuration parameters

The following parameters are configurable:

Upload a CA certificate.

Required by

Other

These configurations control various settings in Maximo Application Suite.

Apache Kafka

Apache Kafka acts as a buffer for asynchronous operations inside the Maximo Application Suite applications.

Important: Be careful if you change the Kafka configuration after you deploy one or more applications that use it. As a rule, cease all active use of the application for a period, disable the application, reconfigure Kafka, and then redeploy the application. For more information, see the application-specific documentation.

Configuration parameters

The following parameters are configurable:

Upload a CA certificate.

Required by

IBM® App Connect

Using IBM App Connect, you can connect applications and data from existing systems and modern technologies across all their environments.

For more information about how to configure and set up IBM® App Connect, see Configure IBM® App Connect .

Required by

External launchers

External launchers are products that are managed outside of Maximo Application Suite. By configuring an external launcher, you enable it for use with Maximo Application Suite and add a tile in the Suite navigator.

Available external launches Type Notes
Manage (external) Application Note: In Maximo Application Suite 8.4.0, the Maximo Manage application can be used both integrated with Maximo Application Suite and externally as a stand-alone but linked application. You can access Maximo Manage from the Suite navigator. For more information, see the IBM Maximo Asset Management documentation.
Maximo MRO Inventory Optimization Application In Maximo Application Suite 8.4.0, the Maximo MRO Inventory Optimization application is not integrated with Maximo Application Suite. It is used as a stand-alone but linked product that requires an externally purchased license. For more information, see Configuring Maximo MRO Inventory Optimization.
Maximo APM for E&U Industry solution In Maximo Application Suite 8.4.0, Maximo APM for E&U is not integrated with Maximo Application Suite. It is used as a stand-alone but linked application that requires an externally purchased license. For more information, see Configuring Maximo APM for E&U.
Scheduler Optimization Add-on You use IBM Maximo Scheduler Optimization to optimize scheduling for your Maximo Manage organization. For more information, see Configuring Maximo APM for E&U

Configuration parameters

The following parameter is configurable:

Watson Discovery

Watson Discovery is a required component for Maximo® Assist. For more information, see Install Watson Discovery.

Configuration parameters

Required by

IBM Watson™ Studio

Watson Studio is a required component for Maximo Health and Predict - Utilities. For more information, see Deploy Maximo Health and Predict - Utilities.

Configuration parameters

The following parameters are configurable:

Required by

IBM® Maximo® Visual Inspection Edge

By using IBM® Maximo® Visual Inspection Edge, you can deploy multiple models that were trained in IBM® Maximo® Visual Inspection to edge devices.

Configuration parameters

The following parameters are configurable:

Required by