Setting up the Oracle Web Services Manager High-Availability (HA) Topology

Purpose

This OBE tutorial describes and shows how to set up the Oracle Web Services Manager (Oracle WSM) high availability solution and topology by installing multiple application server instances and clustering them. You then install two stand-alone Oracle WSM instances on two application server instances, which also share a common Oracle database. You also install one Oracle HTTP Server (OHS) for routing HTTP requests to the two application server instances.

Note: In this tutorial, all the three application server instances are installed on the same machine for the sake of simplicity. In real world, the three application server installations would be installed in three different machines.

Time to Complete

Approximately 2 hours

Topics

This OBE tutorial covers the following topics:

 Prerequisites
 Creating the Oracle WSM Schema in the Oracle Database 10g Instance
 Installing the First Application Server Instance (J2EE Server)
 Installing the Second Application Server Instance (J2EE Server)
 Installing the Third Application Server Instance (Stand-Alone OHS)
 Clustering Application Server Instances
 Configuring the OHS as a Loadbalancer for Two J2EE Server Instances
 Installing the Stand-Alone Oracle Web Services Manager (10.1.3.1.0) on the First Application Server Instance
 I nstalling the Oracle Application Server 10g Release 3 Patch Set 3 (10.1.3.3.0) on the First Instance
 Installing the Stand-Alone Oracle Web Services Manager (10.1.3.1.0) on the Second Application Server Instance
 Installing the Oracle Application Server 10g Release 3 Patch Set 3 (10.1.3.3.0) on the Second Instance
 Summary
 Related Information

Viewing Screenshots

 Place the cursor over this icon to load and view all the screenshots for this tutorial. (Caution: Because this action loads all screenshots simultaneously, response time may be slow depending on your Internet connection.)

Note: Alternatively, you can place the cursor over each individual icon in the following steps to load and view only the screenshot associated with that step.

 

Prerequisites

Before starting this tutorial, you should:

  1. Download and install the Oracle Database 10g Release 2 instance for the Windows platform. You also need to download and install the Oracle database 10g Release 2 (10.2.0.3) Patch Set from http://metalink.oracle.com. For installation instructions, refer to the Oracle Database 10g Release 2 (10.2) documentation .
  2. Download Oracle Application Server 10g Release 3 (10.1.3.1.0) .
  3. Download stand-alone Oracle Web Services Manager 10g (10.1.3.1.0) .
  4. Download Oracle Application Server 10g Release 3 Patch set 3 (10.1.3.3.0) from http://metalink.oracle.com (search for patch number 6148874).

Back to Topic List

 

Creating the Oracle WSM Schema in the Oracle Database 10g Instance

To implement a high availability solution for multiple Oracle WSM (ORAWSM) components, they need to share a common database. Therefore, you prepare the Oracle database 10g with the schema required to run the Oracle WSM components. Execute the following steps to install the ORAWSM schema in the Oracle database:

1.

Open a command prompt window and set the ORACLE_HOME environment variable to the installed Oracle database home.

 

2.

Change your current working directory to the <SOA_101310>\install\soa_schemas\irca directory.

Note: <SOA_101310> is the location where you have extracted the SOA installables and the setup files. For this tutorial, the location is C:\Downloads\SOA.

 

3.

Run the irca.bat script using the following command:

irca ORAWSM "localhost 1521 orcl" oracle -overwrite ORAWSM

Enter oracle as the password, when asked by the executing script.

 

4.

Confirm that the creation of each database schema is successful by observing the messages in the command window. Close the window when completed.

 

Back to Topic List

 

Installing the First Application Server Instance (J2EE Server)

Install the first Oracle Application Server 10g Release 3 (10.1.3.1.0) instance by executing the following steps:

Note : Install the J2EE server component only for this application server installation.

1.

Launch the application server installer by executing the setup.exe file.

 

2.

On the Oracle Application Server SOA Suite 10.1.3.1.0 Installation screen, select the Advanced Install option and click Next.

Note: Click Yes in the Warning window.

 

3.

On the Select Installation Type screen, select J2EE Server (459 MB) and click Next.

 

4.

On the Specify Port Configuration Options screen, accept the default setting and click Next.

 

5.

On the Administration Settings screen, specify the following details and click Next.

Properties

Value

AS Instance Name

