Installation Guide

Installing Liquid Data Using Console or Silent Mode

This section describes how to install BEA Liquid Data for WebLogic using either Console mode or Silent mode. Console mode is an interactive installation that you can use on UNIX systems without a graphics (windowing) workstation.

Silent mode is a non-interactive installation on a Windows or UNIX system. In Silent mode, the installer application uses a properties file to obtain installation parameters.

The chapter includes the following sections:

Following installation, you can perform specific post-installation tasks such as verifying successful installation and exploring Liquid Data shortcuts and paths. For more information, see Post-Installation Tasks.

Figure 3-1 illustrates the current step in the overall installation process.

Figure 3-1 Console Mode Installation Step

Console Mode Installation Step

Before You Install

Before you begin installing Liquid Data, confirm that the following conditions are met:

WebLogic Server or WebLogic Platform 8.1 is installed in the <BEAHOME> directory in which you are going to install Liquid Data.
Liquid Data is not running on the system.

You must remove Liquid Data in cases when it is located in the same <BEAHOME> directory to which you plan to install. See Uninstalling Liquid Data for details.

An entry for the JDK142_05 bin directory (for example <BEA_HOME>/JDK142_05/bin) must be included in your PATH environment variable setting before any other JDK bin directories.

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

Using Console Mode to Install Liquid Data

This section describes the console-mode installation procedure.

Note: You cannot install Liquid Data in console mode on Solaris systems running in a Japanese locale. In cases when 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 run it in a Japanese locale.

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

Change to the directory (cd) that contains the Liquid Data installer.

Start the installation program.

The installer file name has the following form:
filename.bin
where filename is the name of the Liquid Data installation program specific to your platform. For example, enter the following to start the Solaris version of the Liquid Data installation program:
sh liquiddata_850_solaris32.bin -mode=console
Similarly, enter the following to start the Linux version of the Liquid Data installation program:
./liquiddata_850_linux32.bin -mode=console
A message appears indicating that the software is being extracted, followed by a welcome message, as shown in the following text: <--------- BEA Installer - BEA WebLogic Liquid Data 8.5 ---------> Welcome: -------- This installer will guide you through the installation of BEA WebLogic Liquid Data 8.5. Type "Next" or enter to proceed to the next prompt. If you want to change data entered previously, type "Previous". You may quit the installer at any time by typing "Exit". Enter [Exit][Next]>

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. Select Option: 1 - Yes, I agree with the terms of the license 2 - No, I do not agree with the terms of the license Enter option number to select OR [Down][Exit][Previous]>

Enter 1 if you accept the license agreement.

You are prompted to choose the BEA home directory, as shown in the following text: <--------- BEA Installer - BEA WebLogic Liquid Data 8.5 ---------> Choose BEA Home Directory: -------------------------- "BEA Home" = [/usr/local/bea] Input existing BEA Home OR [Exit][Previous][Next]>
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/installprepare.html
A warning message is displayed in cases when a previous installation of Liquid Data is found, or when WebLogic Server 8.1 is not found in the specified BEA home directory.

Press Enter to accept the default BEA home directory, or enter an alternative directory.

When prompted, confirm the directory you selected. You are prompted to choose whether you want to perform a complete or custom installation, as shown in the following text: <--------- BEA Installer - BEA WebLogic Liquid Data 8.5 ---------> 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]>

Enter 1 or 2 to choose a complete or custom installation respectively.

When you specify a custom installation, the installer enables you to choose the components to install, as shown in the following text: <--------- BEA Installer - BEA WebLogic Liquid Data 8.5 ---------> Choose Components to install: ----------------------------- Release 8.5.0.0 |_____WebLogic Liquid Data [1] x |_____Liquid Data Runtime [1.1] x |_____Workshop Extension [1.2] x |_____Samples [1.3] x Enter number exactly as it appears in brackets to toggle selection OR [Exit][Previous][Next]>
Enter the value for the component, for example, 1.1 for the Liquid Data Runtime. The installer prompts you for additional component values. Continue selecting components, and press Enter without a value when you are done.
The installation begins and the installation status is displayed as it progresses. When the installation is complete, a "Congratulations!" message is displayed.

Press Enter to exit the installer.

