Installing Oracle Service Bus

This section provides the information for installing Oracle Service Bus on Windows and UNIX. It contains the following topics:

Starting the Installation Program

This section provides information on how to start the installation on Windows and UNIX in:

Before you start the installation, read Before You Start in the Installation Guide.

Running the Installation Program in Graphical Mode

You can install Oracle Service Bus in the graphical-mode on Windows systems and on UNIX systems which support GUI. For information on how to run the installation in the graphical-mode, see Running the Installation Program in Running the Installation Program in Graphical Mode in Installation Guide.

For information about the components available for installation on your system, see Product Components.

After you choose the components for installation, you must install Eclipse in a new Eclipse home or provide the path to the existing Eclipse home. For more information on requirements to use an existing Eclipse home, see Requirements for Using the Existing Eclipse Installation.

Running the Installation in the Console Mode

You must install Oracle Service Bus in the console-mode if your operating system does not support GUI. For more information on console-mode installation, see Running Console-Mode Installation in Running the Installation Program in Console Mode in Installation Guide.

After you choose the components for installation, you must install Eclipse in a new Eclipse home or provide the path to the existing Eclipse home.

In the Choose Products Directory prompt, specify the directory in which you want to install the software.

Running the Installation in the Silent-Mode

You must install Oracle Service Bus in the silent-mode if your operating system does not support GUI or for multiple installations in a cluster environment. For more information on the silent-mode install, see What Is Silent-Mode Installation? and Using Silent-Mode Installation: Main Steps in Running the Installation Program in Silent Mode in the Installation Guide.

Creating a silent.xml File for Silent-Mode Installation

When you install your Oracle software in silent-mode, the installation program uses an XML file (silent.xml) to determine which installation options should be implemented. Therefore, before you can run the installation program in silent-mode, you must first create a silent.xml file in which you specify the installation options that you want to invoke.

Incorrect entries in the silent.xml file can cause installation to fail. To help you determine the cause of a failure, Oracle recommends that you create a log file when you start the installation.

To create a silent.xml file for use in the silent-mode installation process, follow these steps:

In a supported browser, view the sample silent.xml file for silent-mode installation. The sample file is available at http://download.oracle.com/docs/cd/E13159_01/osb/docs10gr3/install/scripts/silent.xml.

This sample silent.xml file is also presented in this section. See Sample silent.xml File for Silent-Mode Installation.

Save the sample XML file, with the name silent.xml, in the same directory that contains the installation program.

Note: The XML definition must be <?xml version="1.0" encoding="ISO-8859-1"?>. It must be at the beginning of the silent.xml file. There should not be any spaces or line breaks before the XML definition.

In the silent.xml file edit the values for the keywords shown in Table 2-1 to reflect your configuration.

Note:

You must follow XML guidelines for characters when modifying values. For example, do not use characters reserved for use in XML, such as <, >, [, and].

For this data-value name...

Enter the following value...

BEAHOME

The full path for the BEA home directory of your choice.

For information about the BEA home directory, see Choosing a BEA Home Directory.

WLS_INSTALL_DIR

The full path for the directory where you want to install the Oracle WebLogic Server.

You must install inside the BEAHOME and use the following name: wlserver_10.3.

For more information, see Choosing Product Installation Directory.

ALSB_INSTALL_DIR

The full path for the directory where you want to install the Oracle Service Bus.

You must install inside the BEAHOME. You may use any name for the subdirectory within BEAHOME. Default name: osb_10.3.

For more information, see Choosing Product Installation Directory.

COMPONENT_PATHS

Specify the components and sub-components you want to install on your system:

To install Oracle Service Bus, use the following values:

<data-value name="COMPONENT_PATHS" value="Oracle Service Bus/Service Bus Examples" />

For more information about entering these values, see Guidelines for Component Selection in Running the Installation Program in Silent Mode in Installation Guide.

INSTALL_NODE_MANAGER_SERVICE

(Windows platforms only)

yes to install the Oracle WebLogic Server Node Manager as a Windows service. For information, see Installing Node Manager as a Windows Service
no to skip the installation of the Oracle WebLogic Server Node Manager as a Windows service. The default is no.

Note:

You must have Administrator privileges to install Node Manager as a Windows service.
When you are installing Oracle Service Bus on UNIX-based platforms, this parameter is ignored.

NODEMGR_PORT

The Node Manager Listen Port.

If you do not specify a port number, the installer uses the default port 5556.

If the port number is in use, the installer scans for the next available port and assigns it to the Node Manager.

Note: The INSTALL_NODE_MANAGER_SERVICE option must be set to yes.

At the completion of the installation process, the Node Manager is started using the port specified.

INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER

true, or yes, to create the shortcuts in the All Users folder. The default is true.
false, or no, to create the shortcuts in the local users folder.

The user performing the installation must have Administrator privileges to install the Start menu shortcuts in the All Users folder. For more information, see Administrator Privileges.

Sample silent.xml File for Silent-Mode Installation

The sample silent.xml file shown in Listing 2-1 is configured to install the Oracle Service Bus into directory C:\bea\osb_10.3. In this example, Oracle WebLogic Server has already been installed in C:\bea\wlserver_10.3.

Listing 2-1 Sample silent.xml File

<?xml version="1.0" encoding="UTF-8"?>

<bea-installer>

    <input-fields>

        <data-value name="BEAHOME" value="C:\bea" />

        <data-value name="WLS_INSTALL_DIR" value="C:\bea\wlserver_10.3"/>

        <data-value name="ALSB_INSTALL_DIR" value="C:\bea\osb_10.3" />

        <data-value name="COMPONENT_PATHS" value="Oracle Service Bus/Service Bus Examples" />

        <data-value name="INSTALL_NODE_MANAGER_SERVICE" value="yes"  />

        <data-value name="NODEMGR_PORT" value="5559" />

        <data-value name="INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER" value="yes"/>

    </input-fields>

</bea-installer>

For more information on launching the installation in silent-mode, see Starting the Installation in Silent Mode in Starting the Installation Program in the Installation Guide.

You can generate exit codes to indicate the success or failure of the installation program. For more information, see Returning Exit Codes to the Console in Running the Installation Program in Silent Mode in Installation Guide.

Installing Oracle Service Bus With Oracle WebLogic Integration

If you plan to use Oracle Service Bus with Oracle WebLogic Integration, follow these instructions for your installation scenario:

Installing Oracle Service Bus Over Oracle WebLogic Integration

To install Oracle Service Bus over a previously installed version of Oracle WebLogic Integration, follow these steps:

Installing Oracle WebLogic Integration Over Oracle Service Bus

To install Oracle WebLogic Integration over a previously installed version of Oracle Service Bus, follow these steps:

Uninstalling the Software

For information about uninstalling and reinstalling the software, see Uninstalling the Software in Installation Guide.

You cannot reinstall the same version of any Oracle product on top of a previously installed version of the same product whether it is in the same BEA home directory or in the same file location. You can, however, add products and product components to an existing installation. For example, you can install Oracle WebLogic Server during one installation, and Oracle Service Bus during a separate installation.

To reinstall the same version of one of the product components or the entire Oracle products distribution in the same location, you must first uninstall the previous installation.

If you try to install a complete copy of the Oracle products in a BEA home directory that already contains a complete installation, an error message is displayed. Click or type OK to return to the Choose BEA home directory prompt.