Requirements

Before you install the product, make sure that your environment meets the following requirements:

 

Related topic

Installation-worksheet

Product compatibility matrix

System requirements

Prepare your environment with the following system requirements:

System

Requirement

Operating system

z/OS 2.3 or later for SMF 100 and RMF records

Db2

Db2 for z/OS version 11, 12, or 13

RTCS

RTCS version 3.1 or later (Installed by Installation system if not already present)

DNA Host Services

FMID ZDHS053

BMC AMI Datastream for Ops Insight

Java

Java17 for z/OS 64 bit

Requirements for accessing the UI

  • Chrome running on a Windows operating system
  • iOS devices
    • Version: 14.4 or later
    • Size: 9.7" or larger
  • Android devices
    • Version: 10 or later
    • Size: 10.5" or larger

Important

On touch screens, only landscape mode is supported.

Requirements for USS parameter

Prepare your USS environment with the following requirements:

Parameter

Requirements

MEMLIMIT

Minimum 64 GB in the OMVS segment of the user running BMC AMI Manager and Tomcat

MAXTHREADS and
MAXTHREADTASKS

192 threads:

  • 64 threads for the PDTDB database
  • 64 threads for MLeap
  • 64 threads for BMC AMI Manager

Memory

  • Minimum normal workload (-Xms)–default 2GB
  • Maximum workload (-Xmx)–default 4GB

Important

These numbers might vary depending on the number of models in use. You can modify them in <INSTALL_PATH>/aoihome/oi_home/mgr/bin/run_manager.sh.

Requirements for WLM 

All components of BMC AMI Ops Insight must run at a higher priority than what they are monitoring. We recommend that you run them in Importance 1.

For the optional detailed analysis to work properly under load, make sure that your BMC AMI Ops Infrastructure and monitor products are defined with the correct WLM Service Class. For more information, see BMC AMI Ops Infrastructure  documentation.

Requirements for DASD storage

The following tables describe the DASD storage requirements for BMC AMI Ops Insight database.

Important

The required DASD space might vary for different users depending on factors, such as:

  • Number of Db2 and z/OS systems monitored by BMC AMI Ops Insight
  • Number of models
  • Number of days to retain the historical data and logs

Number of Db2 and retention

Requirements (approximately)

40 to 45 Db2s with a 60-hour retention 

5-6 GB 

20 to 25 Db2s with a 60-hour retention

3-5 GB 

We recommend keeping two database backups (If the automatic backup is on). If you keep the backups in the same file system, then the total space required should be three times the database size as follows: 

Number of Db2 and retention

Requirements (approximately)

40 to 45 Db2s with a 60 hour retention

16-18 GB 

20 to 25 Db2s with a 60 hour retention

9-11 GB 

Important

Storage space is also required for the bundle backups in /dat/bundles, the extracted files in /dat/models, and the logs, which adds up to approximately 100 MB for DASD storage.

Requirements for installation

The Installation requirements are as follows:

  • The user who runs the SMP/E install and post-install jobs must have an OMVS segment and RACF READ permission to the BPX.FILEATTR.APF and BPX.FILEATTR.PROGCTL resources in the FACILITY class to set USS's APF and PROGCTL extended attributes.

    Important

    Make sure that the user ID has UID=0 or RACF's BPX.DAEMON in the profile.

  • Make sure the following data sets are APF authorized:
    • AMIHLQ.UBMCLINK
    • AMIHLQ.BMCLINK
    • AMIHLQ.BMCLIB  

Tip

(Applies to BMC AMI Ops Insight version 2.0 or later and BMC AMI Ops Monitor products)

If you want to access BMC AMI Ops Insight version 2.0 or later and BMC AMI Ops Monitor products from the same BMC AMI Ops user interface, we recommend that you install both the products in the same SMP/E environment. 

Requirements for Db2 

BMC AMI Ops Insightrequires Db2 SMF 100 records.

Requirements for OMVS

The user IDs assigned to BMC AMI Ops Insight started tasks must have an OMVS segment defined with a HOME directory.

For example,

HOME=/u/<started_task_userid> 

Requirements for RMF/CMF

