Oracle HTTP Server and High Availability Concepts
Oracle HTTP Server (OHS) is the Web server component for Oracle Fusion Middleware and the key Web Tier component. It has a listener for Oracle WebLogic Server and a framework to host static pages, dynamic pages, and applications over the Web.
For more information on working with OHS, see:
Oracle HTTP Server Single-Instance Characteristics
Oracle HTTP Server (OHS) is based on Apache infrastructure and includes Oracle modules that you can use to extend OHS core functionality.
OHS has these components to handle client requests
HTTP listener handles incoming requests and routes them to the appropriate processing utility.
Modules (mods) implement and extend OHS functionality. OHS includes many standard Apache modules. Oracle also includes modules that are specific to OHS to support OHS and OHS component integration.
OHS can also be a proxy server, both forward and reverse. A reverse proxy enables content served by different servers to appear as if it comes from one server.
Oracle HTTP Server and Domains
Oracle HTTP Server (OHS) doesn't require a WebLogic domain but you usually use it with one. Oracle recommends associating OHS with a domain so that you can incorporate OHS into the Administration Console, where you can manage and monitor it.
mod_wl_ohs module handles the link to Managed Servers. You configure
mod_wl_ohs by routing requests of a particular type, such as JSPs, or by routing requests destined to a URL to specific Managed Servers.
OHS usually front ends a cluster. In this configuration, a special
WebLogicCluster, specifies a comma-separated list of cluster members.
These steps describe the
mod_wl_ohs directive process:
mod_wl_ohsreceives a request for a Managed Server then sends the request to one cluster member in the directive. At least one Managed Server must be available to fulfill the request.
The Managed Server receives the request, processes it, and sends a complete list of cluster members back to
mod_wl_ohsreceives the updated list, it dynamically adds previously unknown servers to the known servers list. By doing this, all future requests are load balanced across the cluster member list. The benefit is that new Managed Servers are added to a cluster without updating
mod_wl_ohsor adding OHS.
DynamicServerListcontrols whether or not unknown servers are added to the known servers list. You must set
ONto enable dynamic addition of servers.
When you start, you don't need to include all current Managed Servers in the
mod_wl_ohs directive. A high availability setup requires only two cluster members in the list for the first call to work. See Configuring the WebLogic Proxy Plug-In for Oracle HTTP Server in Oracle Fusion Middleware Using Oracle WebLogic Server Proxy Plug-Ins for more on running an OHS high availability deployment.
For more on Oracle WebLogic clusters, see Introduction and Roadmap in Using Clusters for Oracle WebLogic Server.
Oracle HTTP Server Startup and Shutdown Lifecycle
After Oracle HTTP Server starts, it is ready to listen for and respond to HTTP(S) requests.
The request processing model is different on Microsoft Windows systems compared to UNIX systems:
For Microsoft Windows, there is one parent process and one child process. The child process creates threads that handle client requests. The number of created threads is static and you can configure them for performance.
For UNIX, there is one parent process that manages multiple child processes. Child processes handle requests. The parent process brings up more child processes as necessary, based on configuration.
For more on the OHS processing model, see Oracle HTTP Server Processing Model in Administrator's Guide for Oracle HTTP Server.
Starting and Stopping Oracle HTTP Server
Use Fusion Middleware Control or the WebLogic Scripting Tool (WLST) to start, stop, and restart Oracle HTTP Server.
If you plan to use WLST, you should familiarize yourself with that tool; see Getting Started Using the Oracle WebLogic Scripting Tool (WLST) in the Oracle Fusion Middleware Administrator's Guide.
For steps to start and stop OHS, see Performing Basic Oracle HTTP Server Tasks in Administrator's Guide for Oracle HTTP Server.
Oracle HTTP Server High Availability Architecture and Failover Considerations
Oracle HTTP Servers and Managed Servers reside on different hosts, behind a load balancer, in a high availability topology.
Figure 13-1 shows two Oracle HTTP Servers behind a load balancer.
Figure 13-1 Oracle HTTP Server High Availability Architecture
Description of "Figure 13-1 Oracle HTTP Server High Availability Architecture"
The load balancer receives user requests and forwards them to connected Oracle HTTP Servers. The load balancer receives requests on standard HTTP/HTTPS ports (80/443). However, it then passes requests to Oracle HTTP Servers using completely different ports. Advantages of this setup are:
Actual ports are hidden from users.
Users don't have to add port numbers to the URL.
On UNIX-based systems, starting OHS with root privileges isn't mandatory. Only root can start a process that uses a port less than 1024. However, for processes that use a port number below 1024, you must use root privilege to start a process.
The load balancer routes requests to the functioning Oracle HTTP Server.
Figure 13-1 also shows how OHS distributes requests to Managed Servers. For high availability, each pair of components (OHS and Managed Servers) should reside on different host computers. Managed Servers belong to the same cluster; to load balance across a set of Managed Servers, they must belong to the same cluster.
Oracle HTTP Server Failure Protection and Expected Behaviors
Oracle HTTP Server (OHS) has two failure types: process failures and node failures. An individual operating system process may fail. A node failure can involve failure of the entire host computer that OHS runs on.
Table 13-1 OHS Failure Types and Failure Protections
Node Manager protects and manages OHS processes. If an OHS process fails, Node Manager automatically restarts it.
Load balancer in front of OHS sends a request to another OHS if the first one doesn't respond or URL pings indicate it failed.
If a Managed Server in a cluster fails,
Typically, an issue only when using
If client connection failover is configured, in-flight transactions roll back. Database reconnection is required.
If Transparent Application Failover (TAF) is configured, any in-flight database write rolls back but automatic database reconnection occurs and select statements recover automatically. TAF fails over select statements only; package variables are lost. TAF, a JDBC Oracle Call Interface driver feature, enables an application to automatically reconnect to a database if the database instance the connection is made to fails. In this case, active transactions roll back.
Configuring Oracle HTTP Server Instances on Multiple Machines
If you use the Configuration Wizard to configure Oracle HTTP Server (OHS) and OHS is part of a domain, update the
mod_wl_ohs.conf file for each instance.
The file is in the DOMAIN_HOME/
config/fmwconfig/components/OHS/componentName directory. Restart the Administration Server to propagate changes to all OHS instances in the domain, even if they reside on a different host.
See Configuring mod_wl_ohs.conf for more information on the
If you install and configure OHS instances in separate domains, you must manually copy changes to other Oracle HTTP Servers. You must verify that the changes apply to all OHS instances and that they are synchronized.
Configuring Oracle HTTP Server for High Availability
To configure an example high availability deployment of Oracle HTTP Server (OHS), you must meet specific prerequisites. You can then install OHS on an additional web server, then configure and validate OHS high availability.
Prerequisites to Configure a Highly Available OHS
You must meet certain prerequisites before configuring a high availability Oracle HTTP Server deployment.
Load Balancer Prerequisites
To distribute requests against Oracle HTTP Server, you must use an external load balancer to distribute HTTP(S) requests between available Oracle HTTP Servers.
If you have an external load balancer, it must have features that Third-Party Load Balancer Requirements describes.
Configuring Load Balancer Virtual Server Names and Ports
In an OHS installation, virtual servers are configured for HTTP connections, which are distributed across the HTTP servers.
If your site serves requests for HTTP and HTTPS connections, Oracle recommends that HTTPS requests terminate at the load balancer and pass through as HTTP requests. To do this, the load balancer should be able to perform the protocol conversion and must be configured for persistent HTTP sessions.
This example configuration assumes that the load balancer is configured as:
Managing Load Balancer Port Numbers
Many Oracle Fusion Middleware components and services use ports. As an administrator, you must know the port numbers that services use and ensure that two services don't use the same port number on your host computer.
Most port numbers are assigned during installation. It is important that any traffic going from Oracle HTTP Servers to Oracle WebLogic Servers has access through any firewalls.
Installing and Validating Oracle HTTP Server on WEBHOST1
After you install OHS, validate its installation.
To install OHS on WEBHOST1, see the steps in Installing the Oracle HTTP Server Software in Oracle Fusion Middleware Installing and Configuring Oracle HTTP Server.
Validate the installation using the following URL to access the OHS home page:
Creating Virtual Host(s) on WEBHOST1
For each virtual host or site name that you use, add an entry to the OHS configuration.
Create a file named
virtual_hosts.conf in the ORACLE_HOME/
moduleconf directory as follows:
NameVirtualHost *:7777 <VirtualHost *:7777> ServerName http://myapp.example.com:80 RewriteEngine On RewriteOptions inherit UseCanonicalName On </VirtualHost>
If you are using SSL/SSL Termination (*):
NameVirtualHost *:7777 <VirtualHost *:7777> ServerName https://myapp.example.com:443 RewriteEngine On RewriteOptions inherit UseCanonicalName On </VirtualHost>
You can also use Fusion Middleware Control to create virtual hosts. See Wiring Components Together in Administering Oracle Fusion Middleware
After you install and configure OHS, link it to any defined Managed Servers by editing the
The file is in DOMAIN_HOME/
See Configuring the WebLogic Proxy Plug-In for Oracle HTTP Server in Oracle Fusion Middleware Using Oracle WebLogic Server Proxy Plug-Ins 12.1.2 for more about editing the
You can also use Fusion Middleware Control to link OHS to Managed Servers. See Wiring Components Together in Administering Oracle Fusion Middleware
The following example shows
LoadModule weblogic_module PRODUCT_HOME/modules/mod_wl_ohs.so <IfModule mod_weblogic.c> WebLogicCluster apphost1.example.com:7050, apphost2.example.com:7050 MatchExpression *.jsp </IfModule> <Location /weblogic> SetHandler weblogic-handler WebLogicCluster apphost1.example.com:7050,apphost2.example.com:7050 DefaultFileName index.jsp </Location> <Location /console> SetHandler weblogic-handler WebLogicCluster apphost1.example.com WebLogicPort 7003 </Location>
These examples show two different ways to route requests to Managed Servers:
<ifModule>block sends any requests ending in *.jsp to the WebLogic Managed Server cluster located on APPHOST1 and APPHOST2.
<Location>block sends any requests with URLs that have a
/weblogicprefix to the Managed Server cluster located on APPHOST1 and APPHOST2.
Configuring mod_wl_conf if you use SSL Termination
If you use SSL termination AND route requests to WebLogic, you must take additional configuration steps.
To configure mod_wl_conf if you use SSL termination:
- In the WebLogic console, verify that WebLogic Plugin Enabled is set to true, either at the domain, cluster, or Managed Server level.
- Add these lines to the Location block, which directs requests to Managed Servers:
WLProxySSL ON WLProxySSLPassThrough ON
<Location /weblogic> SetHandler weblogic-handler WebLogicCluster apphost1.example.com:7050,apphost2.example.com:7050 WLProxySSL On WLProxySSLPassThrough ON DefaultFileName index.jsp </Location>
After you enable the WebLogic plugin, restart the Administration Server.
Installing and Validating Oracle HTTP Server on WEBHOST2
You install OHS then validate the install.
To install Oracle HTTP Server on WEBHOST2, see Installing the Oracle HTTP Server Software in Oracle Fusion Middleware Installing and Configuring Oracle HTTP Server.
Validate the installation on WEBHOST2 by using the following URL to access the Oracle HTTP Server home page:
Configuring and Validating an OHS High Availability Deployment
To configure and validate the OHS high availability deployment, update
mod_wl_ohs.conf and then use test URLs to validate OHS configuration.
Configuring Virtual Host(s) on WEBHOST2
mod_wl_ohs.conf file located in DOMAIN_HOME/
You must then restart the Administration Server to propagate changes to all OHS instances in the domain.