# Installation Guide

# Installing Oracle Data Service Integrator Using Console or Silent Mode

This section describes how to install Oracle Data Service Integrator 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:

- Before You Install
- Installing Using Console Mode
- Using Silent Console Mode to Install Oracle Data Service Integrator

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

Figure 3-1 Console Mode Installation Task

## Before You Install

Before you begin installing Oracle Data Service Integrator, confirm that the following conditions are met:

- WebLogic Server 10g Release 3 is installed in the `<bea_home>` directory in which you are installing Oracle Data Service Integrator. The Oracle Data Service Integrator installer application installs WebLogic Server 10g Release 3 if it is not present.
- Oracle Data Service Integrator is not running on the system.

You must remove Oracle Data Service Integrator in cases where it is located in the same `<aldsp_home>` directory to which you plan to install. For details see Chapter 5, “Uninstalling Oracle Data Service Integrator.”

- An entry for the JDK160_05 `bin` directory (for example `<bea_home>/JDK160_05/bin`) must be included in your PATH environment variable setting before any other JDK bin directories.
- By default, Workshop for WebLogic (Eclipse 3.3.2) is available for installation with Oracle Data Service Integrator in the `<bea_home>\workshop_10.3\workshop4WP directory`. If you are planning to use an Eclipse version that is not bundled with Oracle Data Service Integrator, then you need to manually clean up the Eclipse configuration directory to avoid some known issues in Eclipse 3.2.2. All files except `config.ini` and files under `.settings` subdirectory should be deleted.

For additional information about installation prerequisites, see “Installation Notes” on page 1-3 in Chapter 1, “Preparing to Install Oracle Data Service Integrator.”

## Installing Using Console Mode

This section describes the console-mode installation procedure.

Note: | You cannot install Oracle Data Service Integrator 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 Oracle Data Service Integrator is installed, you can run it in a Japanese locale.

To install Oracle Data Service Integrator on a UNIX system in console mode:

1. Change to the directory (cd) that contains the Oracle Data Service Integrator installer.
2. Start the installation program.

The installer file name has the following form:

`filename``.bin`

where `filename` is the name of the Oracle Data Service Integrator installation program specific to your platform. For example, enter the following to start the Solaris version of the Oracle Data Service Integrator installation program:

`sh odsi1030_solaris32.bin -mode=console`

Similarly, enter the following to start the Linux version of the Oracle Data Service Integrator installation program:

`./odsi1030_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:

    <---- Oracle Installer - Oracle Data Service Integrator 10.3 ---->
    Welcome:
    --------
    This installer will guide you through the installation of Oracle Data Service Integrator 10.3. 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]>

3. Press Enter to continue.

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

    <---- Oracle Installer - Oracle Data Service Integrator 10.3 ---->
    Choose BEA Home Directory:
    --------------------------

    "BEA Home" = [Enter new value or use default /usr/local/bea]

    Enter new BEA Home OR [Exit][Previous][Next]>

The `<bea_home>` directory serves as the central support directory for all Oracle 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 Oracle WebLogic Server.

A warning message is displayed in cases when a previous installation of Oracle Data Service Integrator is found.

4. 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:

Select the type of installation you want to perform.

    ->1¦Complete
        ¦ Install the following software products and examples:
        ¦ - WebLogic Server
        ¦ - Oracle Data Service Integrator
        ¦ - Workshop

       2¦Custom
        ¦ Choose software products and components to install and perform
        ¦ optional configuration.

    Enter index number to select OR [Exit][Previous][Next]>

5. 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:

    <------- Oracle Installer - Oracle Data Service Integrator 10.3------>

    Choose Components to install:
    -----------------------------

        Release 10.3.0.0
        +----WebLogic Server [1] v
        ¦    +----Core Application Server [1.1] v
        ¦    +----Administration Console [1.2] v
        ¦    +----Configuration Wizard and Upgrade Framework [1.3] v
        ¦    +----Web 2.0 HTTP Pub-Sub Server [1.4] v
        ¦    +----WebLogic JDBC Drivers [1.5] v
        ¦    +----Third Party JDBC Drivers [1.6] v
        ¦    +----WebLogic Server Clients [1.7] v
        ¦    +----WebLogic Web Server Plugins [1.8] v
        ¦    +----UDDI and XQuery Support [1.9] v
        ¦    +----Server Examples [1.10]
        +----Oracle Data Service Integrator [2] v
        ¦    +----Data Services Server [2.1] v
        ¦    +----Eclipse Plug-Ins [2.2] v
        ¦    +----Samples [2.3] v
        +----Workshop [3] v
             +----Workshop for WebLogic [3.1] v
             +----Workshop Runtime Framework [3.2] v

    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 Oracle Data Service Integrator Server. The installer prompts you for additional component values. Continue selecting components, and press Enter without a value when you are done.

6. Enter the Eclipse installation options. Option 1 allows you to install Eclipse bundled with Oracle Data Service Integrator. Option 2 allows you to specify a different Eclipse home directory and not install the Eclipse bundle available with Oracle Data Service Integrator.
7. Review the Oracle Data Service Integrator product installation directories and press Enter.
8. The installation begins and the installation status is displayed as it progresses. When the installation is complete, “Congratulations!” is displayed. Press Enter to exit the installer.

This completes the Console mode installation process.

## Using Silent Console Mode to Install Oracle Data Service Integrator

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 Oracle Data Service Integrator 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 Oracle Data Service Integrator is detected, a dialog box appears asking if you want to override the old version. Other exceptions cause the installer to fail. For example, if the specified BEA home directory `<bea_home>` or the specified Oracle Data Service Integrator 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 Oracle Data Service Integrator on Windows and UNIX systems using Silent Mode.

To install using silent mode:

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

2. Open a command window.
3. Navigate to the directory containing the Oracle Data Service Integrator installer.

- On Windows, the installer application is:

    odsi1030_win32.exe

- On UNIX and Linux, the installer application is:

`filename.bin`

where `filename.bin` is the name of the Oracle Data Service Integrator installation program specific to your platform; for example, `odsi1030_solaris32.bin` for the Solaris version of Oracle Data Service Integrator.

You will find similarly-named installer files for all UNIX and Linux versions of Oracle Data Service Integrator.

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

- On Windows, run the following command:

`odsi1030_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 Oracle Data Service Integrator silent installation properties file, and log_file_path is the complete pathname of the log file.

