Installing and upgrading Infrastructure Management components

Use the following instructions to install and upgrade Infrastructure Automation - Infrastructure Management. Install Infrastructure Management for use with Cloud Pak for AIOps or just install Infrastructure Management as a stand-alone component.

Install the Infrastructure Management appliance

You can use the following steps to install Infrastructure Management as an appliance:

  1. If you are installing Infrastructure Management for use with Cloud Pak for AIOps then use the listed prerequisites steps. For more information, see Prerequisites for use with Cloud Pak for AIOps.

    Skip this step if you only want to install Infrastructure Management and do not want to use Infrastructure Management with Cloud Pak for AIOps.

  2. Download the Infrastructure Management appliance package for your environment. For more information, see Download the Infrastructure Management appliance.

  3. Set up a virtual machine based on the appliance and configure the Infrastructure Management appliance. Follow the steps in the installation topic for your platform:

  4. Configure OIDC integration between IBM Cloud Pak® and the Infrastructure Management appliance. For more information, see Configure OIDC integration between IBM Cloud Pak® and the Infrastructure Management appliance.

    Skip this step if you only want to install Infrastructure Management and do not want to use Infrastructure Management with Cloud Pak for AIOps.

    Note: Only OIDC-based authentication (OpenID Connect) is supported. The configuration of OpenID Connect (OIDC) is required for integration with Infrastructure Management and IBM Cloud Pak®.

  5. For more information about usage data collection and the recommended configuration files, see Enable usage data collection (optional).

Prerequisites for use with Cloud Pak for AIOps

Note: Skip the Prerequisites for use with Cloud Pak for AIOps section if you only want to install Infrastructure Management and do not want to use Infrastructure Management with Cloud Pak for AIOps.

  • Ensure you enable the operators for Infrastructure management by opening the installation YAML file. Locate the pakModules section, and change enabled: false to enabled: true. Enable these Infrastructure Management-related operators:

    • ibm-management-im-install for Infrastructure Management has been installed. For more information, see Infrastructure management.

  • You must configure and connect an LDAP directory with IBM Cloud Pak®. You must have an LDAP group in your configuration for IBM Cloud Pak with users defined who will access Infrastructure Management.

Downloading Infrastructure Management packages

Complete the following procedure to download your packages:

  1. Go to the IBM® Passport Advantage® Online tab at Passport Advantage and log in with your IBM ID.
  2. Find your part number.
  3. Search for the files by using the part numbers that are listed in the table.
  4. Download the files to a directory on your system.

For more information about the available packages for Infrastructure Automation, including for Infrastructure Management, see Passport Advantage part numbers.

Enable usage data collection (optional)

To help the development of Infrastructure Automation - Infrastructure Management, aggregated usage data is collected to analyze how Infrastructure Management is used. The collection of usage data is enabled by default, but can be disabled.

For the data collection, Infrastructure Management uses the existing daily job that is used for audit logging of managed resources and for licensing tracking. This job is extended to collect and send the usage data metrics to IBM. The sent data is then stored in IBM controlled GDPR-compliant systems. The usage data that is collected does not include personal information, passwords, or specific details. Only the following data is collected:

  • The number of virtual machines (VMs), hosts, providers (and provider types), services, and service catalog items that are being used in the Infrastructure Management inventory.
  • Whether Infrastructure Management is deployed as a containerized deployment (podified) or virtual machine appliance.
  • (Stand-alone deployments) The architecture where Infrastructure Management is deployed (Linux x86_64, Linux on Power (ppc64le), Linux® on IBM Z® and LinuxONE (s390x)).

Disabling the collection of usage data

If you want to disable the collection of usage data, create the following configuration files:

  1. Create the /run/secrets/segment directory.

    mkdir -p /run/secrets/segment

  2. Create the file with your company name:

    echo "<COMPANY_NAME>" > /run/secrets/segment/CUSTOMER_NAME

    Where <COMPANY_NAME> is the name of your company.

  3. Create the file with your customer number:

    echo "<CUSTOMER_NUMBER>" > /run/secrets/segment/CUSTOMER_ICN

    Where <CUSTOMER_NUMBER> is your IBM customer number.

  4. Create the file with your environment name:

    echo "<ENV>" > /run/secrets/segment/ENVIRONMENT

    Where <ENV> can be trial, poc or production.

To opt out of usage data collection, create the following configuration file:

echo "false" > /run/secrets/segment/ENABLE_COLLECTION