Skip Headers
Oracle® SOA Suite Installation Guide for Oracle WebLogic Server
10g Release 3 (10.1.3.5.1) for UNIX and Microsoft Windows

Part Number E15828-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

2 Installation

This chapter describes how to install Oracle SOA Suite with Oracle WebLogic Server. It includes the following topics:

2.1 Installation and Configuration Step Overview

This section describes the steps involved in installing and configuring the Oracle Database, creating a schema in the Database, and installing and configuring Oracle WebLogic Server.

Perform the following steps in order:

  1. Install Oracle WebLogic Server 11g (Section 2.3)

  2. Create SOA Schemas using Base IRCA from Installer (Section 2.4)

  3. Download Oracle SOA Suite 10.1.3.5.1 for Oracle WebLogic Server 11g (Section 2.5)

  4. Install Oracle SOA Suite with Oracle WebLogic Server (Section 2.6)

  5. Execute configureSOA wrapper script (configures SOA and invokes WLS ConfigWizard) (Section 2.7)

  6. Create SOADomain using ConfigWizard (Section 2.8)

See Also:

Oracle recommends reviewing the following documentation after you completing installation configuration:
  • Oracle BPEL Process Manager Quick Start Guide

  • Oracle BPEL Process Manager Order Booking Tutorial

  • Oracle BPEL Process Manager Developer's Guide

  • Oracle Application Server Adapter for Files, FTP, Databases, and Enterprise Messaging User's Guide

  • Oracle Application Server Adapter Concepts

The 10g Release 3 (10.1.3.1) documentation library is available on the Oracle Technology Network (OTN):

http://www.oracle.com/technology/documentation/appserver10131.html

2.2 System Requirements, Prerequisites and Certification

Before performing any installation you should read the system requirements and certification documentation to ensure that your environment meets the minimum installation requirements for the products you are installing.

The system requirements document covers information such as hardware and software requirements, minimum disk space and memory requirements, and required system libraries, packages, or patches:

http://www.oracle.com/technology/software/products/ias/files/oracle_soa_requirements_101310.html

The certification document covers supported installation types, platforms, operating systems, databases, JDKs, and third-party products:

http://www.oracle.com/technology/software/products/ias/files/oracle_soa_certification_101310.html

Note:

Once you install Oracle SOA Suite with Oracle WebLogic Server you cannot uninstall it.

2.3 Install Oracle WebLogic Server

Before installing Oracle SOA Suite, you must first install Oracle WebLogic Server.

Refer to Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server for more information on installing Oracle WebLogic Server.

2.4 Create SOA Schemas using Base IRCA from Installer

This section describes how to create SOA schemas using the base IRCA from the installer.

Note:

The scripts to configure Oracle SOA Suite on the Oracle WebLogic Server require that the JAVA_HOME environment parameter is set prior to running the script.
  1. Navigate to the install\soa_schemas\irca folder in the Oracle SOA Suite Installer directory.

  2. Set SOA_ORACLE_HOME to point to the Oracle Database Installation location.

    For example, for Microsoft Windows:

    set SOA_ORACLE_HOME=c:\Oracle10g
    

    For UNIX:

    setenv SOA_ORACLE_HOME /Oracle10g/
    
  3. Set the JDK.

    For example, for Microsoft Windows:

    set JAVA_HOME=<MW_HOME>/jdk160_11
    

    For UNIX:

    setenv  JAVA_HOME <MW_HOME>/jdk160_11
    
  4. Enter irca.bat on Microsoft Windows and ./irca.sh in UNIX.

    This runs the irca script to create the schemas required for BPEL, ESB, and OWSM.

  5. Enter the following information when prompted by the installer:

    • Database Host Name: your database host name

    • Port Number: the port number for your database

    • Service Name: the service name for your database

    • sys password: the password to acces your database

  6. Enter the following information when prompted by the installer:

    • Would you like to load ORABPEL schema ( y /n )

      Select yes and then enter your orabpel schema password

    • would you like to load ORAESB schema ( y /n )

      Select yes and then enter your oraesb schema password

    • would you like to load your ORAWSM schema ( y /n )

      Select yes and then enter your orawsm schema passsword

    Additionally, you can pass your system information to the installer as a command line parameter. Refer to the command line help for irca.sh to utilize this functionality.

    The orabpel, oraesb, and orawsm schemas are loaded on the Oracle Database.

2.5 Oracle SOA Suite 10.1.3.5.1 for Oracle WebLogic Server

