Installing WebLogic Integration

Installing WebLogic Integration Using Console-Mode Installation

The following sections describe how to install WebLogic Integration using console-mode installation:

Before You Start

Before you start installing WebLogic Integration, please review the following information:

Make sure that the hardware/software configuration on which you plan to install the product is supported by WebLogic Integration 8.5. A complete list of supported configurations can be found at BEA Supported Configurations at the following URL:

http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/index.html

If you plan to install the TIBCO Rendezvous Control and Event Generator subcomponent of WebLogic Integration 8.5, you must install and configure TIBCO Rendezvous on your machine before you install WebLogic Integration 8.5.

Information about obtaining and installing a licensed copy of TIBCO Rendezvous is available at the following URL:
http://www.tibco.com
By simply following the installation instructions provided by TIBCO for this product, you can install TIBCO Rendezvous correctly so that it is ready to be used later with WebLogic Integration. For information about using the TIBCO Rendezvous Control and Event Generator, see the TIBCO Rendezvous Control and Event Generator User Guide at the following URL:
http://download.oracle.com/docs/cd/E13214_01/wli/docs85/tibcorv/index.html

Read Preparing to Install WebLogic Integration, specifically, the following sections:

Installation Prerequisites
Choosing a Type of Installation
Selecting Directories for the WebLogic Integration Installation

Note: If you are installing WebLogic Integration on an operating system other than Windows, Solaris, Linux, or HP-UX, you may need to follow special installation instructions. Before launching the installation program, check for special installation instructions for your operating system in Supported Configurations for WebLogic Integration 8.5 at the following URL:

http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/configs85/85_over/overview.html

Note: You cannot reinstall WebLogic Integration or WebLogic Platform components on top of a previously installed version of the same component. You can, however, add components to an existing installation. For example, you can install WebLogic Integration during one installation, and WebLogic Portal during a separate installation. However, to reinstall the same version of one of the product components, you must first uninstall the component, as described in Uninstalling WebLogic Integration. Alternatively, you can install the new version in another location.

Note: If you are adding components to an existing installation of WebLogic Integration 8.5 or WebLogic Platform 8.1, you should shut down any running servers before starting the installation.

Starting Console-Mode Installation on Windows Systems

Note: If you are installing WebLogic Integration on a Windows system that supports more than one monitor, you must disable all but one monitor before starting the installation program.

To start the installation in console mode on a Windows system:

Open an MS-DOS command prompt window.

If you are installing WebLogic Integration from CD-ROM, go to step 4. If you are installing WebLogic Integration from a Web download, complete the following procedure:

Download the software as described in WebLogic Integration Distribution Methods.

Go to the directory in which you downloaded the installation program.

Launch the installation by entering one of the following commands:

net_platformXXX_win32.exe -mode=console (net installer)
platformXXX_win32.exe -mode=console (WebLogic Integration 8.5 package installer)
In these filenames, XXX represents the version number of the software you are installing. For example, platform814_wli85_win32.exe.

Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:

The installation program begins to install WebLogic Integration 8.5 and WebLogic Platform 8.1 components.

Proceed to Running Console-Mode Installation.

If installing WebLogic Integration from CD-ROM:

Insert the WebLogic Integration CD-ROM into the CD-ROM drive.

Open an MS-DOS command prompt window.

Go to the CD-ROM directory and navigate to the folder for the installation program for your platform.

Invoke the installation procedure by entering the following command:

platformXXX_win32.exe -mode=console (package installer)
In this filename, XXX represents the version number of the software you are installing.

Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:

Proceed to Running Console-Mode Installation.

Starting Console-Mode Installation on UNIX Systems

The WebLogic Integration installation program requires a Java run-time environment (JRE) to run. A JRE is bundled in the Windows installation program, and in some UNIX installation programs (those with filenames ending in .bin). For other UNIX platforms, the WebLogic Integration installation program does not include the JRE. Filenames for these installation programs end in .jar. To run the .jar installation programs, you must have an appropriate version of a Java 2 SDK installed on your system, and include the bin directory of the Java 2 SDK at the front of the PATH system variable.

Note: It is important that you use an SDK because the installation process sets the JAVA_HOME and related variables to point to this directory. All scripts installed with WebLogic Integration use this SDK by default, including scripts to start sample applications, the Configuration Wizard, and other WebLogic development tools.

Starting Console-Mode Installation for .bin Installation Files

If you have an installation program for UNIX platforms with a filename that ends in .bin, complete the following steps to start the installation in console mode:

If you are installing WebLogic Integration from CD-ROM, go to step 3. If you are installing WebLogic Integration from a Web download, complete the following procedure:

Download the software as described in Web Distribution.

Go to the directory where you downloaded the installation program.

Launch the installation by entering the following commands:

chmod a+x filename.bin ./filename.bin -mode=console
Here filename.bin is the name of the WebLogic Integration installation program specific to your platform.
Filenames for the net installer are preceded by net_, for example, net_platformXXX_solaris.bin, where XXX represents the version number of the software you are installing.

Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:

Proceed to Running Console-Mode Installation.

