Skip navigation.
Downloads | Product Documentation | Support

Installation Guide

# Preparing to Install Liquid Data

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

Before you install BEA Liquid Data for WebLogic, make sure your system meets minimum requirements. This chapter provides information about supported platforms, system hardware and software requirements, how to install all needed software in the proper order, how to get up-to-date product licenses, and an overview of what gets installed.

The following sections are included here:

- Supported Platforms and Databases
- Accessing Information from Enterprise Information Systems or Custom Applications
- Internationalization Support
- Installation Prerequisites

- Server Installation Prerequisites
- Client Installation Prerequisites

- Required Order of Installation Tasks
- About Licensing for Liquid Data
- What Gets Installed

- Preconfigured Samples Domain

- Considerations for Adding Liquid Data to a WebLogic Server Domain

# Supported Platforms and Databases

BEA Liquid Data for WebLogic supports the WebLogic Platform support configurations for each operating system WebLogic Platform type.

In general any thread-safe, transaction-callable DBMS accessible through JDBC should be available to Liquid Data.

Note: With certain noted exceptions, Liquid Data supports the same platforms, operating systems, chip architecture, SDKs, and RDBMS systems as WebLogic Platform 8.1 SP2. For complete details on this support see Supported Configurations for WebLogic Platforms.

Table 1-1 Supported Platforms and Databases for Liquid Data

Operating System and Version | Chip Arch. | Supported STKs | Minimum Required Configuration | DBMS (Database Support) For more information, see Supported Databases and Drivers in the WebLogic Platform documentation.
--- | --- | --- | --- | ---
HP-UX 11.01 HP-UX 11i1 | PA RISC | HP SDK 1.4.1.052 | HP 9000 650 MHz (or faster) CPU 512 MB RAM (1 GB RAM recommended) TCP/IP network interface | Oracle 8.1.7.4 and later service packs Oracle 9.2.0.4 and later service packs PointBase 4.43 Sybase 12.5.034
Microsoft Windows 2000 Professional with Service Pack 2 or higher5, 6 Microsoft Windows 2000 Server with Service Pack 2 or higher6 Microsoft Windows 2000 Advanced Server with Service Pack 2 or higher6 Microsoft Windows 2000 Datacenter Server with Service Pack 2 or higher6 Microsoft Windows XP with Service Pack 1 or higher5, 6 | IA32 | Sun Java 2 SDK 1.4.1_057 WebLogic JRocket 8.1 SP2 SDK8 | Intel Pentium III (or higher) 700 MHz (or faster) CPU 512 MB RAM (1 GB RAM recommended) TCP/IP network interface Web browser Microsoft Internet Explorer 5.x or above Netscape Navigator 4.7 or above WebLogic Server 8.1 | DB2 8.1 FixPak 39 Microsoft SQL Server 2000 SP310 Informix 9.3 Oracle 8.1.7.4 and later service packs Oracle 9.2.0.4 and later service packs PointBase 4.43 Sybase 12.5.034
Red Hat Enterprise Linux AS 2.1 Kernel 2.4.9 with glibc-2.2.4-31.7 (and later errata levels) Red Hat Enterprise Linux ES 2.1 Kernel 2.4.9 with glibc-2.2.4-31.7 (and later errata levels) Red Hat Enterprise Linux WS 2.1 Kernel 2.4.9 with glibc-2.2.4-31.7 (and later errata levels)5 | IA32 | Sun Java 2 1.4.1_0511 WebLogic JRocket 8.1 SP2 SDK8 | Intel Pentium III (or higher) 700 MHz (or faster) CPU 512 MB RAM (1 GB RAM recommended) TCP/IP network interface | DB2 8.1 FixPak 39 Oracle 8.1.7.4 and later service packs Oracle 9.2.0.4 and later service packs PointBase 4.43 Sybase 12.5.034
Sun Solaris 81 Sun Solaris 91 | Sparc 64 | Sun Java 2 1.4.1_05 (32 bit) SDK7 | UltraSPARC-II 450 MHz (or faster) CPU 512 MB RAM (1 GB RAM recommended) TCP/IP network interface | DB2 8.1 FixPak 39 Oracle 8.1.7.4 and later service packs Oracle 9.2.0.4 and later service packs Sybase 12.5.034 Informix 9.3 PointBase 4.43
IBM12 AIX 5L Version 5.113, 14 IBM12 AIX 5L Version 5.213, 14 | PowerPC, POWER3 PowerPC, POWER4 | IBM SDK 1.4.1 32-bit PTF: ca141-20030703a15 | Minimum processor speed: - PowerPC, POWER3: 450 MHz - PowerPC, POWER4: 1 GHz 512 MB RAM minimum (1 GB RAM recommended) TCP/IP network interface | Oracle 8.1.716,17 Oracle 9.2.0 & later service packs18 PointBase 4.43