Insert the Oracle SOA Suite 10.1.3.5.1 CD-ROM or download the installer from the following URL:

http://www.oracle.com/technology/software/products/ias/htdocs/101310.html

2.6 Install Oracle SOA Suite with Oracle WebLogic Server

This section describe how to install the Oracle SOA Suite with Oracle WebLogic Server.

Note:

Oracle Home directories referenced in this document are as follows:
  • MW_HOME - (for example, /home/user/Oracle/Middleware)

  • WL_HOME - (for example, /home/user/Oracle/Middleware/wlserver_10.3)

  • SOA_ORACLE_HOME - (for example, /home/user/Oracle/Middleware/OracleAS_1)

Complete the following steps to install Oracle SOA Suite with Oracle WebLogic Server:

  1. Go to the directory where you downloaded the Oracle SOA Suite with Oracle WebLogic Server installation package.

  2. Select with the <Download Location>Disk1/setup.exe (Microsoft Windows) or <Download Location>Disk1/runInstaller.sh (Linux) file to begin the installation.

  3. Review the Welcome screen.

    Figure 2-1 Welcome Screen

    Welcome screen for the installer
    Description of "Figure 2-1 Welcome Screen"

    Click Next.

  4. Review the Specify File Locations screen.

    Figure 2-2 Specify File Locations Screen

    Welcome screen for the installer
    Description of "Figure 2-2 Specify File Locations Screen"

    Enter the following information:

    • Name: the name for the Oracle SOA Suite with Oracle WebLogic Server installation.

    • Path: the full path where you want to install Oracle SOA Suite with Oracle WebLogic Server.

      The Oracle SOA Suite installation path must be located within the MW_HOME directory.

  5. Language Selection screen.

    Figure 2-3 Language Selection Screen

    Welcome screen for the installer
    Description of "Figure 2-3 Language Selection Screen"

    Select the language(s) which will be used for your installation.

  6. Oracle WebLogic Server Home Location screen

    Figure 2-4 Oracle WebLogic Server Home Location Screen

    Welcome screen for the installer
    Description of "Figure 2-4 Oracle WebLogic Server Home Location Screen"

    Oracle WebLogic Server must point to the wlserver_10.3 directory in the MW_HOME directory.

  7. Proxy Information for WLS screen.

    Figure 2-5 Proxy Information for WLS Screen

    Welcome screen for the installer
    Description of "Figure 2-5 Proxy Information for WLS Screen"

    Does your WLS use a proxy: select yes or no

  8. Specify Oracle WebLogic Server Proxy Information screen.

    Figure 2-6 Specify Oracle WebLogic Server Proxy Information Screen

    Welcome screen for the installer
    Description of "Figure 2-6 Specify Oracle WebLogic Server Proxy Information Screen"

    Enter the Hostname and port and non proxy host for your installation. The Proxy hosts are in the format of host1|host2.

  9. Specify SOA Schema Connect Information.

    Figure 2-7 Specify SOA Schema Connect Information Screen

    Welcome screen for the installer
    Description of "Figure 2-7 Specify SOA Schema Connect Information Screen"

    Enter the following information for your Oracle database:

    • Hostname: the host name for your database

    • Port: the port for your database installation

    • Service Name: the service name for your database installation

    • orabpel Password: the password for the orabpel schema

    • oraesb Password: the password for the oraesb schema

    • orawsm Password: the password for the orawsm schema

  10. Installation progress screen.

    Figure 2-8 Installation Progress Screen

    Welcome screen for the installer
    Description of "Figure 2-8 Installation Progress Screen"

    This screen indicates install progress.

  11. Summary Screen.

    Figure 2-9 Summary Screen

    Welcome screen for the installer
    Description of "Figure 2-9 Summary Screen"

    This screen appears at the conclusion of installation and provides details of the installation.

2.7 Execute configureSOA wrapper script

The section describes how to execute the configureSOA wrapper script.

To execute the configureSOA script, perform the following steps:

  1. Go to the SOA_ORACLE_HOME/config folder where you installed Oracle SOA Suite with Oracle WebLogic Server.

  2. Locate and execute the ./configureSOA.sh (Linux with xterm) or configureSOA.bat (Microsoft Windows).

  3. Enter your OWSM password when prompted by the configureSOA script.

    This configureSOA script performs the following tasks:

    • configures the SOA_ORACLE_HOME and WL_HOME directories

    • automatically invokes the WLS Config Wizard

2.8 Create WLS Domain for Oracle SOA Suite

