Skip Headers
Oracle® Fusion Middleware Third-Party Application Server Guide
11g Release 1 (11.1.1.6)

Part Number E17852-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

2 Installing and Configuring Oracle Fusion Middleware on IBM WebSphere

The following sections describe how to install and configure Oracle Fusion Middleware with IBM WebSphere.

Note:

this chapter provides basic information about how to install and configure a single instance of Oracle Fusion Middleware on IBM WebSphere. If you are interested in configuring a high availability environment on IBM WebSphere, then review the content in this chapter, and then see Section 3.4, "Configuring Oracle Fusion Middleware High Availability on IBM WebSphere".

2.1 Task 1: Review the System Requirements and Certification Information

Before performing any upgrade or installation you should read the system requirements 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/technetwork/middleware/ias/downloads/fusion-requirements-100147.html

In addition, you should read the certification document. The certification document covers supported installation types, platforms, operating systems, databases, JDKs, and third-party products:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

2.2 Task 2: Obtain the Necessary Software Media or Downloads

For this installation and configuration procedure, you will need to obtain the following software:

2.3 Task 3: Identify a Database and Install the Required Database Schemas

The following Oracle Fusion Middleware products require a metadata repository with required schemas to be installed in a supported database:

You cannot configure these products without first installing the required schemas in a supported database.

To create or update schemas in a database, use the Repository Creation Utility (RCU).

Note:

It is recommended that all metadata repositories reside on a database at the same site as the products to minimize network latency issues.

For information about identifying the schemas required for specific Oracle Fusion Middleware products, as well as information about the database requirements and running RCU, refer to Oracle Fusion Middleware Repository Creation Utility User's Guide.

If you are installing Oracle WebCenter Content, then also refer to "Creating Oracle WebCenter Content Schemas with the Repository Creation Utility" in the Oracle WebCenter Content Installation Guide.

For information on the databases supported by Oracle Fusion Middleware, see the certification information described in Section 2.1, "Task 1: Review the System Requirements and Certification Information".

Make a note of the database connection information and the passwords for the schemas you create with the Repository Creation Utility. You will need these later when you configure the Oracle Fusion Middleware products.

2.4 Task 4: Install the IBM WebSphere Software

Oracle Fusion Middleware supports both the IBM WebSphere Application Developer - Network Deployment (ND) and IBM WebSphere Application Server (AS) products.

To install and configure Oracle Fusion Middleware with IBM WebSphere, you must first install (but not configure) IBM WebSphere 7.0 and apply the latest Fix Pack for IBM WebSphere 7.0.

Refer to the following sections for more information:

2.4.1 IBM Online Resources for Obtaining and Installing the IBM WebSphere Software

Refer to the following IBM resources for more information.

Note that Oracle is not responsible for the content in the following links. These references are provided for convenience only. Be sure to refer to the IBM documentation provided with or referenced by your IBM WebSphere software distribution:

2.4.2 Important Considerations Before Installing the IBM WebSphere Software

Before you perform the IBM WebSphere installation, note the following requirements for Oracle Fusion Middleware products:

2.4.2.1 Using the Correct IBM WebSphere Installer for Your Platform

Note that like Oracle WebLogic Server, IBM WebSphere is available for different platforms. Some platforms, such as Linux 64-bit platforms, require unique IBM WebSphere installers.

Before you begin your IBM WebSphere installation, be sure you have obtained the correct IBM WebSphere installer for your platform.

2.4.2.2 About the Sample Applications and Default Profiles During the IBM WebSphere Installation

Do not install any sample applications or create any profiles during the IBM WebSphere installation process.

The goal is to install the IBM WebSphere software on disk in a directory available to the Oracle Fusion Middleware software installation, which you will perform later. You will use the Oracle Fusion Middleware Configuration wizard to configure the required IBM WebSphere profiles.

2.4.2.3 About the WAS_HOME Directory Path

When you install the IBM WebSphere software, you are prompted for the location where you want to install the software. For the purposes of this documentation, this location is later referred to as the WAS Home, or WAS_HOME in examples.

If you accept the default values that are provided during the installation, then the WAS_HOME is installed in the following directory structure:

DISK/IBM/WebSphere/Application Server

Create the WAS_HOME for the IBM WebSphere software on the same host where you plan to install the Oracle Fusion Middleware software.

Make a note of this path. You will be asked to identify the location of the IBM WebSphere directory when you configure Oracle Fusion Middleware.

2.5 Task 5: Install Oracle Fusion Middleware

The following sections provide information on installing Oracle Fusion Middleware with IBM WebSphere:

2.5.1 General Installation Instructions for the Supported Oracle Fusion Middleware Products

For general instructions on installing any of the Oracle Fusion Middleware products that are supported on IBM WebSphere, refer to Table 2-1.

