BEA Home | Events | Solutions | Partners | Products | Services | Download | Developer Center | WebSUPPORT
WebLogic Java Adapter for Mainframe Documentation | Workflow Processing Guide | Previous Topic | Next Topic | Contents | Index

Installing the WebLogic JAM Plug-In

This section provides information on the following subjects:

- Preparing to Install WebLogic JAM Plug-in

- Verify Software Requirements

- Download WebLogic JAM Plug-in from the Web

- Determine the Installation Method

- Installing the WebLogic JAM Plug-in

- Using Graphics Mode Installation

- Using Console Mode Installation

- Verifying Your Installation

- Uninstalling BEA WebLogic Java Adapter for Mainframe Plug-in

Preparing to Install WebLogic JAM Plug-in

Before installing the WebLogic JAM Plug-in, you must:

- Verify Software Requirements

- Download WebLogic JAM Plug-in from the Web

- Determine the Installation Method

Verify Software Requirements

The WebLogic JAM Plug-in is dependent on the following software. Verify the installation and configuration of:

- WebLogic JAM

- WebLogic Integration

Verify that these software products have been properly configured by referring to the appropriate product documentation.

Determine the Appropriate Platform

The WebLogic JAM Plug-in may be installed on a variety of platforms. Refer to the BEA WebLogic Java Adapter for Mainframe Release Notes for a complete list of supported platforms.

You must decide the platform on which platform you will install the WebLogic JAM Plug-in before proceeding.

Download WebLogic JAM Plug-in from the Web

An evaluation copy of WebLogic JAM Plug-in is available for download from the BEA corporate Web site at:

http://commerce.bea.com/downloads/weblogic_server.jsp#jam.

Because the WebLogic JAM Plug-in shares the WebLogic JAM license, its license will be updated when you update the WebLogic JAM license.

Determine the Installation Method

The WebLogic JAM Plug-in can be installed in the following ways:

- In Graphics Mode on Windows or Unix

Graphics mode installation is the graphics-based method of executing the BEA Installation program. It can be run on both Windows and Unix systems.

Note: To run Graphics mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI.

- In Console Mode on Unix

Console-mode installation is the text-based method of executing the BEA Installation program It can be run only on Unix systems and is intended for Unix systems with non-graphic consoles.

Installing the WebLogic JAM Plug-in

After performing the tasks described in Preparing to Install WebLogic JAM Plug-in, you can begin the installation procedure. There are two ways to install the WebLogic JAM Plug-in:

- Using Graphics Mode Installation

- Using Console Mode Installation

Using Graphics Mode Installation

To install the WebLogic JAM software in graphics mode, perform the following steps:

1. For Windows platforms, open the jampi_win.exe file you downloaded (see Download WebLogic JAM Plug-in from the Web).

For Unix platforms, do the following:

1. Define the DISPLAY environment variable as follows:

>     /mnt> export DISPLAY=xx.xx.xx.xx:0.0

>     (xx.xx.xx.xx is the IP address of the machine from which you are installing)

2. Execute the installation program.

>     /mnt> sh jampi_Unix.bin

2. The InstallAnywhere screen displays, preparing to install.

3. The BEA WebLogic Java Adapter for Mainframe splash screen displays.

4. Then, the Introduction screen displays.

5. Click Next to continue the installation process. The Choose BEA Home Directory displays.

6. Select a BEA Home option, then click Next.

- If you select the default setting, Use Existing BEA Home, the default location is the BEA Home directory where other BEA WebLogic software is located.

- If you select Create New BEA Home, you can enter the location for the new directory or click Browse to select a new location.

7. If a previous installation of the WebLogic JAM Plug-in is detected, the following message displays:

- Click Continue to install over the previous version.

- Click Exit to exit the installation process.

- Click Previous to return to the previous screen to change the location of the directory.

8. If WebLogic JAM is not installed, the following warning displays:

- Click Exit to exit the installation process.

- Click Previous to return to the previous screen to change the location of the directory.