If you are installing WebLogic Integration from CD-ROM:

Insert the WebLogic Integration CD-ROM into the CD-ROM drive.

Go to the CD-ROM directory and navigate to the folder for the installation program for your platform.

Launch the installation procedure by entering the following commands:

chmod a+x filename.bin
./filename.bin -mode=console
Here, filename.bin is the name of the WebLogic Integration installation program specific to your platform, for example platformXXX_solaris.bin, where XXX represents the version number of the software you are installing.

Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:

./platformXXX_solaris.bin -mode=console -log=/home/logs/platform_install.log
For more information, see Generating a Verbose Installation Log.

Proceed to Running Console-Mode Installation.

Starting Console-Mode Installation for .jar Installation Files

Note: If you are installing WebLogic Integration on an operating system other than Windows, Solaris, Linux, or HP-UX, you may need to follow special installation instructions. Before launching the installation program, check for installation instructions for your operating system in Supported Configurations for WebLogic Integration 8.5 at the following URL:

http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/configs85/85_over/overview.html

If you have an installation program for UNIX platforms with a filename that ends in .jar, follow these steps to start the installation in console mode:

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

PATH=JAVA_HOME/bin:$PATH export PATH
Here JAVA_HOME represents the full path to the SDK directory.

Do one of the following:

Download the software as described in Web Distribution.
If you are installing from CD-ROM, insert the WebLogic Integration CD-ROM into the CD-ROM drive and go to the CD-ROM directory.

Note: To ensure that the hardware/software configuration on which you are installing the product is supported by WebLogic Integration, see BEA Supported Configurations at the following URL:

http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/index.html

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

java -jar filename.jar -mode=console
Here, filename.jar is the name of the WebLogic Integration installation file, for example pj_platformXXX_generic.jar. Filenames for the net installer are preceded by net_, for example, net_pj_platformXXX_generic.jar. In these filenames, XXX represents the version number of the software you are installing.

Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:

java -jar pj_platformXXX_generic.jar -mode=console -log=/home/logs/platform_install.log
For more information, see Generating a Verbose Installation Log.

Proceed to Running Console-Mode Installation.

Running 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\weblogic81. When entering pathnames on a UNIX system, use the UNIX convention (forward slashes) in pathnames, for example, /home1/bea/weblogic81.

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. For details about the BEA Home directory, see Choosing a BEA Home Directory.

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
    ¦Install the complete BEA WebLogic Platform.
 
   2¦Custom Installation
    ¦Choose software components to install and perform optional
     configuration.
 
Enter index number to select OR [Exit][Previous][Next]>

Do one of the following:

Type 1 or press Enter to choose a complete installation.

If you are using the net installer (filename preceded by net_), the Specify Download Options prompt is displayed. Go to step 6.
If you are installing from CD-ROM or using the package installer, the Choose Product Directory prompt is displayed. Go to step 7.

Type 2 to choose a custom installation. The Choose Components prompt is displayed.

For more information about typical and custom installations, see Choosing a Type of Installation.

Select the components you want to install. The available components are displayed as follows:

Choose Components to install:
-----------------------------
 
    Release 8.5.x.0
    +----WebLogic Server [1] v
    ¦    +----Server [1.1] v
    ¦    +----Server Examples [1.2] v
    +----WebLogic Workshop [2] v
    ¦    +----Workshop Runtime Framework [2.1] v
    ¦    +----WebLogic Workshop Application Developer Edition [2.2] v
    ¦    +----Workshop Samples [2.3] v
    +----WebLogic Integration [3] v
    ¦    +----Integration Server [3.1] v
    ¦    +----WebLogic Workshop Integration Extension [3.2] v
    ¦    +----Integration Examples [3.3] v
    ¦    +----BPEL Import and Export Tools [3.4] v
    ¦    +----TIBCO Rendezvous(TM) Control and Event Generator [3.5] v
    +----WebLogic Portal [4] v
    ¦    +----Portal Server [4.1] v
    ¦    +----WebLogic Workshop Portal Extension [4.2] v
    ¦    +----Portal Examples [4.3] v
    +----Platform Samples and Utilities [5] v
         +----Platform Tour [5.1] v

 
Enter number exactly as it appears in brackets to toggle selection OR
[Exit][Previous][Next]>

Selected components are installed by default, as indicated by a symbol at the end of each line: an x on UNIX systems or check mark on Windows systems. If a component, such as the BPEL Import and Export Tools, is not selected, then it will not be installed on your system. To select a component to be installed, type the numeric code for the component on the command line. To deselect a component, type the numeric code for the component on the command line exactly as it appears within the brackets. For example, if you do not want to install the Server Examples for WebLogic Server, type 1.2 on the command line.

Note: The word Installed is shown in brackets for any components you have already installed on your system.
When you are finished selecting components, press Enter or type next (or n for short). You are prompted to confirm your selection. On the command line, type 1 or press Enter to accept your selection. Otherwise, type 2 to return to the Choose Components panel where you can modify your selections.

