Installation Guide

Installation

This chapter explains the necessary procedures to successfully install the WebLogic Personal Messaging API on the various supported platforms.

For standard installation procedures, refer to the following sections:

Installation Prerequisites

The WebLogic Personal Messaging API installation program does not install a Java 2 SDK. The filenames for this installation program ends in .jar. To run the .jar installation programs, you must have the appropriate version of the Java 2 SDK installed on your system, and include the bin directory of the SDK at the beginning of the PATH variable definition. It is important that you use an Java SDK because the installation process sets the JDK_HOME and related variables to point to this directory.

Licensing

The evaluation license is available for download from the BEA Download Center. Instructions for installing a license with WebLogic Personal Messaging API support are provided in Licensing.

For more information about WebLogic Personal Messaging API, see the WebLogic Personal Messaging API documentation at the following URL:

http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/compoze/index.html

Installation Methods

The BEA installation program supports the following methods for installing the WebLogic Personal Messaging API software:

Graphical mode

Graphical-mode installation is an interactive, GUI-based method for installing WebLogic Personal Messaging API. It can be run on both Windows and UNIX systems. For installation procedures, see Installing Using Graphical-Mode Installation.
Note: If you want to run graphical-mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX systems do. If you attempt to start the installation program in graphical mode on a system that cannot support a graphical display, the installation program automatically starts console-mode installation.

Console mode

Console-mode installation is an interactive, text-based method for installing WebLogic Personal Messaging API, from the command line, on either a UNIX system or a Windows system. For instructions for using this method, see Installing Using Console-Mode Installation.

Installing Using Graphical-Mode Installation

Perform the following steps to install the WebLogic Personal Messaging API using the Graphical-Mode installation.

Start Graphical-Mode Installation

Download the software from the BEA Web site at http://commerce.bea.com.

Uncompress and extract the contents of the wl_personal_messaging_api-XX.zip file into a temporary directory. You will extract the following files:

The personal_messaging_api-XX.jar file
The readme.html file

Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

java -jar personal_messaging_api-XX.jar

Here, personal_messaging_api-XX.jar is the name of the WebLogic Personal Messaging API installation file. In this filename, XX represents the version number of the software you are installing.

Note: To ensure that the hardware/software configuration on which you are installing the product is supported by WebLogic Personal Messaging API, see the Supported Configurations Guide.

Proceed to Running the Installation Program.

Running the Installation Program

The installation program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see Table 1-1.

Table 1-1 Console Installation Prompts

In this window	Perform the following action
Welcome	Click Next to proceed with the installation. You may cancel the installation at any time by clicking Exit.
BEA License Agreement	Read the BEA Software License Agreement and indicate your acceptance of the terms of the agreement by selecting Yes. To continue with the installation, you must accept the terms of the license agreement and then click Next.
Choose BEA Home Directory	Specify the BEA Home directory that will serve as the central support directory for all BEA products installed on the target system. If you already have a BEA Home directory on your system, you can select that directory (recommended) or create a new BEA Home directory. If you choose to create a new directory, the WebLogic Personal Messaging API installation program automatically creates the directory for you. The files in the BEA Home directory are essential to ensuring that BEA software operates correctly on your system such as ensuring that licensing works correctly for the installed BEA products.
Choose Install Type	Select the option button for the type of installation you want to perform: Complete-all the software components provided with WebLogic Personal Messaging API, including sample files, are installed on your system. Custom-you select software components to be installed.
Choose Components	Note: This window is displayed only if you selected Custom installation in the Choose Install Type window. Specify the components to be installed by selecting or clearing the appropriate check boxes. This window displays a tree-view of all the components available for installation. In an initial installation, all components are selected.
Choose Product Directory	Specify the directory in which you want to install the WebLogic Personal Messaging API software and click `Next`. You can accept the default product directory (`wlpmapi43`) or create a new product directory. If you choose to create a new directory, the installation program automatically creates the directory for you.
Choose JDK_HOME Directory	Provide the directory where your JDK is installed.
Choose Shortcut Location	Specify the location for the shortcuts to BEA product components, samples and tools.
Status	Read the information displayed about BEA products and services.
Installation Complete	Click Done to exit the installation program.

Installing Using Console-Mode Installation

Perform the following steps to install the WebLogic Personal Messaging API using the Console-Mode Installation.You can install on either Windows or Unix.

Start Console-Mode Installation on Windows

Download the software from the BEA Web site at http://commerce.bea.com.

Uncompress and extract the contents of the wl_personal_messaging_api_XX.zip file into a temporary directory. You will extract the following files:

The personal_messaging_api-XX.jar file
The readme.html file

Open an MS-DOS command prompt window.

Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

java -jar personal_messaging_api-XX.jar -mode=console

Here, personal_messaging_api-XX.jar is the name of the WebLogic Personal Messaging API installation file. In this filename, XX represents the version number of the software you are installing.

Note: To ensure that the hardware/software configuration on which you are installing the product is supported by WebLogic Personal Messaging API, see the Supported Configurations Guide.

Proceed to Running the Console-Mode Installation.

Start Console-Mode Installation on UNIX

Download the software from the BEA Web site at http://commerce.bea.com.

Uncompress and extract the contents of the product zip bundle into a temporary directory. You will extract the following files:

The personal_messaging_api-XX.jar file
The readme.html file

Open a shell window.

Add the bin directory of the appropriate SDK to the beginning of the PATH variable definition on the target system. For example:

PATH=JDK_HOME/bin:$PATH
export PATH
JDK_HOME represents the full path to the Java SDK directory.

Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

java -jar personal_messaging_api-XX.jar -mode=console

