bea.com | products | dev2dev | support | askBEA

Download Docs
Search

Installation Guide

Preparing to Install BEA WebLogic Java Adapter for Mainframe

You must complete several tasks before you install the BEA WebLogic Java Adapter for Mainframe (WebLogic JAM). Information about these tasks is included in the following sections:

- Determining the Installation Method

- Determining Your Hardware Requirements

- Verifying WebLogic JAM Software Requirements

- Choosing a BEA Home Directory

If you are migrating from a previous version of WebLogic JAM, see the Migration section at http://download.oracle.com/docs/cd/E13187_01/JAM/v51/index.html.

Determining the Installation Method

The components of WebLogic JAM may be installed on a variety of platforms. See the BEA WebLogic Java Adapter for Mainframe Release Notes for a complete list of supported platforms.

The WebLogic JAM Gateway can be installed in the following ways:

- On Microsoft Windows platforms, a graphical, InstallAnywhere interface is the only choice.

- On Unix platforms, the installation is accomplished with InstallAnywhere, using either a graphical interface or a console (text mode) interface.

The Communications Resource Manager (CRM) can be installed in the following ways:

- On z/OS or OS/390 Unix, installation occurs using a Unix script.

- On z/OS or OS/390 MVS, installation involves Job Control Language (JCL) files.

After the installation is complete, the installation may be validated using the supplied installation verification samples. Verification samples are provided for CICS or IMS.

After WebLogic JAM is installed, it may be removed or uninstalled. Similar to the install interface, the uninstall interface on Microsoft Windows platforms is solely graphical. The uninstall interface on Unix platforms may be either console or graphical. No WebLogic JAM uninstall function is provided for the CRM.

Determining Your Hardware Requirements

Before you begin installing the WebLogic JAM software, verify that your system meets the size requirements for installing and running the WebLogic JAM components. The following requirements must be met for the WebLogic JAM Gateway and the CRM to be successfully installed:

- Platform Requirements

A certified WebLogic Server platform is required. See the BEA WebLogic Java Adapter for Mainframe Release Notes for a complete list of supported platforms.

- Hard Disk Drive Requirements

In addition to the requirements for a WebLogic Server installation, an additional 13-MB of free storage space is required to install WebLogic JAM. Up to an additional 15-MB will be required temporarily for extracting the mainframe files during installation. The mainframe files can be deleted after installation is complete.

The mainframe files require approximately 13-MB of free storage space on OS/390 Unix. An additional 5-MB of free storage is required during installation for extracting the compressed files.

The mainframe files require approximately 30 cylinders of free storage space on MVS. An additional 20 cylinders of free space is required during installation for extracting the compressed files.

- Memory Requirements

For a Microsoft Windows or Unix system, adding a basic WebLogic JAM configuration to a WebLogic Server installation does not significantly increase the system RAM requirements. But increasing the number of service definitions will increase the memory requirement for WebLogic JAM.

Verifying WebLogic JAM Software Requirements

Verify that the following software is installed before you install WebLogic JAM:

- Java Development Kit (JDK)

A JDK is required by the InstallAnywhere installation product to install the WebLogic JAM software. A JDK is installed with WebLogic Server. If you are installing WebLogic JAM without first installing WebLogic Server, set your PATH environment to the appropriate JDK directory.

- WebLogic Server

WebLogic Server is required for proper operation of WebLogic JAM. If you attempt to install WebLogic JAM without installing WebLogic Server, a warning will display, but you can continue installing WebLogic JAM.

Choosing a BEA Home Directory

During installation, WebLogic JAM prompts you to choose an existing BEA Home directory or to specify a path for a new BEA Home directory. If you choose to create a new directory, the WebLogic installer program automatically creates the directory for you.

Note: For a BEA Home directory, you are allowed to install only one instance of each type and version of a BEA product that uses the BEA Home directory convention. For example, you can install only one instance of WebLogic JAM 5.1 in a BEA Home directory, but that BEA Home directory may also contain another version of WebLogic JAM, such as WebLogic JAM 5.0.

Creating More Than One BEA Home Directory

Although it is possible to create more than one BEA Home directory, BEA recommends that you avoid doing so. In almost all situations, a single BEA Home directory is sufficient. In some circumstances, however, you may prefer to maintain separate development and production environments, each containing a separate product stack. With two directories, you can update your development environment (in a BEA Home directory) without modifying the production environment until you are ready to do so.