Created:  | Updated: 


Downloading z/IRIS z/OS Client installation packages

z/IRIS IronTap installation packages can be downloaded from the mainstorconcept Download Portal. New users should register here first, before accessing the portal.

z/IRIS is owned, licensed and distributed by mainstorconcept GmbH. For more information about obtaining the required licenses to run z/IRIS, please consult your mainstorconcept representative


Requirements

z/IRIS clients are IBM JZOS based applications that stream SMF records to the Linux Server for processing and integration into 3rd party APM tools (z/IRIS IronTap).

z/OS requirements...

Please refer to the minimum hardware and software requirements page.

IBM Java for z/OS

z/IRIS clients require IBM Java SDK 1.8. For more information on how to install and configure IBM Java for z/OS, please visit the IBM Knowledge Center.

In-Memory Resources

z/IRIS clients stream SMF records from IBM SMF in-memory resources. For information on how to configure new SMF in-memory resources, please visit the IBM Knowledge Center.

Apache Kafka integration

z/IRIS clients activate Kafka Producers to stream SMF to a predefined and network accessible Kafka cluster. Users must download and install the Apache Kafka binaries in z/OS USS before configuring z/IRIS clients for Kafka streaming mode.  

Visit the official Apache Kafka website to download binaries and access all relevant documentation about Apache Kafka Producers and Apache Kafka Clusters and more.

For more information about z/IRIS integration with Apache Kafka, visit Apache Kafka - Configuration Guide.


Security preparations ...

RACF preparation 

All z/IRIS clients must be granted access to SMF in-memory resources using SAF permissions. The RACFJCL text file is a RACF batch job to create a surrogate userid for the z/IRIS client started task  with the required permissions for OMVS, SMF in-memory resources and MVS display commands.

Upload, customize and submit RACFJCL from the zIRISzOSClient.v%.%.%.zip installation package.

The settings detailed in the RACFJCL are not final, and some settings can be omitted. To ensure a problem free installation, consult your mainstorconcept Technical Professional regarding any changes to RACF permission in RACFJCL before proceeding with the installation.


ZFS filesystem preparations ..

zFS directory preparations ($APP_HOME)

Customize and run the following JCL example to create and mount a new zFS directory for z/IRIS in USS. This directory is hereinafter referred to as $APP_HOME.

Sample JCL to create z/IRIS zFS directory
// JOB
//* Create a z/IRIS zFS directory
//CREATE EXEC PGM=BPXBATCH,
// PARM='SH mkdir -p /usr/lpp/ziris'
//* Create ZFS mount point for z/IRIS
//DEFINE EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE CLUSTER (NAME(hlq.ZIRIS.ZFS) -
LINEAR CYL(200 50))
VOLUMES(xxxxxx) -
/*
//* Mount the z/IRIS directory
//MOUNT EXEC PGM=IKJEFT01,DYNAMNBR=10
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
MOUNT FILESYSTEM('hlq.ZIRIS.ZFS') +
MOUNTPOINT('/usr/lpp/ziris') +
TYPE(ZFS) MODE(RDWR) /* AUTOMOVE */
CODE


Steps to install z/OS client package

  1. Extract and upload (in binary mode) the zirisv%%.pax to the $APP_HOME directory on z/OS USS. 

  2. Unpack the file using the tar command:

    pax command

    pax -w[v]f zirisv1%%.pax
    BASH
  3. Apply the authorized extended attribute to $APP_HOME/bin/CONSL001:

    extatttr command

    cd $APP_HOME/bin
    extattr +a ./CONSL001
    CODE
  4. Make all commands in $APP_HOME/bin executable:

    chmod command

    cd $APP_HOME/bin
    chmod +x ./*
    CODE