Installation requirements for BMC AMI Ops Insight

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


Related topic

Product compatibility matrix

System requirements

Prepare your environment with the following system requirements:

Item

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 2.1 or later (Installed by Installation system if not already present)

DNA Host Services

FMID ZDHS053

BMC AMI Datastream for Ops Insight

BMC AMI Datastream for Ops Insight version 7.1.01.SPE2404

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:

ParameterRequirements
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 Open link documentation.

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 Insight requires 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 TypesCMF Control StatementsRMF I & III Control StatementsComments
    SMF type 70-1CPUCPUCPU statistics
    SMF type 71-1PAGINGPAGINGPaging statistics
    SMF type 72-3WORKLOADWKLDWorkload manager statistics
    SMF type 74-2XCFDATACFDETAILXCF detail statistics
    SMF type 74-4CFDATACFDETAILCF detail statistics
    SMF type 77ENQUEUEENQEnqueue detail statistics
    SMF type 78-2VSMDATAVSTORVirtual 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:

ItemRequirement

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 productVersion

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/OS6.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 graph functionality

(Optional) To install the Docker container for the optional graph functionality, one of the following items is required:

ItemRequirement

zCX


  • z/OS 2.4 or later
  • zCX Container Hosting Foundation available on z14 or z15 via feature code FC0104 or native on a z16
  • Minimum 2 GB of private memory (recommended 4 GB)
  • Storage – 2.2 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 – 1 Core
  • RAM – 1 GB
  • Storage – 2.2 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 – 1 Core
  • RAM – 1 GB
  • Storage – 2.2 GB per monitored Db2 (one month of data)

Requirements for Workload graphs functionality

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

ItemRequirement

zCX


  • z/OS 2.4 or later
  • zCX Container Hosting Foundation available on z14 or z15 via feature code FC0104 or native on a z16
  • Minimum 2 GB of private memory
  • Storage – 2 GB (More storage may be required if the number of Workload events increases.)

Important

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

Linux on x86

Any Linux version that supports Docker Engine 19.03

  • CPU – 1 Core
  • RAM – 2 GB
  • Storage – 2 GB (More storage may be required if the number of Workload events increases.)
zLinux

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

  • CPU – 1 Core
  • RAM – 1 GB
  • Storage – 2.2 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:

ItemRequirements

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


Was this page helpful? Yes No Submitting... Thank you

Comments