Installation Guide

Installing Liquid Data Using Console or Silent Mode

This section provides the information you need to install BEA Liquid Data for WebLogic using either Console mode or Silent mode. It includes the following sections:

Before You Install—A reminder to make sure that all installation prerequisites are met before you install Liquid Data, including installation of WebLogic Platform 8.1 (<WL_HOME>) in the BEA home directory (<BEAHOME>) where you plan to install Liquid Data.
Using Console Mode to Install Liquid Data—Console mode is an interactive installation that can be used on a UNIX system without a graphics (windowing) workstation.
Using Silent Console Mode to Install Liquid Data—Silent mode is a non-interactive installation on a Windows or UNIX system. The installation gets the required information from a properties file that you provide.
Next Steps—Refers you to critical post-installation tasks you must complete before you begin working with Liquid Data.

Before You Install

Before you begin installing Liquid Data, make sure that all installation prerequisites are met. For installations where you install the Liquid Data server, WebLogic Platform 8.1 must be installed in the BEA Home directory in which you are going to install Liquid Data.

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

Using Console Mode to Install Liquid Data

This section summarizes the console-mode installation procedure, a set of steps that emulates the graphical installation procedure.

Note: You cannot install Liquid Data in console mode on Solaris systems running in a Japanese locale; if you are installing on a Japanese Solaris system, change your locale in the shell in which you are installing to English and then install the product. After Liquid Data is installed, you can then run it in a Japanese locale.

To install Liquid Data on a UNIX system in console mode:

Go to the directory that contains the Liquid Data installer liquiddata_810_solaris.bin file.

Start the installation by entering the following command at the prompt:

sh liquiddata_810_solaris.bin -i CONSOLE
The message Preparing to install is displayed, followed (within a couple of moments) by the message Preparing CONSOLE Mode Installation. Once preparation is complete, you are prompted to select the language in which you want the text of the installation program to be displayed, as shown in the following text: ============================================================== Choose Locale... ---------------- ->1- English CHOOSE LOCALE BY NUMBER: ==============================================================

Enter 1 or press Enter to accept the default.

The following introductory message is displayed: ============================================================== Introduction ------------ This installer will guide you through the installation of 'BEA Liquid Data'. On each step, answer the questions provided. Type "quit" at any time to exit the installer. PRESS <ENTER> TO CONTINUE: ===============================================================

Press Enter to continue.

The license agreement is displayed. Review the entire agreement. When you reach the end of the agreement, you are prompted to accept or reject the terms. DO YOU AGREE WITH THE TERMS OF THE LICENSE? (Y/N):

Enter Y if you accept the terms.

You are prompted to choose an install set, as shown in the following text: =============================================================== Choose Install Set ------------------ Please Choose the Install Set to be installed by this installer. ->1- Liquid Data Server with Samples 2- Liquid Data Server 3- Client Only ENTER THE NUMBER FOR THE INSTALL SET, OR <ENTER> TO ACCEPT THE DEFAULT :1 ===============================================================

Do one of the following:

Press Enter to select Liquid Data Server with Samples (option 1).

This option is a full installation of all Liquid Data components, plus the Liquid Data samples. Liquid Data components installed are the Liquid Data server, the Data View Builder client, and the Liquid Data samples.

Enter 2 to select the Liquid Data Server only.

This option installs the Liquid Data server and Data View Builder. (The Samples are not installed.)

Enter 3 to Select Client Only.

This option installs the Data View Builder client only. (Samples and server are not installed.)

Note: Liquid Data supports a team development system configuration wherein multiple clients can access a shared remote server. The Liquid Data Server can be accessed remotely through the Data View Builder. This makes a client-only install a useful option in scenarios where multiple users have network access to one or more shared remote servers set up with a full Liquid Data installation.

You are prompted to choose a BEA Home directory, as shown in the following text:

=============================================================== Choose BEA Home Directory ------------------------- ->1- Use Existing BEA Home 2- Create a New BEA Home Enter a number(1):
Note: The <BEAHOME> directory serves as the central support directory for all the BEA products installed on your system. For a detailed description of how this directory is used, see "BEA Home Directory" in "Preparing to Install WebLogic Server" in Installing BEA WebLogic Server. This document is available, in the WebLogic Server document set, at the following URL:

http://download.oracle.com/docs/cd/E13222_01/wls/docs81/install/instpre.html

Do one of the following:

If you selected either of the options that includes server install (option 1 or 2), you must install the software in the existing <BEAHOME> directory where you installed the WebLogic Platform 8.1. Press Enter to select Use Existing BEA Home.
If you selected the Client Only Installation option, enter 2 to select Create a New BEA Home in which to install the Data View Builder. If the target directory does not already exist, it is created. (The default is C:\bea.)

Do one of the following:

If you selected Use Existing BEA Home, you are prompted to select among the available BEA Home directories. Typically, only one <BEAHOME> is available. However, if more than one BEA Home directory is configured, multiple options are displayed, as shown in the following text:

  ->1- /home1/bea
    2- /home2/beahome
Existing BEA Home(1):

============================================================

Enter the number corresponding to a BEA Home directory that contains WebLogic Server

If you selected Create a New BEA Home (Client only installation), you are prompted to enter the appropriate path for the new BEA Home directory. Enter the absolute path.

Press Enter. A warning message may or may not be displayed.

A warning message is displayed if a previously installed copy of Liquid Data 1.1 is found, or if WebLogic Server 8.1 is not found in the specified BEA Home directory.
If no warning message is displayed, you are prompted to choose an installation directory, as shown in the following text:

============================================================

