Installation Guide

Installation

BEA WebLogic Personal Messaging API can be installed manually or with an installer. This chapter explains the necessary procedures to successfully install this product on the various supported platforms:

This chapter contains the following sections:

Installing on Windows

You can install on Windows with the Graphical Installer or manually.

This section contains the following topics:

Using the Graphical Installer

Perform the following steps to install the BEA WebLogic Personal Messaging API on Windows with the Graphical Installer:

Obtain the Windows install version of the BEA WebLogic Personal Messaging API (personal_messaging_api-win-42.zip).

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

The setup.exe file
The readme.html file

Start the installer by double-clicking the setup.exe file. The installer screen opens and begins preparing the installation.

Read through the introduction, and click Next. You will be able to exit the installation at anytime by clicking Cancel. You will also be able to go back a screen by clicking Previous when available.

Read through the license agreement, and select an option:

Select I accept the terms of the License Agreement to continue with the installation.
Select I do not accept the terms of the License Agreement to terminate the installation.

Click Next.

Select the directory where BEA WebLogic Personal Messaging API will be installed. You may change the default location by entering in the directory or by clicking Choose and selecting a different directory. This directory will be known as %COMPOZE_HOME%.

Click Next.

Review the Pre-Installation summary for correctness, then click Install on the installation screen.

When installation is complete, your default web browser opens the Start Here! page, which provides links to the included documentation.

Place the license.bea file in the license folder as follows:

%COMPOZE_HOME%\license\license.bea

Note: If a problem occurs during the installation, hold down the control key while starting the installer until a console appears. You will see some output that explains the problem in more detail. If you are still having problems with the installer, send this output along with a description of the problem to support.

Performing a Manual Installation

Perform the following steps to manually install the BEA WebLogic Personal Messaging API on Windows:

Obtain the noinstall (generic) version of the BEA WebLogic Personal Messaging API (personal_messaging_api-noinstall-42.zip).

Uncompress and extract the contents of the zip bundle into a directory. This is the %COMPOZE_HOME% directory. The directory collab-4.2 under %COMPOZE_HOME% is %COMPOZE_COLLAB_HOME%.

Edit the .bat files found in the %COMPOZE_COLLAB_HOME%\scripts directory and replace the variables with the appropriate values, as shown in Table1-1.

Table 1-1 Variables and Values

Variable	Value
`%%PRODUCT_INSTALL_DIR%%`	Product install directory (for example, `%COMPOZE_COLLAB_HOME%`). For example: `c:\compoze\collab-4.2`.
`%%COMPOZE_INSTALL_DIR%%`	Product install directory (for example, `%COMPOZE_HOME%`). For example: `c:\compoze`.
`%%JDK_HOME%%`	The JDK directory. For example, `c:\jdk1.3.1_03`.

Place the license.bea file in the license folder as follows:

%COMPOZE_HOME%\license\license.bea

Installing on UNIX

You can install on UNIX with the Graphical Installer or manually.

This sections contains the following topics:

Using the Graphical Installer

Perform the following steps to install the BEA WebLogic Personal Messaging API on UNIX with the Graphical Installer:

Obtain the UNIX install version of the BEA WebLogic Personal Messaging API (personal_messaging_api-unix-42.zip).

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

The setup.bin file
The readme.html file

Note: You may have to change execute permissions on the setup.bin file by executing chmod 777 setup.bin.

The installer screen opens and begins preparing the installation.

Read the introduction, and click Next. You will be able to exit the installation at anytime by clicking Cancel. You will also be able to go back a screen by clicking Previous when available.

Read through the license agreement, and select an option:

Select I accept the terms of the License Agreement to continue with the installation
Select I do not accept the terms of the License Agreement to terminate the installation

Click Next.

Review the Pre-Installation summary, then click Install on the installation screen.

When installation is complete, your default web browser opens the Start Here! page, which provides links to the included documentation.

Place the license.bea file in the license folder as follows:

%COMPOZE_HOME%/license/license.bea

Performing a Manual Installation

Perform the following steps to manually install the BEA WebLogic Personal Messaging API on UNIX:

Obtain the noinstall version of the BEA WebLogic Personal Messaging API (personal_messaging_api-noinstall-42.zip).

Uncompress and extract the contents of the zip bundle into a directory. This is the %COMPOZE_HOME% directory. The directory collab-4.2 under %COMPOZE_HOME% is %COMPOZE_COLLAB_HOME%.

Edit the .sh files found in %COMPOZE_COLLAB_HOME%/scripts directory and replace the variables with the appropriate values, as shown in Table1-2.

Table 1-2 Variables and Values

Variable	Value
`%%PRODUCT_INSTALL_DIR%%`	Product install directory (for example, `%COMPOZE_COLLAB_HOME%`). For example, `/compoze/collab-4.2`.
`%%COMPOZE_INSTALL_DIR%%`	Product install directory (for example,. %COMPOZE_HOME%). For example, `/compoze`.
`%%JDK_HOME%%`	The JDK directory. For example: `/usr/java1.3`.

Place the license.bea file in the license folder as follows:

%COMPOZE_HOME%/license/license.bea