1. The WebLogic Workshop IDE and WebLogic Integration Format Builder are not supported on HP-UX and Sun Solaris systems. HP-UX and Sun Solaris are supported for the production deployment of applications developed in the WebLogic Workshop IDE, and for remote debugging of applications developed in the WebLogic Workshop IDE. HP-UX and Sun Solaris are also supported for the development and production deployment of WebLogic Server applications developed with other tools.
2. WebLogic Platform 8.1 SP2 supports HP SK 1.4.1.05 and all later service packs for development and production deployment on HP-UX. See operating system footnotes for other restrictions.
3. PointBase Server is a pure-Java relational database management system that BEA includes with WebLogic Platform to allow you to run code samples. It is provided solely to support product evaluation, either in the form of custom trial applications or through packaged sample applications provided with BEA products. Non-evaluation development and/or production use of the PointBase Server requires a separate license be obtained by the end user directly from PointBase.
4. WebLogic Integration does not support the BEA WebLogic Type 4/XA JDBC Driver for Sybase.
5. Microsoft Windows 2000 Professional and Microsoft Windows XP, and Red Hat Enterprise Linux WS 2.1 are supported for the design, development, and verification of applications; they are not supported for production server deployment.
6. The WebLogic Integration Format Builder and the WebLogic Workshop IDE, with extension for WebLogic Integration and WebLogic Portal, are supported on Microsoft Windows XP, and on Microsoft Windows 2000 Server, Advanced Server, and Datacenter Server with Service Pack 2 or higher. Microsoft Windows 2000 Server, Advanced Server, and Datacenter Server with Service Pack 2 are supported for the production deployment of applications developed in the WebLogic Workshop IDE, and are also supported for the development and production deployment of WebLogic Server applications developed with other tools. Servers started from the Workshop IDE can be configured to use with either the WebLogic JRocket SDK or the Sun Java 2 SDK.
7. The Sun Java 2 1.4.1_05 SDK, and all later service packs of 1.4.1 are supported for development and production deployment on Windows and Solaris. See operating system footnotes for other restrictions.
8. The WebLogic JRockit 8.1 SP2 SDK is supported on Windows and Red Hat Enterprise Linux systems for development and production deployment. See operating system footnotes for other restrictions.
9. DB2 is not supported by WebLogic Integration.
10. WebLogic Integration does not support the BEA WebLogic Type4/XA JDBC Driver for MS SQL Server.
11. On Red Hat Enterprise Linux platforms, the Sun Java 2 1.4.1_05 SDK and all later service packs of 1.4.1 are supported for development only. See operating system footnotes for other restrictions.
12. The IBM AIX platform is not yet supported by WebLogic Platform 8.1 SP2. Instead, use 8.1 SP1.
13. The procedure for installing WebLogic Platform on AIX differs from the generic installation procedure followed for other operating systems. For instructions, see "Installing WebLogic Platform 8.1 on IBM AIX" in WebLogic Platform Release Notes.
14. The WebLogic Workshop IDE and WebLogic Integration Format Builder are not supported on IBM AIX systems. IBM AIX is supported for the production deployment of applications developed in the WebLogic Workshop IDE. Debugging of applications developed in the WebLogic Workshop IDE, for deployment on AIX, should be accomplished to the extent possible on the Workshop development system; use of JVM debug mode with the IBM JVM significantly degrades application performance and debugging effectiveness. IBM AIX is also supported for the development and production deployment of WebLogic Server applications developed with other tools.
15. Because the required SDK is not delivered with WebLogic Platform, you must download it from the IBM Web site and install it, manually, before installing WebLogic Platform. For instructions, see "Downloading and Installing the IBM SDK" in WebLogic Platform Release Notes.
16. Oracle 8.1.7 and Microsoft SQL Server 2000 are not supported by WebLogic Integration 8.1.
17. If you are running Oracle 8.1.7 and you want to use WebLogic Portal, make sure you are running Oracle 8.1.7.4 (patch level) or higher.
18. When distributed transactions are used in a confguration that includes the Oracle 9.2.0 DBMS (on any operating system), BEA recommends use of Oracle 9.2.0.3 server and Oracle 9.2.0.3 Thin/XA Driver.

# Accessing Information from Enterprise Information Systems or Custom Applications

Liquid Data supports use of several Enterprise Information Systems (EIS) and custom applications as Application View data sources. Liquid Data interoperates with the BEA WebLogic Integration/ Application Integration (AI) layer through the Liquid Data Application View interface. Liquid Data can retrieve information through application-specific adapters from applications such as SAP, Siebel, PeopleSoft, Oracle Financial, among others, which are certified to work with BEA WebLogic Integration.

# Internationalization Support

The Liquid Data server and Data View Builder are internationalized and support multi-byte data from the underlying data sources. For this release, the user interface is in English only; it is ready for translation.

Liquid Data has been tested with Japanese character sets, where the underlying databases are running in Japanese locales. In accordance with the XML specification, target schema element names must be composed of single-byte characters. For any specific internationalization issues, see the Release Notes.

# Installation Prerequisites