9. If WebLogic Server 6.1, Service Pack 2 is not installed, the following warning displays:

- Click Exit to exit the installation process. You can restart the installation process after you install WebLogic Server.

10. If WebLogic Integration is not installed, the following warning displays:

- Click Exit to exit the installation process. You can restart the installation process after you install WebLogic Integration.

Note: You can have several BEA Home directories, but products that are dependent on each other must be installed in the same BEA Home directory. For example, WebLogic Server and WebLogic JAM must be in the same BEA Home directory.

11. When you have selected the appropriate BEA Home directory, the Configuring screen displays.

12. Click Next to begin the installation process. A screen showing the status of the installation process displays.

13. When the installation process is complete, the Install Complete screen displays.

14. Click Done to exit the installation program. The Windows installation process updates the Windows program group named BEA WebLogic E-Business Platform with the WebLogic JAM Plug-in program item.

Using Console Mode Installation

To install the WebLogic JAM Plug-in on Unix systems using the console-mode installation, run the BEA standard installation shell script as follows:

>     jampi_Unix.bin

Perform the following steps:

1. Set the JAVA_HOME and PATH environment variables as follows:

>     /mnt> export JAVA_HOME=<BEA_HOME>/<JDK_DIR>

>     /mnt> export PATH=<BEA_HOME>/<JDK_DIR>/bin:$PATH

Example: If your BEA Home directory is /usr/bea, then these environment variables should be set as follows:

>     /mnt> export JAVA_HOME=/usr/bea/jdk131

>     /mnt> export PATH=/usr/bea/jdk131/bin:$PATH

2. Execute the installation program you downloaded (see Download WebLogic JAM Plug-in from the Web). For example:

>     mnt> sh jampi_Unix.bin -i console

3. The installation program runs and prompts you for responses. Listing2-1 shows a sample of the console mode installation script. User input is shown in bold.

Listing 2-1 Console Mode Installation Script

>     Preparing to install...
>     Preparing CONSOLE Mode Installation...
>     =================================================================

>     BEA WebLogic JAM Plug-in (created with InstallAnywhere by Zero G)
>     -----------------------------------------------------------------

>     =================================================================

>     Introduction
>     -------------

>     This installer will guide you through the installation of 'BEA WebLogic JAM Plug-in'. On each step, answer the questions provided. Type "quit" at any time to exit the installer.

>     PRESS <ENTER> TO CONTINUE:

>     =================================================================

>     Choose BEA Home Directory
>     -------------------------

>         1- Create a New BEA Home

>         2- Use Existing BEA Home

>     Enter a number: 2

>         1- /bea

>         2- /tmp/install.dir.15582

>     Existing BEA Home: 1

>     Installing...
>     -------------

>     [---------------|---------------|---------------|---------------]
>     =================================================================

>     Install Complete
>     ----------------

>     Congratulations. 'BEA WebLogic JAM Plug-in' has been successfully installed to:

>        /bea/wlintegration2.1

>     PRESS <ENTER> TO EXIT THE INSTALLER:

Installing Over a Previous Version

If you are installing over a previous version of the WebLogic JAM Plug-in, you will see the following section of the installation script:

>     >>>> THIS PART ONLY APPEARS WITH A PREVIOUS INSTALL <<<
>     ------------------------------------------------------------

>     A previous installation of BEA WebLogic JAM Plug-in 5.0 has been detected at /bea/wlintegration2.1.

>      The following options are available:

>         1- Continue to install over /bea/wlintegration2.1

>         2- Cancel to select another BEA Home Directory

>         3- Exit the installation

>     Choose a number: 1

>     >>>> THIS PART ONLY APPEARS WITH A PREVIOUS INSTALL <<<
>     =================================================================

Installing Without WebLogic JAM

If you attempt to install the WebLogic JAM Plug-in without a valid installation of WebLogic JAM, you will see the following section of the installation script:

>     =================================================================