Table 2-1 Locating Installation Information for Oracle Fusion Middleware Products

Product Installation Instructions

Oracle Application Developer Runtime

"Installation Instructions" in the Oracle Fusion Middleware Installation Guide for Application Developer

Oracle SOA Suite

"Installation Instructions" in the Oracle Fusion Middleware Installation Guide for Oracle SOA Suite and Oracle Business Process Management Suite

Oracle WebCenter Portal

"Installing Oracle WebCenter Portal" in the Oracle Fusion Middleware Installation Guide for Oracle WebCenter Portal

Oracle WebCenter Content

"Using the Installer for Oracle WebCenter Content" in the Oracle WebCenter Content Installation Guide


2.5.2 Special Instructions When Installing Oracle Fusion Middleware with IBM WebSphere

Note the following special instructions that apply when you are installing Oracle Fusion Middleware products on IBM WebSphere:

  • When you are prompted to specify a JRE/JDK location, you can specify the following directory in the IBM WebSphere home:

    (UNIX) WAS_HOME/java
    (Windows) WAS_HOME\java
    

    For example, if you are using the default location for a typical IBM WebSphere Application Server directory on a UNIX operating system:

    diskname/IBM/WebSphere/AppServer/java
    
  • Before installing Oracle WebCenter Content, you need to change the Java socket factories to the default JSSE implementation. For more information, see Section 6.1.1, "Changing Java Socket Factories in the IBM JDK."

  • When you are prompted to provide a Middleware home, note that you can enter a new Middleware home directory path.

    When you install Oracle Fusion Middleware products on Oracle WebLogic Server, you create the Middleware home, when you install Oracle WebLogic Server. This is because Oracle WebLogic Server is included in the Middleware home.

    In contrast, when you install Oracle Fusion Middleware on IBM WebSphere, you create the Middleware home when you install the Oracle Fusion Middleware software. This is because the IBM WebSphere software is not installed inside the Middleware home. It is installed in a separate directory structure.

  • When you select IBM WebSphere as your application server and you are prompted for the Application Server Location, enter the path to the IBM WebSphere application server directory you created in Section 2.4, "Task 4: Install the IBM WebSphere Software".

    For example:

    diskname/IBM/WebSphere/AppServer/
    

2.6 Task 6: Configure an LDAP Server

Most Oracle Fusion Middleware components require a supported LDAP server. However, an LDAP server is not automatically installed and configured when you install Oracle Fusion Middleware components on IBM WebSphere. Oracle Fusion Middleware components do not support WebSphere's built-in file-based user registry

Before you can configure Oracle SOA Suite, Oracle WebCenter Portal, Oracle WebCenter Content, or Oracle Fusion Middleware Web services in a new IBM WebSphere cell, you must install and configure a supported external LDAP server, such as Oracle Internet Directory.

2.6.1 General Information About Supported LDAP Servers and Identity Stores

For information about the LDAP servers that Oracle Fusion Middleware supports, see the certification information on the Oracle Technology Network (OTN):

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

For information about installing a supported LDAP server, see Section 8.1, "IBM WebSphere Identity Stores".

2.7 Task 7: Configure Your Oracle Fusion Middleware Components in a New IBM WebSphere Cell

To configure Oracle Fusion Middleware components in an IBM WebSphere environment, you use a special version of the Oracle Fusion Middleware Configuration Wizard.

This section describes how to use the Configuration Wizard to configure your Oracle Fusion Middleware products in a simple IBM WebSphere cell. For complete information about using the Oracle Fusion Middleware Configuration Wizard, including information about adding servers and clusters to a cell, refer to the Oracle Fusion Middleware Configuration Guide for IBM WebSphere Application Server.

Note:

The instructions here describe how to use the Configuration Wizard to configure your components. However, you can also use the WebSphere wsadmin command-line utility to configure your Oracle Fusion Middleware components.

To configure your Oracle Fusion Middleware product in a new IBM WebSphere cell:

  1. If you have installed the Oracle Fusion Middleware schemas in an IBM DB2 database, then be sure to perform the required preconfiguration steps.

    For more information, see "Before You Begin" in the Oracle Fusion Middleware Configuration Guide for IBM WebSphere Application Server.

  2. Start the Oracle Fusion Middleware Configuration Wizard by running the following command in the Oracle home of the product you want to configure:

    (UNIX) MW_HOME/ORACLE_HOME/common/bin/was_config.sh
    (Windows) MW_HOME\ORACLE_HOME\common\bin\was_config.cmd
    

    Consider the following notes when starting the Configuration Wizard:

    • Be sure to start the IBM WebSphere version of the Configuration Wizard. For more information, see "Starting the Configuration Wizard" in Oracle Fusion Middleware Creating WebSphere Cells Using the Configuration Wizard.

    • In the preceding example, note that you must replace the ORACLE_HOME with the path to the Oracle home of the product you are about to configure. For example, if you are configuring an Oracle SOA home, enter the following on a UNIX system:

      SOA_ORACLE_HOME/common/bin/was_config.sh
      
  3. Follow the instructions on the screen to configure a new IBM WebSphere cell.

    Refer to the following for more information:

