Installation Guide

Installing Liquid Data Using GUI Mode

This topic describes how to install BEA Liquid Data for WebLogic using GUI mode. It includes the following sections:

Before You Install

Note: If you are upgrading from Liquid Data 1.0 or Liquid Data 1.1 to 8.1, review the Migration Guide prior to installing Liquid Data 8.1.

Before you begin installing Liquid Data, make sure that all installation prerequisites are met. These include:

Having WebLogic Platform 8.1 installed in the <BEAHOME> directory in which you are going to install Liquid Data (unless you are using Liquid Data client installation only.
Making sure that no current or previous versions of the Liquid Data server are running.
Removing Liquid Data if it is located in the same <BEAHOME> directory. See Uninstalling Liquid Data for details.

In addition, it is recommended for Windows (and a requirement for UNIX) that an entry for the JDK141_03 bin directory (for example <BEA_HOME>/JDK141_03/bin) be included in your PATH environment variable setting before any other JDK bin directories.

For complete information about installation prerequisites, see Installation Prerequisites in Preparing to Install Liquid Data.

Starting the Installer on a Windows Platform

To start the installer in GUI mode on a Windows platform, use a Windows Explorer file browser to navigate to the folder in which you downloaded the Liquid Data installer, and double-click on the installer executable file.

For example, the installer file for BEA Liquid Data for WebLogic 8.1 is:

liquiddata_810 _win.exe.

Starting the Installer on a UNIX Platform

To run the installer in GUI mode, make sure that the console attached to the machine on which you are installing the software supports a Java-based GUI.

To start the installer in GUI mode on a UNIX platform, do the following:

Open a command window, and change directories (cd) in which you downloaded the Liquid Data installer file.

Start the installer in a new shell by entering the following

For example, to run the installer for the Solaris version of Liquid Data 8.1 enter the following command at the prompt: sh filename.bin
where filename.bin is the name of the Liquid Data installation program specific to your platform; for example, liquiddata_810_solaris.bin for the Solaris version of Liquid Data 8.1.
You will find similarly-named installer files for all UNIX versions of Liquid Data (Solaris, HPUX).

Installing Liquid Data in GUI Mode

After you start the installer as described in Starting the Installer on a Windows Platform or Starting the Installer on a UNIX Platform, perform the following procedure to complete the installation:

The initial Liquid Data installation dialog box is displayed as an introduction.

Figure 2-1 Liquid Data Installation Introduction

Liquid Data Installation Introduction

English is currently the only supported language. Click OK. After clicking Next on the initial installation options screen, you will see the License Agreement.

Figure 2-2 License Agreement

License Agreement

Review the License Agreement, using the scroll bar to display the text. Select the Yes option if you accept. Then click Next.

The Choose Install Set dialog box is displayed. Figure 2-3 Choose Install Set

Select one of the following options:

Full Installation with Samples

This option installs all the Liquid Data components, plus the Liquid Data Samples domain, including the Retail Sample Application. Major Liquid Data components installed include the Liquid Data server, the Data View Builder client, the Administration Console and the Liquid Data control for WebLogic Workshop.

Installation without Samples

This option installs all the Liquid Data components except the Samples domain.

Client Only Installation

This option installs the Data View Builder client and Liquid Data control for WebLogic Workshop only. (Samples, WebLogic server, and console are not installed.)

Click Next.

The Choose BEA Home Directory dialog box is displayed. Figure 2-4 Choose BEA Home Directory
The BEA Home (<BEAHOME>) directory serves as the central support directory for all the BEA products installed on your system. For a detailed description of how the <BEAHOME> directory is used, see "BEA Home Directory" in "Preparing to Install WebLogic Server" in Installing WebLogic Server. This document is available, in the BEA WebLogic Server document set, at the following URL:
http://download.oracle.com/docs/cd/E13222_01/wls/docs81/installinstpre.html

Specify the <BEAHOME> directory as follows:

If you selected one of the options that includes the Liquid Data server, verify that the Use Existing BEA Home option is selected. Then select the existing <BEAHOME> that contains WebLogic Server.

Note: If you are installing one of the options that includes Liquid Data server, you must install into the same directory where you installed the WebLogic Platform 8.1

If you selected the Client Only Installation option, create a new <BEAHOME> in which to install the Data View Builder. (The default is C:\bea.)

Click Next.

A warning message is displayed under two conditions:

If a previously installed copy of Liquid Data 8.1 is found. In such a case you will be asked if you want to override the previous version. (Alternatively, you can uninstall Liquid Data prior to the installation.)
If WebLogic Platform 8.1 is not found in the specified <BEAHOME> directory. If this occurs, you need to exit the Liquid Data installation and install WebLogic Platform 8.1 before proceeding with the Liquid Data installation.

If the prerequisite software (WebLogic Platform 8.1) is present, the "Confirm Install Set Selection" dialog is displayed. The dialog shows the install set you chose. Figure 2-5 Confirm Install Set

Verify that the information displayed reflects your selections (Liquid Data Server and Sample, Liquid Data Server, or Client Only). Click Install to begin copying files.
Additional information about Liquid Data is displayed as the installer copies files. When the installer finishes copying the required files, the "Congratulations-Install Complete" dialog box is displayed.

Click Done to dismiss the Install Complete dialog box.

Next Steps

For all types of installations, you must complete some post-installation tasks before you can work with Liquid Data. See Post-Installation Tasks, for information on the following important post-install steps: