Installing Liquid Data Using Console or Silent Mode

This section provides the information you need to install BEA Liquid Data for WebLogic^TM 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 version 7.0 SP2 in the BEA home directory 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 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 example, some particularly critical prerequisites are:

• In order to run the Liquid Data installer, you must have the JDK 1.3.1 or JRE 1.3.1 Java executable in your PATH before any other JDK bin directories. For example, in Windows, run the PATH command from a command window to check your PATH environment variable setting, as follows:

C:\>path
PATH=C:\bea\jdk131_06\bin;C:\WINNT\system32;C:\WINNT;

• For installations where you install the Liquid Data server, WebLogic Platform version 7.0 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:

1. Go to the directory that contains the Liquid Data installer liquiddata110_solaris.bin file that you downloaded from the BEA Web site.

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

   sh liquiddata110_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:  
   ==============================================================

3. Enter 1 or press Enter to accept the default.

   Note: If the error message "JDK 1.3 and up is required to start the installer" is displayed, enter quit to exit the installation. Add an entry for the JDK 1.3.1 bin directory, BEA_HOME/jdk131_06/bin, to the beginning of your PATH environment variable. Then restart the installer.

   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: 
   ===============================================================

4. Press Enter to continue.

   The license agreement is displayed. Because the agreement is too long to fit on the screen, only the first section is displayed now.

5. Review the part of the agreement that is currently displayed. Press Enter to display additional text. Repeat until you have reviewed 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):

6. Enter Y to 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

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

7. 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 BEA Home 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 BEA WebLogic Server document set, at the following URL:

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

8. 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 BEA Home directory where you installed the WebLogic Platform. 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.)

9. 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 BEA Home 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 7.0.

   • 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.

10. 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.0 is found, or if WebLogic Server 7.0 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/weblogic700/bea_ld)
      2- Modify Current Selection (/home1/beatoo/weblogic700/bea_ld)
     
    Select a number or <Enter> for default(1): 
    ============================================================

11. 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.

12. 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. When the installation is complete, the "Congratulations! Install Complete..." message is displayed.

13. Press Enter to exit the installer.

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

 

---

Using Silent 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 version 7.0 SP2 must be installed in the BEA Home 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. For example, if a previously installed copy of Liquid Data is detected, it is overwritten.

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:

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

   Note: An easy way to create the file is to copy the text from Listing 3-1 and then edit it as required.

2. 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.

3. Open a command window.

4. Go to the directory that contains the Liquid Data installer liquiddata110_win.exe file you downloaded from the BEA Web site.

5. Execute the following command:

   liquiddata110_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 properties file. A complete path is required, even if the file resides in the same directory as the liquiddata110_win.exe file.

   You are returned to the command prompt. The installation preparation dialog box is displayed. After the installer decompresses the required files, the dialog box is dismissed and 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:

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

   Note: An easy way to create the file is to copy the text from Listing 3-1 and then edit it as required.

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

3. Open a command window.

4. Go to the directory that contains the Liquid Data installer liquiddata110_win.exe file you downloaded from the BEA Web site.

5. Execute the following command at a command line prompt:

   sh liquiddata110_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 liquiddata110_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 7.0 SP2 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\\weblogic700\\liquiddata USER_INSTALL_DIR=/bea/weblogic700/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.

 

A sample installer properties file is shown in the following listing. (Note that specifications for settings for various databases are commented out because these are not required for Liquid Data installation.)

Listing 3-1 Sample Installer Properties File

##############################################

### Silent Installation Properties File
###############################################

# Installer must be run with -f:
# liquiddata110_win.exe -f path/installer.properties

###############################################
# All Path separators are platform specific and
# backslashes must be escaped!
###############################################

INSTALLER_UI=SILENT

###############################################
### Locale
###############################################

USER_LOCALE=en

###############################################
### BEA Home Directory
###############################################

BEAHOME=D:\\bea-ga
#BEAHOME=/bea

###############################################
### Product Installation Directory
###############################################

USER_INSTALL_DIR=D:\\bea\\weblogic700\\liquiddata
#USER_INSTALL_DIR=/bea/weblogic700/liquiddata

###############################################
### Default Install Set###
###############################################

CHOSEN_INSTALL_SET=Full
#CHOSEN_INSTALL_SET=Server
#CHOSEN_INSTALL_SET=Client

 

---

 

---

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:

• Verify the Installation by Running the Samples and Starting Data View Builder
• For Client-Only Installations Modify Data View Builder Start Script