2.7.1 General Information About Using the Configuration Wizard on IBM WebSphere

Note the following information as you advance through the Configuration Wizard:

2.7.2 Component-Specific Information About Using the Configuration Wizard on IBM WebSphere

For component-specific configuration information, refer to the following:

2.8 Task 8: Start the IBM WebSphere Servers

After you finish configuring the Oracle Fusion Middleware software successfully, you can start the IBM WebSphere Deployment Manager, Node, and Servers.

The following procedure shows the sequence you must use to start the deployment manager, the node, and the servers in the cell.

Note:

Before you start any Oracle WebCenter Content Node or Server, see "Verifying the Oracle WebCenter Content Configuration" in the Oracle WebCenter Content Installation Guide for information about postinstallation tasks that need to be completed before you log in to a server for the first time.

In the following examples, replace the names of the deployment manager and profile name with the values you entered in the Configuration Wizard in Section 2.7, "Task 7: Configure Your Oracle Fusion Middleware Components in a New IBM WebSphere Cell":

  1. Start the Deployment Manager:

    Navigate to the following directory in the IBM WebSphere home and enter the following command:

    (UNIX) profiles/deployment_mgr_name/bin/startManager.sh 
                     -profileName dmgr_profileName
    (Windows) profiles\deployment_mgr_name\bin\startManager.cmd 
                     -profileName dmgr_profileName
    

    For example, on a UNIX operating system:

    /disk01/IBM/WebSphere/AppServer/profiles
            /Dmgr01/bin/startManager.sh -profileName Dmgr01
    
  2. Start the node:

    Navigate to the following directory in the IBM WebSphere home and enter the following command:

    (UNIX) profiles/profile_name/bin/startNode.sh -profileName profileName
    (Windows) profiles\profile_name\bin\startNode.cmd -profileName profileName
    

    For example, on a UNIX operating system:

    /disk01/IBM/WebSphere/AppServer/profiles /Custom01/bin/startNode.sh
                       -profileName custom01
    
  3. Start the OracleAdminServer server:

    Navigate to the following directory in the IBM WebSphere home and enter the following command:

    (UNIX) profiles/profile_name/bin/startServer.sh OracleAdminServer
             -profileName profileName
    (Windows) profiles\profile_name\bin\startServer.cmd OracleAdminServer
             -profileName profileName
    

    For example, on a UNIX operating system:

    /disk01/IBM/WebSphere/AppServer/profiles/Custom01/bin/startServer.sh
             OracleAdminSErver 
             -profileName Custom01
    
  4. Start any additional servers that were configured as part of your IBM WebSphere cell.

    After you start the OracleAdminServer, you can start the other servers using the IBM WebSphere Administrative Console or Oracle Enterprise Manager Fusion Middleware Control. For more information, see Section 3.1, "Summary of the Oracle Fusion Middleware Management Tools on IBM WebSphere".

    Alternatively, you can use the startServer script, as follows:

    Navigate to the following directory in the IBM WebSphere home and enter the following command:

    (UNIX) profiles/profile_name/bin/startServer.sh server_name
             -profileName profileName
    profiles\profile_name\bin\startServer.cmd server_name
             -profileName profileName
    

    For example, for an Oracle SOA Suite cell on a UNIX operating system:

    /disk01/IBM/WebSphere/AppServer/profiles
            /Custom01/bin/startServer.sh soa_server1 
             -profileName Custom01
    

    The typical servers that are configured for each of the Oracle Fusion Middleware components are listed in Table 2-2.

Table 2-2 Typical Oracle Fusion Middleware Component-Specific Managed Servers in an IBM WebSphere Cell

Component Typical Managed Servers

Oracle SOA Suite

soa_server1, bam_server1

Oracle WebCenter Portal

WC_Spaces, WC_Collaboration, WC_Portlet, WC_Utilities

Oracle WebCenter Content

UCM_server1, URM_server1, or IBR_server1


2.9 Task 9: Verify the Configuration of the IBM WebSphere Cell

To verify the installation, use the IBM WebSphere Administration Console and Oracle Enterprise Manager Fusion Middleware Control to verify that the management tools are working and the servers are up and running.

Refer to Section 3.1, "Summary of the Oracle Fusion Middleware Management Tools on IBM WebSphere" for more information on locating the URLs for these Web-based management tools.