soa1

AS Administrator Password

welcome1

Confirm AS Administrator Password welcome1
OC4J Instance Name home

Note: Select the Configure this as an Administrator OC4J instance option.

 

6.

On the Cluster Topology Configuration screen, accept the defaults and click Next.

 

7.

On the Summary screen, verify the installation settings and click Install.

 

8.

On the End of Installation screen, click Exit to complete the installation.

 

Back to Topic List

 

Installing the Second Application Server Instance (J2EE Server)

Install the second Oracle Application Server 10g Release 3 (10.1.3.1.0) instance by executing the following steps:

Note : Install the J2EE server component only for this application server installation.

1.

Launch the application server installer by executing the setup.exe file.

 

2.

On the Oracle Application Server SOA Suite 10.1.3.1.0 Installation screen, select the Advanced Install option and click Next.

Note: Click Yes in the Warning window.

 

3.

On the Select Installation Type screen, select J2EE Server (459 MB) and click Next.

 

4.

On the Specify Port Configuration Options screen, accept the default setting and click Next.

 

5.

On the Administration Settings screen, specify the following details and click Next.

Properties

Value

AS Instance Name

soa2

AS Administrator Password

welcome1

Confirm AS Administrator Password welcome1
OC4J Instance Name home

 

6.

On the Cluster Topology Configuration screen, accept the defaults and click Next.

 

7.

On the Summary screen, verify the installation settings and click Install.

 

8.

On the End of Installation screen, click Exit to complete the installation.

 

Back to Topic List

 

Installing the Third Application Server Instance (Stand-Alone OHS)

Install the third Oracle Application Server 10g Release 3 (10.1.3.1.0) instance by executing the following steps:

Note : The stand-alone Oracle HTTP Server (OHS) installation acts as an HTTP loadbalancer for the two J2EE server instances that you previously installed. By default, the OHS is installed on HTTP port 80. If the port is not available, it will take the next immediate available port.

1.

Launch the application server installer by executing the setup.exe file.

 

2.

On the Oracle Application Server SOA Suite 10.1.3.1.0 Installation screen, select the Advanced Install option and click Next.

Note: Click Yes in the Warning window.

 

3.

On the Select Installation Type screen, select the Web Server (351 MB) option and click Next.

 

4.

On the Specify Port Configuration Options screen, accept the default setting and click Next.

 

5.

On the Specify Instance Name screen, enter the instance name as ohs1 and click Next.

 

6.

On the Cluster Topology Configuration screen, accept the defaults and click Next.

 

7.

On the Summary screen, verify the installation settings and click Install.

 

8.

On the End of Installation screen, click Exit to complete the installation.

 

Back to Topic List

 

Clustering Application Server Instances

A cluster topology is defined as two or more connected Oracle Application Server nodes. Clustering enables providing high availability solution of J2EE servers by installing multiple J2EE instances on multiple hosts. In this section, you create an Oracle cluster by using static node lists. Execute the following steps to perform this task:

1.

Determine the listener ports for each application server instance by looking in each of the three <ORACLE_HOME>\opmn\conf\opmn.xml files for the attribute called remote of the port element.

Note : <ORACLE_HOME> is the location where you have installed the application server instances. For example, in this tutorial, <ORACLE_HOME> for the first application server instance is C:\product\10.1.3.1\OracleAS_1 .

In this tutorial, the following are the values of the remote attribute for the three specific application server instances:

  • soa1 instance is listening on 6200.

  • soa2 instance is listening on 6201.

  • ohs1 instance is listening on 6202.

 

2.

Add the following code in the opmn.xml file for the three application server instances to ensure that the OPMN binds to the host name.

<ipaddr request="edixr4p1.us.oracle.com " remote=" edixr4p1.us.oracle.com "/>

Add the <ipaddr> element under the <notification-server> element in the opmn.xml file (as shown below).

Note: In this tutorial, the host name is edixr4p1.us.oracle.com

 

3.

Add the following code in the opmn.xml file of the first application server instance and save it. The code enables all OPMN servers to start communicating with each other (you must specify the same for the other two application server instances).

<notification-server>
...
  <topology>
    <nodes list="edixr4p1.us.oracle.com:6202, edixr4p1.us.oracle.com:6201"/>
  </topology>
...
</notification-server>

 

