Web Services Security Guides › CA SiteMinder® Web Services Security Agent Guide for Apache-based Web Servers › Preparation › Hardware Requirements for CA SiteMinder® Agents › Preparations for z/OS

Preparations for z/OS

Before you install and configure a CA SiteMinder® agent on the z/OS operating environment, perform the preparation steps described in this process.

1. Locate the CA SiteMinder® Platform Support Matrix.
2. Locate the installation media.
3. Add a supported JRE to the system path.
4. Set the DISPLAY variable.
5. Verify the presence of a logs subdirectory.

Locate the Platform Support Matrix

Use the Platform Support Matrix to verify that the operating environment and other required third-party components are supported.

Follow these steps:

1. Go to the CA Support site.
2. Click Product Pages.
3. Enter the product name and click Enter.
4. Open popular links and click Informational Documentation Index.
5. Click Platform Support Matrices.

Note: You can download the latest JDK and JRE versions at the Oracle Developer Network.

Technology Partners and CA Validated Products

The latest list of partners and their validated products.

Locate the Installation Media

If you need a base release, follow these steps:

1. Go to the CA Support site and click Product Pages.
2. Enter the product name and click Enter.
3. Open Quick Access and click Download Center.
4. Log in.
5. Locate your product in the Use the Select a Product list.
6. Select a release and gen level. Click Go.
7. Save the installation zip locally and extract the kit to a temporary location.

If you need a cumulative release (cr), follow these steps:

1. Go to the CA Support site and click Product Pages.
2. Enter the product name and click Enter.
3. Open Quick Access and click Hotfix/Cumulative Release Index.
4. Log in.
5. Click the release you want.
6. Save the installation zip locally and extract the kit to a temporary location.

Add a Supported JRE to the System Path

On z/OS systems, before installing the CA SiteMinder® agent, verify that a supported JRE is present on the system and defined in the PATH and JAVA_HOME system variables.

Follow these steps:

Enter the following commands at a command prompt:

export PATH=JRE/bin:$PATH
export JAVA_HOME=JRE

JRE

Specifies the location of the JRE.

For example, /sys/java64bt/v6r0m1/usr/lpp/java/Jversion_number

Set the DISPLAY Variable for CA SiteMinder® Agent Installations on z/OS

If you are installing the CA SiteMinder® agent on a z/OS system from a remote terminal, verify that the DISPLAY variable is set for the local system. For example, if your server IP address is 111.11.1.12, set the variable as follows:

export DISPLAY=111.11.1.12:0.0

Note: You can also install the CA SiteMinder® agent using the console mode installation, which does not require the X window display mode.

Verify Presence of a Logs Subdirectory with Permissions for Apache-based CA SiteMinder® Agents

For any agents for Apache-based web servers (including IBM HTTP Server), a logs subdirectory must exist under the root directory of the Apache-based web server. This subdirectory needs Read and Write permissions for the user identity under which the Apache child process runs.

If the logs subdirectory does not exist, create it with the required permissions.

Note: This configuration requirement applies to any Apache-based web server that writes log files outside the Apache root directory.