This completes the Console Mode installation process.

Using Silent Console Mode to Install Liquid Data

The Windows, UNIX, and Linux versions of the installer provide a noninteractive, or silent-mode installation, that you can use in cases when 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.

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. 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> or the specified Liquid Data install directory (USER_INSTALL_DIR) do not exist or are incorrect, the installer fails.

Note: 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, the installer displays a message and no changes are made to the system.

Using Silent Mode on Windows and UNIX Systems

This section describes how to install Liquid Data on Windows and UNIX systems using Silent Mode.

To install using silent mode:

Create the required installer properties file.

The content of the file is described in Exploring the Silent Mode Installer Properties File. You can use any legal file name for the installer properties file. Verify that the <BEAHOME>, <USER_INSTALL_DIR>, and other values specified in the properties file are correct and that all requirements have been met.

Open a command window.

Navigate to the directory containing the Liquid Data installer.

On Windows, the installer application is:

liquiddata_850_win32.exe

On UNIX and Linux, the installer application is:

filename.bin
where filename.bin is the name of the Liquid Data installation program specific to your platform; for example, liquiddata_850_solaris32.bin for the Solaris version of Liquid Data.
You will find similarly-named installer files for all UNIX and Linux versions of Liquid Data.

Run the installer application, specifying the properties file and the log file name as options.

On Windows, run the following command:

liquiddata_850_win32.exe -mode=silent -silent_XML=<drive:\properties_file_path> -log=<drive:\log_file_path>
where drive is the letter that identifies the hard disk drive, properties_file_path is the complete pathname of the Liquid Data silent installation properties file, and log_file_path is the complete pathname of the log file.
For example, you could enter the following:
liquiddata_850_win32.exe -mode=silent -silent_XML=c:\temp\ld_properties.txt -log=c:\temp\logfile.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.
To verify that the installer is running, open the Windows Task Manager. The installer is listed as the javaw.exe process.

On UNIX, run the following command:

sh liquiddata_850_solaris32.bin -mode=silent
	-silent_XML=complete_properties_file_path
	-log=complete_log_file_path

where complete_properties_file_path is the complete pathname of the properties file and complete_log_file_path is the complete pathname of the log file. A complete path is required, even when the file resides in the same directory as the liquiddata_850_solaris32.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.

On Linux, run the following command:

./liquiddata_850_linux32.bin -mode=silent
	-silent_XML=complete_properties_file_path
	-log=complete_log_file_path

where complete_properties_file_path is the complete pathname of the properties file and complete_log_file_path is the complete pathname of the log file. A complete path is required, even when the file resides in the same directory as the liquiddata_850_linux32.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.

Exploring the Silent Mode Installer Properties File

Table 3-1 describes the required installer properties used with a Silent Mode installation.

Table 3-1 Installer Properties

Sample Property Setting	Description
`BEAHOME=d:\\bea` `BEAHOME=/bea`	BEA Home directory. The specified directory must exist on the system. For full installation options that include Liquid Data, 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.
`COMPONENT_PATHS`	The components to install on the system. You can specify the following: Liquid Data Runtime. Installs Liquid Data. Workshop Extension. Installs Liquid Data extensions to WebLogic Workshop. Samples. Installs the Liquid Data sample domains.

Sample Property Setting

Description

BEAHOME=d:\\bea

BEAHOME=/bea

BEA Home directory. The specified directory must exist on the system. For full installation options that include Liquid Data, 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.

COMPONENT_PATHS

The components to install on the system. You can specify the following:

Liquid Data Runtime. Installs Liquid Data.

Workshop Extension. Installs Liquid Data extensions to WebLogic Workshop.

Samples. Installs the Liquid Data sample domains.

The following shows a sample Silent Mode installer properties file:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Silent installer option: -mode=silent-silent_xml=/home/me/silent.xml -->
<domain-template-descriptor> 
	<input-fields> 
		<data-value name="BEAHOME" value="C:\bea" />
		<data-value name="USER_INSTALL_DIR"
value="C:\bea\weblogic81" />
		<data-value name="COMPONENT_PATHS" value="Liquid Data
Runtime|Workshop Extension|Samples" />
</input-fields>
</domain-template-descriptor>