Client systems and server systems have slightly different installation prerequisites—the main difference being that server systems require that WebLogic Platform 8.1 be installed prior to installing the Liquid Data server.

Note: Client systems where you plan to install only the Data View Builder do not require an installation of WebLogic Platform.

- Server Installation Prerequisites
- Client Installation Prerequisites

## Server Installation Prerequisites

This section lists the prerequisites for installing the Liquid Data server.

### WebLogic Platform 8.1

You must have WebLogic Platform 8.1 installed on the system where you plan to install the Liquid Data Server.

- WebLogic Platform 8.1 is available as a Web download from the BEA Download Center at http://commerce.bea.com/downloads/products.jsp.
- See the WebLogic Platform Installation Guide in the WebLogic Platform documentation for instructions on installing WebLogic Platform.

Note: If you are running Windows 2000, the maximum classpath size can be exceeded. For this reason it is recommended that when you install Liquid Data, you install it into <`BEAHOME`> directory with a directory name of four characters or less such as <`BEA`>.

### General Requirements and Other Prerequisites

- See Supported Platforms and Databases for memory recommendations on various platforms.)

The minimum RAM recommendations are for one instance of WebLogic Server on which Liquid Data is running. You may need more memory if you run two or more instances of WebLogic Server and/or Liquid Data.

Note: Some systems use disk space as virtual RAM. Performance when running in virtual RAM may be markedly slower than when running in real RAM.

- Java 2 SDK, Standard Edition, v1.4.1 (JDK141_03). (See Supported Platforms and Databases for exact JDK versions required on various platforms.)

When you install WebLogic Server, JDK is installed directly under the `<BEAHOME>` directory as follows:

`<BEAHOME>`/JDK141_03

where `<BEAHOME>` is the path to your `<BEAHOME>`; that is, where you installed WebLogic Platform. By default, `<BEAHOME>` is c:/bea on Windows systems.

## Client Installation Prerequisites

The WLS file `weblogic.jar` is required to start the Data View Builder. Therefore, a copy of WebLogic Server `weblogic.jar` file must be available to the machine where you install the Data View Builder. (For install options that include Liquid Data server, this is addressed automatically as a part of the installation but not so for the client-only install.)

See Modifying Data View Builder Start Script for Client-Only Installations in "Post-Installation Tasks."

Note: You can use Liquid Data in a team development environment with multiple clients accessing a shared Liquid Data server repository for resources such as schema files, XML files, local WSDL definitions for web services, and so on. For more information on various deployment and development scenarios and environments, see the Deployment Tasks topic in the Deployment Guide.

# Required Order of Installation Tasks

To ensure a valid Liquid Data installation, you must install products and components in the following order:

1. Unless you are using the Liquid Data client-only installation set, you need to install WebLogic Platform 8.1 including WebLogic Server and JDK141_03
2. Install Liquid Data.

# About Licensing for Liquid Data

When you install Liquid Data, a valid evaluation license is automatically included with the installation. You do not need to take any extra steps for Liquid Data licensing.

# What Gets Installed

Note: Before you install Liquid Data, you must install WebLogic Server.

The full install of Liquid Data results in the installation of the following key components on the system:

- Liquid Data server (running as a deployed application in WebLogic Platform).
- Liquid Data configuration and monitoring pages added to the WebLogic Administration Console.
- Data View Builder GUI.
- Liquid Data Workshop Control
- Liquid Data Sample Domain

For more information about the software, refer to the Liquid Data Concepts Guide
.

For information on how to configure Liquid Data once you have installed it, refer to the BEA WebLogic Server Administration Guide
.

## Preconfigured Samples Domain

The full Liquid Data with Samples option provides a preconfigured samples domain as shown in the following table.

Table 1-2 Liquid Data Samples Preconfigured Domain and Start Commands for Samples Server

Platform | Windows and UNIX Paths to Start in Each Domain | Description
--- | --- | ---
Windows | `Start->Programs -> BEA WebLogic Platform 8.1->BEA Liquid Data for WebLogic 8.1 -> Liquid Data Samples -> Samples Server` or <WL_HOME>/samples/domains/liquiddata/`\ startWeblogic.cmd` | Starts the Liquid Data samples server on Windows
UNIX | <WL_HOME>/samples/domains/liquiddata/`\ startWeblogic.sh` | Starts the Liquid Data samples server on UNIX

Note: `<WL_HOME>` is the home location of your WebLogic installation, by default, `<WL_HOME>` is `c:/bea/weblogic810`.

For a detailed explanation of domains, see Creating WebLogic Configurations Using the Domain Control Wizard in the WebLogic Platform documentation.

# Considerations for Adding Liquid Data to a WebLogic Server Domain

For information about adding Liquid Data to a WebLogic Server domain (including preconfigured domains for BEA WebLogic Integration, BEA WebLogic Portal, or WebLogic Workshop), see the Deployment Tasks topic in the Deployment Guide. The information provided in the Deployment Guide about adding Liquid Data to a domain as well as setting up clustered environments is relevant to both deployed systems and development environments.