# Installation Guide

# Preparing to Install Oracle Data Service Integrator

Before you install Oracle Data Service Integrator, you need to verify that your system meets minimum requirements. This chapter provides information about supported platforms, system hardware and software requirements, and installation prerequisites. It also provides an overview of the Oracle Data Service Integrator components that get installed.

The following sections are included:

- Installation Overview
- Supported Configurations
- Installation Notes
- Oracle Data Service Integrator Installation Components

Note: | Oracle Data Service Integrator was originally named Liquid Data. Some instances of the original name remain in the product, installation path, and components.

## Installation Overview

This section provides a high-level overview of the tasks required to install Oracle Data Service Integrator, illustrated in Figure 1-1.

Figure 1-1 Overview of Installation Process

Task 1: Prepare to install

1. Preparing to install Oracle Data Service Integrator involves checking the supported platforms and databases, and verifying that you have the installation prerequisites in place. In addition, you can familiarize yourself with a description of the components that get installed on your system.
2. Uninstall any previous versions of Oracle Data Service Integrator. For details see Chapter 5, “Uninstalling Oracle Data Service Integrator.”

Note: | The uninstall option does not remove any Oracle Data Service Integrator or other Oracle Workshop for WebLogic projects that you have created.

Task 2: Install Oracle Data Service Integrator.

You can install Oracle Data Service Integrator in the following modes:

- GUI mode — Features an easy-to-use graphical installer application
- Console mode — Is suitable on UNIX systems without a graphics (windowing) workstation
- Silent mode — Reads an installer properties file to determine the install options on Windows or UNIX systems

For more information about using GUI mode, see Chapter 2, “Installing Oracle Data Service Integrator Using GUI Mode.” For more information about using Console mode and Silent mode, see Chapter 3, “Installing Oracle Data Service Integrator Using Console or Silent Mode.”

Task 3: Perform post-installation tasks

After installation, you can verify that the installation was successful and explore Windows shortcuts and UNIX paths to key components. For more information, see Chapter 4, “Post-Installation Tasks.”

## Supported Configurations

For information on supported operating systems, DBMS vendors, and other configurations, see Supported Configurations.

## Installation Notes

The Oracle Data Service Integrator installer application installs the following additional software, as required:

- Oracle WebLogic Server 10gR3, if it is not already present in the `<bea_home>` directory you select
- The latest JRockit version to ensure higher Oracle Data Service Integrator performance

The Oracle Data Service Integrator IDE runs as a Workshop for WebLogic plug-in.

Note: | If you are using Windows 2000, the maximum classpath size can be exceeded. For this reason, it is recommended that when you install Oracle Data Service Integrator you install it into the `<bea_home>` directory with a directory name of four characters or less, such as <bea>.

## Oracle Data Service Integrator Installation Components

Table 1-1 provides a list of components that are installed with Oracle Data Service Integrator.

Table 1-1 Oracle Data Service Integrator Installation Components
Component Name | Sub-components
--- | ---
Oracle Data Service Integrator Runtime
Note: | Installing the runtime is mandatory for Oracle Data Service Integrator and is a prerequisite for installing other components.
| Oracle Data Service Integrator runtime including the XQuery engine Configuration framework Oracle Data Service Integrator Administration Console Oracle Data Service Integrator base domain template
Note: | Oracle WebLogic Server 10gR3 is a prerequisite for Oracle Data Service Integrator runtime.
Oracle Data Service Integrator IDE and Client Tools | Workshop for WebLogic Oracle Data Service Integrator IDE plugins Oracle Workspace SCA Common Components and Oracle Workspace Service Consumption Tooling
Note: | Workshop for WebLogic is required to run the Oracle Data Service Integrator perspective.
Oracle Data Service Integrator Samples | Samples domain Sample project predeployed in the samples domain Retail Dataspace Sample Application
Note: | Tou need to perform a custom installation to have the Oracle Data Service Integrator samples installed; the standard installation does not install the server samples nor the IDE samples.

### Preconfigured Samples Domain

The full Oracle Data Service Integrator installation provides a preconfigured samples domain, as shown in Table 1-2.

Table 1-2 Oracle Data Service Integrator Samples Preconfigured Domain and Start Commands for Samples Server
Platform | Windows and UNIX Paths to Start in Each Domain | Description
--- | --- | ---
Windows | Start > All Programs > Oracle WebLogic > User Projects > base_domain > Start Server for Oracle Data Service Integrator or Run `startWebLogic.cmd` from any one of the following locations: `<aldsp_home>\user_projects\domains\base_domain\` or `<aldsp_home>\user_projects\domains\base_domain\bin` | Starts the Oracle Data Service Integratorsamples server on Windows Starts the Oracle Data Service Integrator samples server on Windows
UNIX | Run the `startWebLogic.sh` command from any of the following locations: `<aldsp_home>/user_projects/domains/base_domain` or `<aldsp_home>/user_projects/domains/base_domain/bin` | Starts the Oracle Data Service Integrator samples server on UNIX

Note: | `<aldsp_home>` is the home directory for installing Oracle Data Service Integrator.

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

### Internationalization Support

Oracle Data Service Integrator is internationalized and supports multi-byte data from the underlying data sources. Specifically, Oracle Data Service Integrator works with Japanese character sets, where the underlying databases are running in Japanese locales.