4.

Restart OPMN for the first application server instance. Open a command prompt window, change your current working directory to the <ORACLE_HOME>\opmn\bin directory, and execute the following command:

opmnctl stopall

To start OPMN and all other OPMN-managed processes, execute the following command:

opmnctl startall

 

5.

Add the following set of code in the opmn.xml file of the second application server instance and save the file.

<notification-server>
  <ipaddr request=" edixr4p1.us.oracle.com " remote=" edixr4p1.us.oracle.com "/>
  ...
  <topology>
    <nodes list="edixr4p1.us.oracle.com:6200, edixr4p1.us.oracle.com:6202"/>
  </topology>
  ...
</notification-server>

Note: edixr4p1.us.oracle.com is the host name used for this tutorial. Specify the host name of the machine where you are executing this tutorial.

 

6.

Restart OPMN for the second application server instance. In the command prompt window, change your current working directory to the second application server instance's <ORACLE_HOME>\opmn\bin directory and execute the following command:

opmnctl stopall

To start the OPMN and all other OPMN-managed processes, execute the following command:

opmnctl startall

 

7.

Add the following set of code in the opmn.xml file of the third application server instance (stand-alone OHS) and save the file.

<notification-server>
  <ipaddr request=" edixr4p1.us.oracle.com " remote=" edixr4p1.us.oracle.com "/>
  ...
  <topology>
    <nodes list="edixr4p1.us.oracle.com:6200, edixr4p1.us.oracle.com:6201"/>
  </topology>
  ...
</notification-server>

 

8.

Restart OPMN for the third application server instance. In the command prompt window, change you current working directory to the third application server instance's <ORACLE_HOME>\opmn\bin directory and execute the following command:

opmnctl stopall

To start OPMN and all other OPMN-managed processes, execute the following command:

opmnctl startall

 

9.

Validate that you have a cluster topology configured by executing the following command in each <ORACLE_HOME>\opmn\bin directory. Ensure that all three members show up.

opmnctl status @cluster

 

Back to Topic List

 

Configuring the OHS as a Loadbalancer for Two J2EE Server Instances

Modify the opmn.xml file of the first and second application server instances to enable routing from the Web server (OHS) to two J2EE server instances. To perform this task, execute the following steps:

1.

Open the opmn.xml file of the third application server instance (stand-alone OHS) and determine the port range of the ajp port.

 

2.

Modify the opmn.xml file in the first application server instance to use the AJP port range and listen for AJP requests (instead of HTTP requests).

 

3.

Restart OPMN for the first application server instance. In the command prompt window, change you current working directory to the first application server instance's <ORACLE_HOME>\opmn\bin directory and execute the following command:

opmnctl stopall

To start OPMN and all other OPMN-managed process, execute the following command:

opmnctl startall

 

4.

Modify the opmn.xml file in the second application server instance to use the AJP port range and listen for AJP requests (instead of HTTP requests).

 

5.

Restart OPMN for the second application server instance. In the command prompt window, change you current working directory to the second application server instance's <ORACLE_HOME>\opmn\bin directory and execute the following command:

opmnctl stopall

To start OPMN and all other OPMN-managed processes, execute the following command:

opmnctl startall

 

6.

Log in to the Application Server Control of the first application server instance. You should see a topology like the one depicted in the screenshot.

Note : Provide the loadbalancer's HTTP port in the URL to access the Application Server Control, instead of the first application server HTTP port. In this tutorial, the loadbalancer's HTTP port is set to 80. Therefore, the Application Server Control's URL is given as:

http://edixr4p1.us.oracle.com: 80/em

 

Back to Topic List

 

Installing the Stand-Alone Oracle Web Services Manager (10.1.3.1.0) on the First Application Server Instance

To perform the installation task, execute the following steps:

1.

Launch the Oracle installer by executing the setup.exe file.

 

2.

On the Oracle Web Services Manager 10g (10.1.3.1.0) Installation screen, enter the following details and click Next.

Properties

Value

Installation Directory

 

C:\product\10.1.3.1\OracleAS_1

Note : Select the Oracle home of the first application server instance.

HTTP host:port

 

localhost:80

Note : Port 80 is the loadbalancer's HTTP port.

OC4J Instance

home