>     WebLogic JAM Plug-in requires a valid installation of the WebLogic JAM 5.0. Check your BEA Home directory to ensure that product is installed. Hit <ENTER> to quit an installation.:

>     [machine_name]:/home/tmp
>     .............................................................

Installing Without WebLogic Server

If you attempt to install the WebLogic JAM Plug-in without a valid installation of WebLogic Server 6.1, SP2, you will see the following section of the installation script:

>     =================================================================

>     WebLogic Server 6.1 SP2 NOT FOUND!
>     ----------------------------------

>     WebLogic Server 6.1 SP2 is not installed. It should be installed into the same BEA Home as WebLogic JAM 5.0. Hit <ENTER> to quit an installation.:

>     [machine_name]:/home/tmp

>     .............................................................

Installing Without WebLogic Integration

If you attempt to install the WebLogic JAM Plug-in without a valid installation of WebLogic Integration 2.1, you will see the following section of the installation script:

>     =================================================================

>     WebLogic Integration 2.1 NOT FOUND!
>     -----------------------------------

>     WebLogic Integration 2.1 is not installed. It should be installed into the same BEA Home as WebLogic JAM 5.0. Hit <ENTER> to quit an installation.:

>     [machine_name]:/home/tmp

>     [===============|===============|===============|===============]

Verifying Your Installation

You can verify the installation of the WebLogic JAM Plug-in by verifying the installation of the following directories and files for the supported platforms.

The following platforms are supported for the WebLogic JAM Plug-in.

- AIX 4.3.3

- HP-UX 11.0

- Microsoft Windows NT 4.0, Windows 2000, or Windows 2000 Advanced Server

- Solaris 7

- Solaris 8

- SuSE LINUX for OS/390

  Directory | Files
  --- | ---
  <BEA_HOME>/ wlintegration2.1/ lib | jampi.jar jampi.war

Uninstalling BEA WebLogic Java Adapter for Mainframe Plug-in

The WebLogic JAM Plug-in may be removed or uninstalled in the following ways:

- For Windows:

Graphical mode

- For Unix:

Either graphical or console mode.

Note: You must use the same method to uninstall the product that you used to install it

Uninstalling in Graphics Mode

To uninstall WebLogic JAM Plug-in in graphics mode, perform the following steps:

1. On Windows platforms, choose Start—>Programs—>BEA WebLogic E-Business Platform—>BEA WebLogic JAM Plug-in 5.0—>Uninstall WebLogic JAM Plug-in.

On Unix platforms, do the following:

1. Change directories to your uninstaller directory in the WebLogic Integration root directory with the following command. The default is <BEA_HOME>/jampi/uninstaller.

>     >cd <BEA_HOME>/wlintegration2.1/uninstaller_JAMPI

2. Start the uninstallation program with the following command:

>     /usr/bea/wlintegration2.1/uninstaller_JAMPI> sh Uninstall

The following screen displays.

2. Click Uninstall to begin the uninstall process. The following screen displays.

3. When the uninstall process is complete, the following screen displays.

4. Click Exit to close the uninstallation program

Uninstalling in Console Mode

To uninstall WebLogic JAM Plug-in in console mode, perform the following steps:

1. Change directories to the uninstaller directory under the root directory with the following command. The default is /usr/bea/jampi/uninstaller.

>     > cd <BEA_HOME>/wlintegration2.1/uninstaller_JAMPI

2. Start the uninstallation program with the following command:

>     <BEA_HOME>/wlintegration2.1/uninstaller_JAMPI> sh Uninstall -i console

3. At the prompt, press ENTER to begin the uninstall.
   If you want to exit the uninstall program, type QUIT at the prompt.

Note: The single-dash bar just beneath the double-dash bar in Listing 2-1 is a progress indicator. When the single-dash bar becomes the same length as the double-dash bar, uninstallation is complete.

4. When the uninstall is complete, press ENTER to exit the program.

Copyright © 2002 BEA Systems, Inc. All rights reserved. Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.