After the configureSOA wrapper script has run successfully, the WLS Configuration Wizard is invoked automatically.

Complete the following steps to create the SOA Domain using the Configuration Wizard:

  1. Welcome Screen

    Figure 2-10 Create a New WebLogic Domain Screen

    Welcome screen for the installer
    Description of "Figure 2-10 Create a New WebLogic Domain Screen"

    Select Create a New WebLogic Domain.

    Click Next.

  2. Select Domain Source Screen

    Figure 2-11 Select Domain Source Screen

    Welcome screen for the installer
    Description of "Figure 2-11 Select Domain Source Screen"

    Select Generate a domain configured automatically to support the following products, then select the following product:

    • Oracle SOA Suite - 10.1.3.5.1 (Oracle_SOA1)

    Click Next.

  3. Specify Domain Name and Location Screen

    Figure 2-12 Specify Domain Name and Locations Screen

    Welcome screen for the installer
    Description of "Figure 2-12 Specify Domain Name and Locations Screen"

    Specify the following domain information:

    • Domain name: The name of the domain you want to create. The default name is base_domain.

    • Domain location: The absolute path to the directory where this domain should be created. The default location is SOA_ORACLE_HOME/user_projects/domains (for UNIX) or SOA_ORACLE_HOME\user_projects\domains (for Microsoft Windows).

    Click Next.

  4. Configure Administrator Username and Password Screen

    Figure 2-13 Configure Administrator Username and Password Screen

    Welcome screen for the installer
    Description of "Figure 2-13 Configure Administrator Username and Password Screen"

    Specify the following credentials for your administrator:

    • User name: The name of the administrator for this domain. The default name is weblogic.

    • User password: The administrator's password.

    • Description: Enter a description for this user, or leave the default description as is. This field is optional.

    The password chosen for the weblogic user is also set for the soaadmin user.

    Click Next.

  5. Configure Server Start Mode and JDK Screen

    Figure 2-14 Configure Server Start Mode and JDK Screen

    Welcome screen for the installer
    Description of "Figure 2-14 Configure Server Start Mode and JDK Screen"

    In the "WebLogic Domain Startup Mode" portion of the screen, Select either Production Mode or Development Mode.

    In the "JDK Selection" portion of the screen, select Sun SDK 1.6.0_11 from the list of available JDKs. This was one of the JDKs installed on your system when you installed Oracle WebLogic Server.

    Click Next.

  6. Configure JDBC Component Schema Screen

    Figure 2-15 Configure JDBC Component Schema Screen

    Welcome screen for the installer
    Description of "Figure 2-15 Configure JDBC Component Schema Screen"

    Configure the schema information for each data source listed on this screen. When you make changes to any field on this screen, the changes are applied to selected data sources only. For fields that are common with all data sources (for example, all data sources reside on the same database), you should select all of the data sources and make your changes. The changes are saved automatically as you type.

    After all of the information that is common to all data sources has been specified, then you will need to select individual or smaller groups of data sources and enter information that is specific to them (for example, the schema owner).

    Review the table on this screen and identify which fields you need to modify:

    • Vendor: Select the vendor for your database from the drop-down list.

    • Driver: Select the driver type from the drop-down list.

    • Password: Specify the password for the schema.

    • DBMS/Service: Specify the service name for your database. This is the database on which the schema resides.

    • Host Name: Specify the name of the machine where your database is running.

    • Port: Specify the database listen port number.

    Click Next.

  7. Test Component Schema Screen

    Figure 2-16 Test Component Schema Screen

    Welcome screen for the installer
    Description of "Figure 2-16 Test Component Schema Screen"

    Verify that the connections to your data sources are successful.

    Click Next.

  8. Select Advanced Configuration Screen

    Do not select anything on this screen.

    Use the default values for the below sections.

    Click Next.

    Go through the following steps a through i only if you want to change the default settings. Otherwise proceed to step 9:

    1. Configure the Administration Server:

      default listen port <adminport>
       SSL enabled = false
      

      The Admin Server of the created Domain will run on the newly selected port.

    2. Configure Managed Servers:

      soa10g_server1
      default listen port = 9700
      SSL enabled = false
      

      The Default port for soa10g_server1 is 9700 and has a dependency with configureSOA Wrapper script.

      If you need to configure the soa10g_server1 to run on any port other than 9700, for example 7777.

      Close this Config Wizard.

      Edit the SOA_HOME/install/SOADomain.properties file.

      Uncomment and update the OVERRIDE_HTTP_PORT property as follows.

      OVERRIDE_HTTP_PORT=7777
      

      Rerun the configureSOA wrapper script, (Section 2.7, "Execute configureSOA wrapper script").

      Choose default listen port = 7777 for soa10g_server1.

    3. Configure Clusters

      No clusters defined by default.

    4. Configure Machines

      soaMachine

      default Node Manager Listen Port = 5556

    5. Assign Servers to Machines Screen

      Figure 2-17 Assign Server to Machines Screen

      Welcome screen for the installer
      Description of "Figure 2-17 Assign Server to Machines Screen"

      soa10g_server1 is assigned to soaMachine by default

      This setting should not be changed.

    6. Target Deployments to Clusters or Servers

      Figure 2-18 Target Deployments to Clusters or Servers Screen

      Welcome screen for the installer
      Description of "Figure 2-18 Target Deployments to Clusters or Servers Screen"

      All deployments are targeted to soa10g_server1 by default.

      This setting should not be changed.

    7. Target Services to Clusters or Servers

      Figure 2-19 Target Services to Clusters or Servers Screen

      Welcome screen for the installer
      Description of "Figure 2-19 Target Services to Clusters or Servers Screen"

      All Services are targeted to soa10g_server1 by default.

      This setting should not be changed.

    8. Configure JMS File Stores

      Figure 2-20 Configure JMS File Stores Screen

      Welcome screen for the installer
      Description of "Figure 2-20 Configure JMS File Stores Screen"

      SOA10GJMSFileStore configured to use file store in the domain root directory.

      The file store location is relative path from the domain root directory.

      This can be changed if needed.

    9. Configure RDBMS Security Store Database

      The RDBMS Security Store is disabled

      This setting should not be changed.

  9. Configuration Summary Screen

    Figure 2-21 Configuration Summary Screen

    Welcome screen for the installer
    Description of "Figure 2-21 Configuration Summary Screen"

    Verify the information on this screen. Use the navigation pane on the left or the Previous button if you want to return to a previous screen to alter some portion of the configuration.

    If everything is correct, click Create.

  10. Creating Domain Screen

    Figure 2-22 Creating Domain Screen

    Welcome screen for the installer
    Description of "Figure 2-22 Creating Domain Screen"

    When the domain has been successfully created, the progress bar will be at 100% and the Done button will be active.

    The last line in the summary information is the URL of the Administration Server. You should make a note of this URL so that you can access the Administration Server after it has been started.

    Click Done to dismiss the Configuration Wizard.

