Standard installation with IBM Maximo Application Suite CLI

You can install the IBM® Maximo Application Suite by using a command-line interface (CLI) utility.

Before you begin

You can use IBM's container image to install Maximo Application Suite. The container image provides an out of the box environment for managing Maximo Application Suite on Red Hat® OpenShift®, with numerous dependencies preinstalled.
In a scenario where you need to install the CLI utility, which is an open source tool, on your local system, you must configure the following software.
  • Bash (v4)
  • Red Hat OpenShift client
  • IBM Cloud® client with container plug-in enabled
    Note: IBM Cloud is not required if you are deploying Maximo Application Suite on an organization's Red Hat OpenShift cluster.
  • Ansible®
  • Python
  • Network access to the Red Hat OpenShift cluster

Download the Maximo Application Suite CLI utility onto the bastion host. This utility provides commands to manage the local docker registry, configure policies in the Red Hat OpenShift cluster, and deploy Maximo Application Suite.

For more information about installing the utility, see Maximo Application Suite CLI Utility.

To use the Maximo Application Suite CLI utility, ensure that the bastion host has support for running docker containers.

For more information, see Planning for IBM Maximo Application Suite standard installation with CLI.

Procedure

  1. Run the docker run command to use the container image that is published.
    docker run -ti --rm -v ~:/mnt/home --pull always quay.io/ibmmas/cli
    If you want a specific release of the image, use a specific version tag in the docker pull command :
    docker run -ti -v ~:/mnt/home quay.io/ibmmas/cli:x.y.z
    For more information on the software included in the container image, see MAS CLI Base Image.
  2. Install Maximo Application Suite.
    Run the following command from a running CLI docker container.
    docker run -ti --pull always quay.io/ibmmas/cli mas install

    For more information, see the Install command.

    Tip: To customize Maximo Application Suite instances with extra features that might be unavailable in Maximo Application Suite CLI, you can use ansible-devops for advanced configuration. For more information, see Maximo Application Suite Devops Ansible Collection.

    For a list of supported CLI commands, see CLI commands.

    You can also run the installation in interactive mode. For more information, see Interactive install.

What to do next

Complete the Maximo Application Suite setup. For more information, see the following topics.
Authentication methods
Maximo Application Suite supports MongoDB, Lightweight Directory Access Protocol (LDAP) authentication, and Security Assertion Markup Language (SAML) authentication methods for local user authentication.
LDAP 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.
Administering users and user access

The initial superuser account is used to complete the Maximo Application Suite setup. You can add application administrator users or system administrator users for day-to-day administrative tasks.

Getting started
With the setup completed, your users can log in and start using Maximo Application Suite.