Note: When you select or deselect components to install, the installation program checks for dependencies between components and automatically modifies the list of selected components. For example, if you deselect the WebLogic Server component, the remaining components are also deselected, since they require the WebLogic Server to run.
If you are using the package installer, the Choose Product Directory prompt is displayed. Go to step 7.
If you are using the net installer (installation program filenames beginning with net_), the Specify Download Options prompt is displayed.

Indicate your preferences for downloading the software. The installation program prompts you to select one of the following options:

SPECIFY DOWNLOAD OPTIONS
 
1- Modify Storage directory (c:\tmp)
2- Modify Remove download files after installation (No)
3- Modify Proxy Host (none)
4- Modify Proxy Port (none)
5- Modify Username (none)
6- Modify Password (none)
 
Enter a number or [Exit][Previous][Next]>

Note: If you have previously installed WebLogic Integration and specified a storage directory during the installation process, the full pathname for that directory is displayed as the default. If you have not specified a storage directory, the installer specifies the system's temporary directory as the default. Make sure that your temporary directory has sufficient space to accommodate the archive files and the installation program. For more information about temporary space required by the installation program, see Temporary Disk Space Requirements.

Note also that the SPECIFY DOWNLOAD OPTIONS menu is displayed only in the following circumstances:

—You are using the net installer for the first time.

—The previous time you ran the net installer, you set the Modify Remove download files after installation option to Yes, and you ran the installer to completion.

To accept the defaults, type next (or n for short) or press Enter. If you have not specified a download storage directory in a previous installation and you want to save the files to be downloaded, you need to specify a directory before you can proceed with the installation.
To modify any of the options, do the following:

Type 1 to specify a storage directory to which you want to download the software components. When prompted, type the full pathname for the desired directory. If the directory does not exist, the installation program creates it for you.
Type 2 if you want the downloaded files deleted after the installation is complete. If you do so, the download options are displayed again, and the Modify Remove download files after installation option is set to Yes. If you accept the default for this option (No), the downloaded files are saved in the storage directory you specified.
Indicate whether you want to use an HTTP Proxy server for the download by providing values for the Modify Host and Modify Port options as follows:

Type 3 to specify a host. At the prompt, enter the name or IP address of the proxy server.
Type 4 to specify a port. At the prompt, enter the port number of the proxy server.

Specify the username and password required by the HTTP Proxy server, if required, as follows:

Type 5 to specify a username. At the prompt, enter a valid username for the proxy server.
Type 6 to specify a password. At the prompt, enter a valid password for the user.

For additional information about downloading the software, see Web Distribution.
After you indicate your preferences, the files begin downloading to the specified storage directory. When the download is complete, the installation program verifies that the component archive files downloaded successfully. If the installation program cannot verify the integrity of the download, the following message is displayed: The required installation files could not be verified.You may download them from BEA or select different components.
When the verification is complete, the Choose Product Directory prompt is displayed.

Specify the directory in which you want to install the WebLogic Integration software. Select the default product directory (bea_home\weblogic81_wli85) or specify 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\weblogic81_wli85] 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 Integration 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\weblogic81_wli85] 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.

If you are installing on a Windows platform, you have not previously installed a Node Manager as a Windows service, and you are performing a custom installation, the Install Node Manager as a Windows Service panel is displayed. The Node Manager is used to monitor, start, and stop the managed servers in a domain.

The following text is displayed: Install Node Manager as a Windows Service ->1 - Yes, install now. 2 - No, do not install now. See product documentation for post-install registration of Node Manager as a Windows Service. Enter a number or [Exit][Previous][Next]>
Enter 1 or press Enter to install the Node Manager as a Windows Service. See Installing the Node Manager as a Windows Service for more information. Enter 2 if you do not want to install the Node Manager as a Windows service.
At this point, the installation program installs the files to the directory you specified.

Note: It is normal for the installation program to pause for a fairly long time, especially toward the end. The installation program is still working when this occurs.

Press Enter or type Exit to exit the installation program.

What's Next?

You can start using the product immediately after installing it for the first time because, by default, WebLogic Integration uses the development license that is installed in BEA Home directory. We recommend that you use the QuickStart application to familiarize yourself with the software, take the WebLogic Platform 8.1 Tour (if you installed the complete set of WebLogic Platform components), and execute the samples provided. For additional information, see Performing Post-Installation Tasks.

Note: QuickStart is not invoked automatically for console or silent-mode installations. You can launch QuickStart from the Start Menu (Windows), or from the command line (Windows and UNIX.) For instructions, see Using QuickStart.

For specific information about WebLogic Integration 8.5 and WebLogic Platform 8.1 components, see the appropriate release notes:

BEA WebLogic Integration Release Notes for Version 8.5 at the following URL:

http://download.oracle.com/docs/cd/E13214_01/wli/docs85/relnotes/index.html

BEA WebLogic Platform Release Notes for Version 8.1 at the following URL:

http://download.oracle.com/docs/cd/E13196_01/platform/docs81/relnotes/index.html

BEA WebLogic Server and WebLogic Express Release Notes for Version 8.1 at the following URL:

http://download.oracle.com/docs/cd/E13222_01/wls/docs81/notes/index.html