For example, you could enter the following:

`odsi1030_win32.exe -mode=silent
-silent_xml=c:\temp\silent.xml
-log=c:\temp\logfile.txt`

You are returned to the command prompt and the Oracle Data Service Integrator 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 odsi1030_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 odsi1030_`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 successful, Installation Complete is displayed.

- On Linux, run the following command:

    ./odsi1030_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 `odsi1030_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 successful, 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` | The BEA Home directory. This is the complete pathname to the BEA Home directory that will contain this installation. For Windows, specify the absolute path, including the drive. For UNIX, specify the absolute path.
`USER_INSTALL_DIR` | The WebLogic Server installation directory. For Windows, specify the absolute path, including the drive. For UNIX, specify the absolute path.
`ALDSP_INSTALL_DIR` | The Oracle Data Service Integrator installation directory. For Windows, specify the absolute path, including the drive. For UNIX, specify the absolute path.
INSTALL_MERCURY_PROFILING_TOOLS | Optionally install the Mercury profiling tools. Possible values are `true`, `yes`, `false`, and `no`. The default is true.
INSTALL_NODE_MANAGER_SERVICE | Install Node Manager as a Windows service. The default value is set to no; you need Administrative privileges to set this value to yes.
NODEMGR_PORT | Set the Node Manager listen port number. If you do not specify a port, then the installer uses default port 5556. To set this value the INSTALL_NODE_MANAGER_SERVICE option needs to be set to yes.
COMPONENT_PATHS | Specify the components and subcomponents to install. To install multiple components, separate the components with a bar (|). To install subcomponents, specify a component/subcomponent combination. For example, to install Web Server Plug-Ins, use “WebLogic Server/Web Server Plug-Ins”.
INSTALL_SHORTCUTS_IN_ALL_USESRS_FOLDER | The Windows Start menu folder in which you want the Start menu shortcuts created. The user performing the installation must have Administrator privileges to install the shortcuts in the All Users folder. The possible values are: true/yes—The shortcuts are created in the All Users folder (default) false/no—The shortcuts are created in the local user's folder
USE_EXTERNAL_ECLIPSE | Specify whether to use an existing Eclipse installation, from among the following values: true—Only the Eclipse plug-ins are installed in the Eclipse instance located at `EXTERNAL_ECLIPSE_DIR`. false (default)—The complete Eclipse instance is installed in the default location.
EXTERNAL_ECLIPSE_DIR | The directory where the existing external Eclipse instance is installed.
ECLIPSE32_HOME | The home directory where Eclipse should be installed. This setting is for backward compatibility; you should typically use EXTERNAL_ECLIPSE_ DIR instead.

The following shows a sample Silent Mode installer properties file (silent.xml):

    <?xml version="1.0" encoding="ISO-8859-1"?>
    <bea-installer>
      <input-fields>
        <data-value name="BEAHOME" value="C:/bea103"/>
        <data-value name="ALDSP_INSTALL_DIR" value="C:/bea103/odsi_10.3"/>
        <data-value name="USER_INSTALL_DIR" value="C:/bea103/wlserver_10.3"/>
        <data-value name="COMPONENT_PATHS" value="WebLogic Server|
        Oracle Data Service Integrator/Data Services Server|Oracle Data
        Service Integrator/Eclipse Plug-Ins|Oracle Data Service
        Integrator/Samples"/>
        <data-value name="INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER" value="yes"/>
      </input-fields>
    </bea-installer>