Prerequisites

Edit online

IBM Z® OMEGAMON® AI Insights is a new component of Tivoli® Management Services 6.3.3. This is a no charge, prerequisite offering required for each monitoring agent that can leverage OMEGAMON AI Insights. Its working therefore depends on the availability and proper functioning of several other components.

Before installing and configuring OMEGAMON AI Insights ensure that you have the following in place.

Supported platforms

  • Docker Engine: 27.1
    Note: OMEGAMON AI Insights is compatible with Docker Engine version starting from 23.0 and higher, but it is recommended to always use the latest version as Docker fixes security issues.
  • Docker Compose: V2
  • Operating system: s390x Linux for Z
  • ELK version: Elasticsearch 8.11.3, Kibana 8.11.3, and Logstash 8.11.3
  • OMEGAMON Data Provider: July 2024: APAR OA66572

Server configuration

Reliable operation of OMEGAMON AI Insights depends on the availability of a sizable volume of historical data. The minimum required storage period is three months. For optimal performance with 50 LPARs, CICS + JVM + Network + Storage + z/OS OMEGAMON Data Provider collections, the recommended configuration is as follows:
  • Minimum 100 GB storage (no backup)
  • 64 GB RAM (32 GB dedicated to Elasticsearch)
  • 4 cores
To ensure resilience in the event of a system failure, OMEGAMON AI Insights will seamlessly restore from historical data without disruption. To prevent congestion and safeguard the database, it is recommended to use a second server for Elasticsearch clustering:
  • Minimum 100 GB storage
  • 32 GB RAM
  • 4 cores
Note: It is recommended to do the following tasks:
  • Deploy the AI Engine and the Elasticsearch in separate servers.
  • Activate the Logstash queue and backup your models and database regularly.

Network

Ensure that the following TCP ports are open in both directions:
  • 9200 for Elasticsearch
  • 5601 for Kibana
  • 9600 and 15046 for Logstash (OMEGAMON Data Connect configuration)

OMEGAMON Monitoring Agents

OMEGAMON AI Insights is available with Tivoli Management Services. It can analyze data collected from the following monitoring agents:

Table 1. OMEGAMON Monitoring Agents
Product code Monitored subsystem Monitoring agent Monitoring agent: minimum version supported
kc5 CICS IBM Z OMEGAMON AI for CICS 6.1
kjj JVM IBM Z OMEGAMON AI for JVM 6.1
kn3 Network IBM Z OMEGAMON AI for Networks 6.1
km5 z/OS IBM Z OMEGAMON AI for z/OS 6.1

OMEGAMON Data Provider

Along with a monitoring agent, you must have IBM Z OMEGAMON Data Provider July 2024: APAR OA66572 installed. All data from the monitoring agent is streamed to OMEGAMON AI Insights via IBM Z OMEGAMON Data Provider.

User account

The OMEGAMON AI Insights code installation process requires a user account with root privileges (directly or via sudo). For example, kmua:kmua. kmua is the code for the product and is used in the rest of the document.

ELK stack (Elasticsearch + Logstash + Kibana)

Finally, you must have a suitable version of the Elastic stack – Elasticsearch, Logstash, and Kibana - installed.

Elasticsearch
Elasticsearch serves as the data storage and search platform for OMEGAMON AI Insights.
Note: If you are already using IBM Z OMEGAMON Data Provider and collecting historical data from OMEGAMON, ensure that you have the following parameters present in the elasticsearch.yml file, before installing OMEGAMON AI Insights. OMEGAMON AI Insights support SSL communication protocol and it is recommended to maintain secured communication.
Table 2. Elasticsearch parameters
Parameter Description
xpack.security.enabled: true Required for alerting.
xpack.security.transport.ssl.enabled: true Required for alerting.
Logstash
Data collected by IBM Z OMEGAMON Data Provider is transmitted to Logstash.
Note: If you are already using IBM Z OMEGAMON Data Provider and collecting historical data from OMEGAMON, the security settings are configured in the connect.yaml configuration file and no additional configurations are required.
Kibana
Kibana provides the visual frontend. A version of Kibana that works on Linux for Z is not available off the shelf and needs to be compiled.
Note: If you are already using IBM Z OMEGAMON Data Provider and collecting historical data from OMEGAMON, ensure that you have the following parameters present in the kibana.yml file, before installing OMEGAMON AI Insights.
Table 3. Kibana parameters
Parameter Description
kibana.username: "kibana_username" Used for basic security.
kibana.password: "kibana_password" Used for basic security.
xpack.security.encryptionKey: "something_at_least_32_characters_rs" Used for basic security.
xpack.encryptedSavedObjects.encryptionKey:"something_at_least_32_characters_rs" Used for basic security.

After you have the software in place, you can install OMEGAMON AI Insights.