For BMC AMI Ops Insight to collect the required SMF data SYSPLEX KPIs, BMC AMI Ops Monitor for CMF or IBM’s RMF Monitor I (SMF 70-78), and Monitor III (SMF 74.2 and 74.4) need to be active on the LPARs where your Db2 subsystems are running. Although SMF record types 74-2 (XCF Activity) and 74-4 (CF Activity) are optional, we recommend gathering those.

  • CMF and RMF extractors produce identical type 70 through type 79 records. If you have CMF and RMF active simultaneously, make sure that only CMF or RMF is configured to write to the SMF data set, or SMF logstream, to prevent duplicate records in BMC AMI Ops Insight.

  • Make sure that following control statements are enabled in CMF or RMF:

    SMF Record Types

    CMF Control Statements

    RMF I & III Control Statements

    Comments

    SMF type 70-1

    CPU

    CPU

    CPU statistics

    SMF type 71-1

    PAGING

    PAGING

    Paging statistics

    SMF type 72-3

    WORKLOAD

    WKLD

    Workload manager statistics

    SMF type 74-2

    XCFDATA

    CFDETAIL

    XCF detail statistics

    SMF type 74-4

    CFDATA

    CFDETAIL

    CF detail statistics

    SMF type 77

    ENQUEUE

    ENQ

    Enqueue detail statistics

    SMF type 78-2

    VSMDATA

    VSTOR

    Virtual storage statistics

  • If you are using CMF, you must specify the following parameters in the REPORT statement of your CMFCPMxx member:
CPM,SMF=YES,SYNC=SMF,INTERVAL=SMF

Requirements for detailed analysis

(Optional) Prepare your environment as follows to enable the optional detailed analysis:

Component

Requirement

BMC AMI Ops Infrastructure

Version 6.3 or later

BMC AMI Ops Monitor products

PTF-level must include BPD4967, BPD5069 and BPD5058

The version requirements for the detailed analysis function for BMC AMI Ops Monitor products are as follows:

BMC AMI Ops Monitor product

Version

BMC AMI Ops for DB2   

12.2 or later

BMC AMI Ops for CICS           

6.9 or later

BMC AMI Ops for IMS 

5.5 or later

BMC AMI Ops for z/OS

6.3 or later

User access

The user ID associated with the data preparation address space must have READ access to your BMC AMI Ops Monitors' data.

Requirements for graphs functionality

(Optional) To install the Docker container for the optional graphs functionality, the following items are required:

Item

Requirement

zCX

 

  • z/OS 2.4 or later
  • zCX (2.0.0 or later) Container Hosting Foundation available on z14 or z15 via feature code FC0104 or native on a z16
  • Private memory - 2 to 4 GB (recommended 4 GB)
  • Storage – 3 GB per monitored Db2 (one month of data)

Important

You require a single zCX for the graphs and the workload graphs functionality.

To plan for zCX installations and understand system requirements, see your IBM documentation and IBM Redbook SG248457, Getting Started with z/OS Container Extensions.

Linux on x86

Any Linux version that supports Docker Engine 19.03 or later

  • CPU –  2 to 4 Core 
  • RAM – 8 to 16 GB 
  • Storage –  3 GB per monitored Db2 (one month of data)

zLinux

Any Linux version that supports Docker Engine 19.03 or later and Podman version 4.0.0 or later

  • CPU –  2 to 4 Core
  • RAM – 8 to 16 GB
  • Storage – 3 GB per monitored Db2 (one month of data)

To specify a port for the Docker container

Enter the port number as follows:

./run.sh p=<dashboard_port> dbport=<postgre_port_number>

Important

To install the optional Docker container for Workload, you need to specify a port number for the PostgreSQL database. The default value for the port is 5433, but if that port is not available, you need to specify a new port.

To configure Docker properties for the BMC AMI Manager

  1. Open the $AMI_INSTALL_PATH/aoidata/aoiinst/conf/amipdt.properties file.
  2. Update the fields as follows:

    • postgre_host=<dockerhost>
      Here, <dockerhost> is the domain name of the optional graph component.
    • postgre_port=<PostgreSQL DB port>
    • DOCKER_HOST=<dockerhost>
    • DOCKER_PORT=<dockerport>
    • DOCKER_PROTOCOL=<protocol> 
      Here, the value for <protocol> can be http or https.

Requirements for BMC AMI Ops Insight playback docker container on local PC

(Optional) To install the BMC AMI Ops Insight Playback Docker container for playing back historical data on local PC, one of the following items is required:

Item

Requirements

Windows

  • Docker Desktop on Windows (Requirements as provided in Docker Desktop documentation)
  • CPU – 2 Core
  • RAM – 4 GB
  • Storage – 1 GB

Important

You require a single docker desktop for the playback container and the graphs functionality container.

To plan for docker desktop installations and understand system requirements, see Docker Desktop documentation.

Linux on x86

Any Linux version that supports Docker Engine 19.03

  • CPU – 2 Core
  • RAM – 4 GB
  • Storage – 1 GB

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*