Here, personal_messaging_api-XX.jar is the name of the WebLogic Personal Messaging API installation file. In this filename, XX represents the version number of the software you are installing.

Note: To ensure that the hardware/software configuration on which you are installing the product is supported by WebLogic Personal Messaging API, see the Supported Configurations Guide.

Proceed to Running the Console-Mode Installation.

Running the Console-Mode Installation

To complete the console-mode installation process, respond to the prompts in each section by entering the number associated with your choice or by pressing Enter to accept the default. To exit the installation process, enter exit (or x, for short) in response to any prompt. To review or change your selection, enter previous (or p, for short) at the prompt. To proceed to the following window, enter next (or n, for short).

Note: The sample console text and directory pathnames in this section use Windows conventions (backslashes) for pathnames, for example C:\bea\wlpmapi43. When entering pathnames on a UNIX system, use the UNIX convention (forward slashes) in pathnames, for example, /home1/bea/wlpmapi43.

The following procedure steps you through the installation program. Use this procedure after you have started the installation program in console mode as described in the previous sections.

At the Welcome prompt, type next (or n for short) or press Enter to continue with the installation process.

The BEA Systems License Agreement prompt is displayed.

Read the Agreement and indicate your acceptance or rejection of its terms by doing one of the following at the prompt:

Type 1 to indicate your agreement with the terms of the license and proceed with the installation. To review the entire agreement, press Enter or type Down several times. Type Up to scroll back through sections previously displayed.
Type 2 if you do not agree with the terms of the license. If you type 2, the installation process terminates.

The Choose BEA Home directory prompt is displayed.

Specify the BEA Home directory that will serve as the central support directory for all BEA products installed on the target system.

The installation program displays the following prompt:
Choose BEA Home Directory:
--------------------------
*BEA home choice

1¦Create a new BEA Home [C:\bea]
->2¦Use an existing BEA Home [D:\beahome1]

Enter index number to select OR [Exit][Previous][Next]>

Note: Instead of typing complete words when you want to enter [Exit], [Previous], and [Next], you can use the following one-letter shortcuts: x, p, and n, respectively.

Do one of the following:

To use an existing BEA Home directory, type 2 or next (or n for short), or press Enter. If you have more than one BEA Home directory on your system, an additional prompt will display the directories. Type the number associated with the desired BEA Home directory.
To create a new BEA Home directory, type 1, then at the prompt, enter the full path of the BEA Home directory, for example C:\beahome2. If you specify a directory that does not exist, the installation program creates it for you.

Whether you accept the existing BEA Home directory or choose to create a new BEA Home directory, you are prompted to confirm your selection, as shown in the following sample:

Choose BEA Home Directory:
--------------------------

*BEA home choice

->1¦Yes, Use this BEA home directory [C:\bea]
2¦No, return to BEA home directory selection

Enter index number to select OR [Exit][Previous][Next]>

On the command line, type 1 or press Enter to accept your selection. Otherwise, type 2 to return to the Choose BEA Home Directory panel where you can modify your entry.

After you have selected your BEA Home directory and confirmed your selection, the Choose Install Type prompt is displayed.

Specify the type of installation you want to perform by entering the number associated with the install type, as shown in the following text:

Choose Install Type:
--------------------

->1¦Complete

2¦Custom Installation

Do one of the following:

Type 1 or press Enter to choose a complete installation.
Type 2 to choose a custom installation. The Choose Components prompt is displayed.

Specify the directory in which you want to install the WebLogic Personal Messaging API software. Select the default product directory (BEA_HOME\wlpmapi43) or create a new product directory.

If you specify a new directory, the installation program automatically creates it for you.
The choices displayed in this section are as follows:
Choose Product Directory:
-------------------------
Product Installation Directory= [C:\bea\wlpmapi43]
Input new Product Installation Directory OR [Exit][Previous][Next]>

Do one of the following:

Press Enter or type next (or n for short) to accept the current selection.
Enter the full path to the directory in which you want to install the WebLogic Personal Messaging API software and press Enter.

You are prompted to confirm your selection as shown in the following text:

Choose Product Directory:
-------------------------
->1| Yes, use this product directory [C:\bea\wlpmapi43]
2| No, select another product directory
Enter index number to select OR [Exit][Previous][Next]>\
Verify that your entry is correct, then type 1 or press Enter to proceed with the installation. Otherwise, type 2 to return to the Choose Product Directory panel where you can modify your entry.

Specify the JDK_HOME directory where your Java SDK is installed.

Specify the location for the shortcuts to BEA product components, samples and tools.

Press Enter or type Exit to exit the installation program.

Installing Manually

Perform the following steps to install the WebLogic Personal Messaging API manually.

Obtain the noinstall (generic) version of the WebLogic Personal Messaging API (wl_personal_messaging_api-noinstall-XX.zip).

Uncompress and extract the contents of the zip bundle into a directory. This is the %BEA_HOME% directory. The directory wlpmapi under %BEA_HOME% is %BEA_WLPMAPI_HOME%.

For Windows, edit the .bat files found in the %BEA_WLPMAPI_HOME%\scripts directory and replace the variables with the appropriate values, as shown in Table 1-2.

For Unix, edit the .sh files found in the %BEA_WLPMAPI_HOME%\scripts directory and replace the variables with the appropriate values, as shown in Table 1-2.

Table 1-2 Variables and Values

Variable	Value
`%%PRODUCT_INSTALL_DIR%%`	Product install directory (for example, `%BEA_WLPMAPI_HOME%`). For example: `d:\bea\wlpmapi43`.
`%%JDK_HOME%%`	The JDK directory. For example, d:\`jdk1.4.2_09`.