BMC AMI Cloud agent requirements

This topic describes the requirements for the BMC AMI Cloud agent.

z/OS requirements

z/OS version	z/OS V2R2 and later
Java version	Java 8 64-bit SR6 FP25 and later, with JZOS setup complete Using an earlier version causes a failure on startup with the message ZM91005E. Important Version 11 of IBM Java for z/OS is not supported. To verify the Java version, see Verifying the Java version.
Maintenance level	IBM APAR OA52913—Required for archive using SMS attributes IBM APAR OA58743—(Optional) To fix possible S878 agent abends IBM APAR OA58113—For DFDSS restore of extended format data sets IBM APAR OA61175—For DFDSS when working with encrypted data sets IBM APAR OA66423—To fix the two second delay for API invoked calls in 3.1
z/OS Common Service Area (CSA)	(For Cloud Data Sets) Minimum of 100 KB below-the-line memory in the CSA storage area
Date and time	The z/OS date and time should match the object storage UTC date and time You can display the UTC date and time by using the /D T MVS command or the date -u USS command Important If the UTC time does not match, the agent requires additional setup. Contact BMC Support for assistance. If the setup is not applied, the agent fails with an HTTP error code 403 while trying to connect to the object storage.

Verifying the Java version

To verify the Java version and to change the Java installation directory, use the following commands:

cd /usr/lpp/java/J8.0_64/bin
./java -version
java version "1.8.0_281"
Java(TM) SE Runtime Environment (build 8.0.6.25 - pmz6480sr6fp25-20210115_01(SR6 FP25))
IBM J9 VM (build 2.9, JRE 1.8.0 z/OS s390x-64-Bit Compressed References 20201218_462060 (JIT enabled, AOT enabled)
OpenJ9   - 4c03b71
OMR      - 86a8e1a
IBM      - 8c30c56)
JCL - 20210108_01 based on Oracle jdk8u281-b09

Hardware requirements

Memory	1 GB per LPAR Best practice For high performance, we recommend the production level is 4 GB or higher.
DASD space	Minimum 200 cylinders for a BMC AMI Cloud ZFS allocation

Security requirements

Permissions of user running installation process	OMVS SEGMENT defined BPX.FILEATTR.APF ACC(READ) BPX.FILEATTR.PROGCTL ACC(READ) BPX.FILEATTR.SHARELIB ACC(READ)

Network requirements

Firewall	If any z/OS based firewall solution is in effect (such as PAGENT), make sure to allow the agent's communication.
Network security	The agent handles its own SSL encryption. The traffic cannot be encrypted by ATTLS (PAGENT).

Verifying z/OS agent requirements

Use the verification scripts that were supplied with the installation package to verify that the z/OS system is ready for installation and that all the requirements are satisfied.

The scripts verify the following requirements:

Java version
Status of the RACF class PROGRAM
Availability of network ports
Firewall rules permitting access to target storage

You must supply the following information to run the script:

z/OS Java home directory
Temporary work directory
Object storage IP/DNS and port

To run the verification script:

Upload the z/OS verification JCL from VerificationScripts.zip under /PrereqsScripts/zOS. Use the ASCII transfer type.

Edit the JCL according to the instructions in the comment. Submit and review the return code (RC) and messages in SYSTSPRT DD.

RC	Explanation
0	All verification tests ended successfully.
4	One of the following messages is displayed: RACF CLASS PROGRAM is active Object storage connectivity was refused (port might be down).
8	One of the following messages is displayed: Java version not compatible Path not valid Object storage is unavailable
16	Java version did not print any output.