Choose Product Directory
------------------------
->1- Use Current Selection (/home1/beatoo/weblogic810/bea_ld)
  2- Modify Current Selection (/home1/beatoo/weblogic810/bea_ld)
 
Select a number or <Enter> for default(1): 
============================================================

Press Enter to install the software in the selected directory, or enter 2 if you want to use a different location. If you enter 2, you are then prompted to specify a product installation directory. Enter the absolute path for your preferred location.

One of the following occurs, depending on the type of installation selected:

If you selected the Server Only option or Client Only Installation option, the Confirm Install Set message is displayed. Go to step 12.
If you selected the Client Only Installation, the installation begins. The installation status is displayed as it progresses. When installation is complete, the Install Complete message is displayed. Press Enter to exit the installer.

A message is displayed showing the components to install and asking you to verify the install set. Verify that the information displayed reflects your selections. Press Enter to begin copying files.

The installation begins and the installation status is displayed as it progresses. Since sample data is being loaded, this may take several minutes. When the installation is complete, a "Congratulations! Install Complete..." message is displayed.

Press Enter to exit the installer.

This completes the Console Mode installation process. Be sure to read Next Steps regarding important post-installation tasks that must be completed before you begin to work with Liquid Data.

Using Silent Console Mode to Install Liquid Data

Both the Windows and UNIX versions of the installer provide a noninteractive, or silent-mode installation, which you can use if you want to install Liquid Data without needing to supply information from the keyboard during the installation process. Instead, the installer gets the required information from a properties file that you provide.

The following sections explain how to install Liquid Data using silent mode.

Notes About Silent Mode

Before launching a silent-mode installation, make sure that all installation prerequisites are met and that all the information in the properties file is correct. For example, one prerequisite for performing a full installation that includes Liquid Data server is that WebLogic Platform 8.1 must be installed in the <BEAHOME> directory in which you are going to install Liquid Data. For information about installation prerequisites, see Installation Prerequisites in Preparing to Install Liquid Data..

After the silent installer is started, it proceeds in the background and does not report exceptions. Some exceptions are ignored.

However, if a previously installed copy of Liquid Data is detected, a dialog box will appear asking if you want to override the old version.

Other exceptions cause the installer to fail. For example, if the specified BEA Home directory <BEAHOME> and the specified Liquid Data install directory (USER_INSTALL_DIR) does not exist or is incorrect, the installer fails.

On UNIX systems, the installer displays the message Installation Complete when it finishes. This message does not necessarily indicate that the installer was successful; it means only that the process has finished running.

If a fatal exception occurs during installation, no changes are made to the system.

Using Silent Mode on a Windows System

To install using silent mode on a Windows system:

Create the required installer properties file. The content of the file is described in Installer Properties File. Any legal file name can be used. For illustration purposes, the properties file is named ld_properties.txt and is located in the C:\temp directory.

Verify that the <BEAHOME>, <USER_INSTALL_DIR>, and other values specified in the properties file are correct and that all requirements have been met. See Notes About Silent Mode.

Open a command window.

Go to the directory that contains the Liquid Data installer liquiddata_810_win.exe file you downloaded from the BEA web site.

Execute the following command:

liquiddata_810_win.exe -f <drive:\path\properties_file_path>

Here, drive is the letter that identifies the drive being used and properties_file_path is the complete pathname of the Liquid Data silent installation properties file.
An example: liquiddata_810_win.exe -f c:\temp\ld_properties.txt
You are returned to the command prompt and the Liquid Data installation preparation dialog box is briefly displayed. The installation proceeds in the background with the information specified in the installer properties file.

Note: To verify that the installer is running, open the Windows Task Manager. The installer is listed as the javaw.exe process.

Using Silent Mode on a UNIX System

To install Liquid Data using silent mode on a UNIX system:

Create the required installer properties file. The content of the file is described in Installer Properties File.

Verify that the values specified in the properties file are correct and that all requirements have been met. See Notes About Silent Mode.

Open a command window.

Go to the directory that contains the Liquid Data installer liquiddata_810_solaris.bin file you downloaded from the BEA web site.

Execute the following command at a command line prompt:

sh liquiddata_810_solaris.bin -f complete_properties_file_path

Where complete_properties_file_path is the complete pathname of the properties file. A complete path is required, even if the file resides in the same directory as the liquiddata_810_solaris.bin file.
The message Preparing to Install is displayed. After the installer decompresses the required files, the installation proceeds with the information specified in the installer properties file. When the process is complete, the message Installation Complete is displayed.

Installer Properties File

The required properties are summarized in the following table.

Table 3-1 Installer Properties

Sample Property Setting	Description
`INSTALLER_UI=silent`	Mode of installation. Set to `silent` for silent mode.
`USER_LOCALE=en`	Language selection for installer. Set to `en` for English.
`BEAHOME=d:\\bea` `BEAHOME=/bea`	BEA Home directory. The specified directory must exist on the system. For full installation options that include Liquid Data server, WebLogic Platform version 8.1 must be installed in the specified `<BEAHOME>` directory. For Windows, specify the absolute path, including the drive. Backslashes must be escaped. For UNIX, specify the absolute path.
`USER_INSTALL_DIR=D:\\bea\\weblogic810\\liquiddata` USER_INSTALL_DIR=/bea/weblogic810/liquiddata	Product installation directory. For Windows, specify the absolute path, including the drive. Backslashes must be escaped. For UNIX, specify the absolute path.
`CHOSEN_INSTALL_SET=FULL`	Type of installation. Specify: FULL. Installs Liquid Data server, Data View Builder client, and samples Server. Installs Liquid Data server and Data View Builder client. No Samples are installed. Client. Data View Builder client only installation. No server or Samples are installed.

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: