Skip Headers
Oracle® Fusion Middleware Third-Party Application Server Guide
11g Release 1 (11.1.1.8)
Part Number E17852-04
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

This chapter describes 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".

This chapter contains the following tasks:

2.1 Task 1: Review the System Requirements and Certification Information

Before performing any upgrade or installation you should read the Oracle Fusion Middleware System Requirements and Specifications 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.

In addition, you should review the Oracle Fusion Middleware Supported System Configurations. The certification document covers supported installation types, platforms, operating systems, databases, JDKs, and third-party products.

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 Fusion Middleware Installing and Configuring Oracle WebCenter Content.

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 Oracle Fusion Middleware Installation Guide for Application Developer

Oracle SOA Suite

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

Oracle WebCenter Portal

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

Oracle WebCenter Content

"Using the Installer for Oracle WebCenter Content" in Oracle Fusion Middleware Installing and Configuring Oracle WebCenter Content

Oracle Business Intelligence

"Installing Oracle Business Intelligence" in Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence

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

  • For information on Oracle Business Intelligence, see Section 10.2, "Differences Installing and Configuring Oracle Business Intelligence on IBM WebSphere."

  • 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 Your Oracle Fusion Middleware Components in a New IBM WebSphere Cell

Note:

For information on Oracle Business Intelligence, see Section 10.2.2, "Configuring Oracle Business Intelligence 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.6.1 General Information About Using the Configuration Wizard on IBM WebSphere

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

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

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

2.6.3 Troubleshooting Errors When Configuring a Cell on Windows 2003 and 2008

When IBM WebSphere is installed on Windows 2003 or Windows 2008, the following error sometimes displays when you attempt to create a cell:

WebSphere Profile Update Failed!
No Changes Were Saved To The WebSphere Profile
Profile Location: x:\mydir\APPSER~1\profiles\Dmgr02
Reason Exception saving changes to WebSphere configuration

The issue is due to the Jython libraries shipped with IBM WebSphere. As a workaround:

  1. Locate and edit the file:

    WAS_HOME\optionalLibraries\jython\Lib\javaos.py

  2. Locate the function: _getOsType

  3. Edit the _osTypeMap variable to return "nt" as the default.

    _osTypeMap = ( 
        ( "nt", r"(nt)|(Windows NT)|(Windows NT 4.0)|(WindowsNT)|" 
                r"(Windows 2000)|(Windows XP)|(Windows CE)" ), 
        ( "dos", r"(dos)|(Windows 95)|(Windows 98)|(Windows ME)" ), 
        ( "mac", r"(mac)|(MacOS.*)|(Darwin)" ), 
        ( "None", r"(None)" ),
        ( "nt", r"(.*)" ), # default - posix seems to vary mast widely 
        )

  4. Save the changes.

2.7 Task 7: 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.

Notes:

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

For information on starting Oracle BI components on IBM WebSphere, see Section 10.2.5, "Starting and Stopping Components on IBM WebSphere."

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.6, "Task 6: 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

Oracle Business Intelligence

bi_server1

2.8 Task 8: 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.

2.9 Task 9: Install and 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

Important Note:

To configure an LDAP-based identity store for Oracle Fusion Middleware, see Section 9.1, "IBM WebSphere Identity Stores".

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

2.9.2 Oracle Fusion Middleware Component-Specific LDAP Information

For information about configuring users and roles for each Oracle Fusion Middleware component that is supported on IBM WebSphere, see the appropriate section below:

Go to previous page
Previous		 Go to next page
Next
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