Administrator Username oc4jadmin
Administrator Password welcome1
Name orcl
Database Connect String localhost:1521
User ID ORAWSM
Password oracle

 

3.

On the Summary screen, verify the installation settings and click Install.

 

4.

On the End of Installation screen, click Exit to complete the installation.

 

Back to Topic List

 

Installing the Oracle Application Server 10g Release 3 Patch Set 3 (10.1.3.3.0) on the First Instance

Install the Oracle Application Server 10g Release 3 Patch set 3 (10.1.3.3.0) on the first application server instance. To perform the installation task, execute the following steps:

1.

Launch the Oracle installer by executing the setup.exe file. You see the Welcome screen. Click Next to proceed with the installation.

 

2.

On the Specify File Locations screen, select the following details and click Next.

Properties

Value

Name oracleas1
Path C:\product\10.1.3.1\OracleAS_1

Note: Click OK in the Warning window.

 

3.

On the Administrator (oc4jadmin) Password screen, enter welcome1 in the oc4jadmin Password field and click Next.

Note: Click OK in the Warning window.

 

4.

On the Summary screen, verify the installation settings and click Install.

 

5.

On the End of Installation screen, click Exit to complete the installation.

 

Back to Topic List

 

Installing the Stand-Alone Oracle Web Services Manager (10.1.3.1.0) on the Second Application Server Instance

To perform the installation task, execute the following steps:

1.

Launch the Oracle installer by executing the setup.exe file.

 

2.

On the Oracle Web Services Manager 10g (10.1.3.1.0) Installation screen, enter the following details and click Next.

Properties

Value

Installation Directory

 

C:\product\10.1.3.1\OracleAS_2

Note : Select the Oracle home of the first application server instance.

HTTP host:port

 

localhost:80

Note : Port 80 is the loadbalancer's HTTP port.

OC4J Instance

home

Administrator Username oc4jadmin
Administrator Password welcome1
Name orcl
Database Connect String localhost:1521
User ID ORAWSM
Password oracle

 

3.

On the Summary screen, verify the installation settings and click Install.

 

4.

On the End of Installation screen, click Exit to complete the installation.

 

Back to Topic List

 

Installing the Oracle Application Server 10g Release 3 Patch Set 3 (10.1.3.3.0) on the Second Instance

Install the Oracle Application Server 10g Release 3 Patch set 3 (10.1.3.3.0) on the second application server instance. To perform the installation task, execute the following steps:

1.

Launch the Oracle installer by executing the setup.exe file. You see the Welcome screen. Click Next to proceed with the installation.

 

2.

On the Specify File Locations screen, select the following details and click Next.

Properties

Value

Name oracleas2
Path C:\product\10.1.3.1\OracleAS_2

Note: Click OK in the Warning window.

 

3.

On the Administrator (oc4jadmin) Password screen, enter welcome1 in the oc4jadmin Password field and click Next.

Note: Click OK in the Warning window.

 

4.

On the Summary screen, verify the installation settings and click Install.

 

5.

On the End of Installation screen, click Exit to complete the installation.

Restart all application server instances by using the opmnctl command.

This completes the topology creation and configuration for the high availability of Oracle WSM components.

 

Back to Topic List

 

Summary

In this lesson, you learned how to:

 Creating the Oracle WSM Schema in the Oracle Database 10g Instance
 Installing the First Application Server Instance (J2EE Server)
 Installing the Second Application Server Instance (J2EE Server)
 Installing the Third Application Server Instance (Stand-Alone OHS)
 Clustering Application Server Instances
 Configuring the OHS as Loadbalancer for Two J2EE Server Instances
 Installing the Stand-Alone Oracle Web Services Manager (10.1.3.1.0) on the First Application Server Instance
 I nstalling the Oracle Application Server 10g Release 3 Patch Set 3 (10.1.3.3.0) on the First Instance
 Installing the Stand-Alone Oracle Web Services Manager (10.1.3.1.0) on the Second Application Server Instance
 Installing the Oracle Application Server 10g Release 3 Patch Set 3 (10.1.3.3.0) on the Second Instance

 

Related Information

 To ask a question about this OBE tutorial, post a query on the OBE Discussion Forum.

Back to Topic List

 Place the cursor over this icon to hide all screenshots.

 

 

 

Left Curve
Popular Downloads
Right Curve
Untitled Document