The following sections describe how to install and configure Oracle Fusion Middleware with IBM WebSphere:
Task 1: Review the System Requirements and Certification Information
Task 3: Identify a Database and Install the Required Database Schemas
Task 7: Configure Your Oracle Fusion Middleware Components in a New IBM WebSphere Cell
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/technology/software/products/ias/files/fusion_requirements.htm
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/technology/software/products/ias/files/fusion_certification.html
For this installation and configuration procedure, you will need to obtain the following software:
IBM WebSphere 7.0 and any required Fix Packs for the IBM WebSphere software.
At the time this document was published, the latest Fix Pack was Fix Pack 13 (7.0.0.13). For more information, see Section 2.4.1, "IBM Online Resources for Obtaining and Installing the IBM WebSphere Software".
For specific information the software requirements, refer to Section 2.1, "Task 1: Review the System Requirements and Certification Information".
Oracle Fusion Middleware Repository Creation Utility 11g (11.1.1.4.0) or later
One of the following Oracle Fusion Middleware software products, which are supported on IBM WebSphere:
Oracle SOA Suite 11g (11.1.1.4.0) or later
Oracle Application Development Runtime 11g (11.1.1.4.0) or later
Note:
The version numbers included here were accurate at the time this document was published. For specific software requirements, refer to the references in Section 2.1, "Task 1: Review the System Requirements and Certification Information".For information about where to download the software, refer to "Obtain the Oracle Fusion Middleware Software" in the Oracle Fusion Middleware Installation Planning Guide.
Some Oracle Fusion Middleware products, such as Oracle SOA Suite, require a metadata repository. 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.
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.
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:
IBM Online Resources for Obtaining and Installing the IBM WebSphere Software
Important Considerations When 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:
To obtain and install the IBM WebSphere software, refer to the IBM WebSphere documentation. For more information, see Section 1.4, "Documentation Resources When Using Oracle Fusion Middleware on IBM WebSphere".
For more information about the Fix Packs available for IBM WebSphere 7.0, refer to the Fix list for IBM WebSphere Application Server V7.0 on the IBM Support Web site.
You install the Fix Packs using the IBM WebSphere Update Installer. For more information, see the information about the Maintenance Download Wizard for WebSphere Application Server V7.0 on the IBM Support Web site.
When you perform the installation, note the following requirements for Oracle Fusion Middleware products:
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.
Create the home directory for the IBM WebSphere software on the same host where you plan to install the Oracle Fusion Middleware software.
You will be asked to identify the location of the IBM WebSphere directory when you configure Oracle Fusion Middleware.
The following sections provide information on installing Oracle Fusion Middleware with IBM WebSphere:
General Installation Instructions for the Supported Oracle Fusion Middleware Products
Special Instructions When Installing Oracle Fusion Middleware with IBM WebSphere
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 |
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:
WAS_APPSERVER_HOME/java
For example, if you are using the default location for a typical IBM WebSphere application server directory:
diskname/IBM/WebSphere/AppServer/java
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 with Oracle WebLogic Server, you create the Middleware home before you install the Oracle Fusion Middleware software, 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 with 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/
If you are installing and configuring Oracle SOA Suite on IBM WebSphere, then you must install and configure a supported LDAP server before you can configure the Oracle SOA Suite components in a new IBM WebSphere cell.
For more information, see Section 4.1, "Configuring Oracle SOA Suite Users and Groups in an External LDAP Server on IBM WebSphere".
To configure Oracle Fusion Middleware in a new 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. For more information.For more information about using the wsadmin command-line utility, see Section 3.1.3, "Using the Oracle Fusion Middleware wsadmin Commands".
For more information about configuring components with wsadmin, see "Using wsadmin to Configure Oracle Fusion Middleware" in the Oracle Fusion Middleware Configuration Guide for IBM WebSphere Application Server.
To configure your Oracle Fusion Middleware product in a new IBM WebSphere cell:
If you have installed the Oracle Fusion Middleware schemas in an IBM DB2 database, then be sure to perform the required pre-configuration steps.
For more information, see "Before You Begin" in the Oracle Fusion Middleware Configuration Guide for IBM WebSphere Application Server.
Start the Oracle Fusion Middleware Configuration Wizard by running the following command in the Oracle home of the product you want to configure:
On Linux systems:
MW_HOME/ORACLE_HOME/common/bin/was_config.sh
On Windows systems:
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 above 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 Linux system:
SOA_ORACLE_HOME/common/bin/was_config.sh
Follow the instructions on the screen to configure a new IBM WebSphere cell.
For more information, see "Creating a New Cell" in Oracle Fusion Middleware Configuration Guide for IBM WebSphere Application Server.
Note the following as you advance through the Configuration Wizard:
Be sure to make a note of the values you enter on the Specify Cell, Profile, and Node Name Information screen. You will need these later when you are starting and managing the cell. In particular, make note of the values you enter in the Deployment Manager Profile Name field and the Application Server Profile Name field.
When the Add Products to Cell screen appears, refer to "Fusion Middleware Product Templates" in the Oracle Fusion Middleware Domain Template Reference if you have questions about what capabilities are configured when you select each template.
If you select a product that requires a database schema, you will be prompted for database connection information for each required schema. To fill out this screen, use the database and schema information you noted in Section 2.3, "Task 3: Identify a Database and Install the Required Database Schemas".
When you are prompted for advanced options, you can click Next and use the default settings. Refer to Section 1.3.2, "Understanding the Topology of Oracle Fusion Middleware on IBM WebSphere" for information on the topologies that will be created using the default settings.
If you wish to modify the default settings (for example, if you want to target the products to different servers in the cell), refer to Oracle Fusion Middleware Configuration Guide for IBM WebSphere Application Server.
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.
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":
Start the Deployment Manager:
Navigate to the following directory in the IBM WebSphere home and enter the following command:
On UNIX operating systems:
profiles/deployment_mgr_name/bin/startManager.sh -profileName dmgr_profileName
On Windows operating systems:
profiles\deployment_mgr_name\bin\startManager.cmd -profileName dmgr_profileName
For example, on a UNIX operating system:
/disk01/IBM/WebSphere/ApplicationServer/profiles
/Dmgr01/bin/startManager.sh -profileName Dmgr01
Start the node:
Navigate to the following directory in the IBM WebSphere home and enter the following command:
On UNIX operating systems:
profiles/profile_name/bin/startNode.sh -profileName profileName
On Windows operating systems:
profiles\profile_name\bin\startNode.cmd -profileName profileName
For example, on a UNIX operating system:
/disk01/IBM/WebSphere/ApplicationServer/profiles
/Custom01/bin/startNode.sh -profileName custom01
Start the OracleAdminServer server:
Navigate to the following directory in the IBM WebSphere home and enter the following command:
On UNIX operating systems:
profiles/profile_name/bin/startServer.sh OracleAdminServer -profileName profileName
On Windows operating systems:
profiles\profile_name\bin\startServer.cmd OracleAdminServer -profileName profileName
For example, on a UNIX operating system:
/disk01/IBM/WebSphere/ApplicationServer/profiles
/Custom01/bin/startServer.sh OracleAdminSErver
-profileName Custom01
If you have configured Oracle SOA Suite on IBM WebSphere, then start the Oracle SOA Suite server:
Navigate to the following directory in the IBM WebSphere home and enter the following command:
On UNIX operating systems:
profiles/profile_name/bin/startServer.sh soa_server1 -profileName profileName
On Windows operating systems:
profiles\profile_name\bin\startServer.cmd soa_server1 -profileName profileName
For example, on a UNIX operating system:
/disk01/IBM/WebSphere/ApplicationServer/profiles
/Custom01/bin/startServer.sh soa_server1
-profileName Custom01
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.