For more information about configuring WebLogic domains, refer to Oracle WebLogic Server Creating WebLogic Domains Using the Configuration Wizard.

2.9 Real Application Cluster Installation

To install real application clusters (RAC) with the Oracle SOA Suite with Oracle WebLogic Server product perform the following steps:

  1. Complete the steps described in Section 2.6, "Install Oracle SOA Suite with Oracle WebLogic Server".

  2. Complete the steps described in Section 2.7, "Execute configureSOA wrapper script".

  3. Complete steps 1 through 5 in Section 2.8, "Create WLS Domain for Oracle SOA Suite".

Then complete the following steps to install a RAC setup with Oracle SOA Suite with Oracle WebLogic Server:

  1. Configure JDBC Component Schema Screen

    Figure 2-23 Configure JDBC Component Schema Screen

    Welcome screen for the installer
    Description of "Figure 2-23 Configure JDBC Component Schema Screen"

    Select the Configure selected component schemas as RAC multi data source schemas in the next panel checkbox.

    In this step, you change both BPEL and ESB schemas and select to configure RAC.

    Click Next.

  2. Configure RAC Multi Data Source Component Screen

    Figure 2-24 Configure RAC Multi Data Source Component Screen

    Welcome screen for the installer
    Description of "Figure 2-24 Configure RAC Multi Data Source Component Screen"

    Select the BPEL Schema and enter the following information:

    • Service Name

    • User Name/Password

    For each rack node

    • Host Name

    • Instance Name

    • Port Number

    Select ESB Schema and enter the following information:

    • Service Name

    • User Name/Password

    For eachRAC node

    • Host Name

    • Instance Name

    • Port Number

    Click Next.

  3. Complete steps 7 through 9 as described in Section 2.8, "Create WLS Domain for Oracle SOA Suite".

  4. Test Component Schema Screen

    Figure 2-25 Test Component Schema Screen

    Welcome screen for the installer
    Description of "Figure 2-25 Test Component Schema Screen"

    Verify that the connections to your data sources are successful.