Installation Guide
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:
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.
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
The BEA installation program supports the following methods for installing the WebLogic Personal Messaging API software:
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 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.
Perform the following steps to install the WebLogic Personal Messaging API using the Graphical-Mode installation.
wl_personal_messaging_api-
XX
.zip
file into a temporary directory. You will extract the following files: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.
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.
Perform the following steps to install the WebLogic Personal Messaging API using the Console-Mode Installation.You can install on either Windows or Unix.
wl_personal_messaging_api_
XX
.zip
file into a temporary directory. You will extract the following files: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.
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.
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.
Welcome
prompt, type next
(or n
for short) or press Enter
to continue with the installation process. 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. 2
if you do not agree with the terms of the license. If you type 2
, the installation process terminates. 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.
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. 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. 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. Choose Install Type
prompt is displayed. 1
or press Enter
to choose a complete installation. 2
to choose a custom installation. The Choose Components
prompt is displayed. 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:
Product Installation Directory= [C:\bea\wlpmapi43]
Input new Product Installation Directory OR [Exit][Previous][Next]>
Enter
or type next
(or n
for short) to accept the current selection. Enter
. ->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.
wl_personal_messaging_api-noinstall-
XX
.zip
).%BEA_HOME%
directory. The directory wlpmapi
under %BEA_HOME%
is %BEA_WLPMAPI_HOME%
..bat
files found in the %BEA_WLPMAPI_HOME%\scripts
directory and replace the variables with the appropriate values, as shown in Table 1-2..sh
files found in the %BEA_WLPMAPI_HOME%\scripts
directory and replace the variables with the appropriate values, as shown in Table 1-2.