Oracle HTTP
Server (OHS) 12c 12.1.2 which was released
in July 2013 as a part of Oracle Web Tier 12c is the web
server component of Oracle Fusion Middleware. In essence this is Apache HTTP
Server 2.2.22 (with critical bug fixes from higher versions) which includes modules developed specifically by Oracle. It provides a listener functionality for Oracle WebLogic
Server and the framework for hosting static pages, dynamic pages, and applications over the Web. OHS can be easily managed by Weblogic
Management Framework, a set of tools which provides administrative capabilities (start, stop, lifecycle
operations, etc.) for Oracle Fusion Middleware products. In other words all
tools which are familiar to us (Node Manager, WLST, Administration Console,
Fusion Middleware Control etc.) presented as a part of Weblogic Management Framework
and using for managing
Java and System Components both for Weblogic
Server and
Standalone Domain types. You can familiarize yourself with these terms using
related documentation:
1. Introduction
to Oracle HTTP Server: http://docs.oracle.com/middleware/1212/webtier/index.html
2. Weblogic
Management Framework: http://docs.oracle.com/middleware/1212/core/ASCON/terminology.htm#ASCON11260
In the given post I would like to cover rather simple use
case how to configure OHS as web proxy in Weblogic Cluster environment. For example, we have
existing Weblogic Domain where some managed servers have been joined to cluster
and host business applications. We need to configure web proxy component which
will act as entry point, load balancer for our cluster for user requests. Of
course, we could install old good Apache HTTP
Server and configure mod_wl plugin. However this solution not
optimal from manageability perspective: we need to install Apache, install
additional plugin then configure it by editing configuration file which is not really
convenient for FMW Administrators and often increase time of performing of
simple administrative task. Alternatively, we could use OHS as System Component
within Weblogic Domain and use full power of Weblogic Management Framework in
order to configure, manage and monitor it! I like this idea! What about you? I hope
after reading this post you will agree with me.
First of all it
is necessary to download OHS binaries. You can use this link for downloading: http://www.oracle.com/technetwork/java/webtier/downloads/index2-303202.html
As we will use
Fusion Middleware Control for managing OHS instances it is necessary to extend your
domain with Enterprise Manager and Oracle ADF and JRF templates. This is not
topic for focusing in this post, but you could get more information from documentation or one of my previous posts:
http://docs.oracle.com/middleware/1212/wls/WLDTR/fmw_templates.htm#sthref64
https://blogs.oracle.com/imc/entry/the_specifics_of_adf_12c
Note: you should have properly configured Node Manager
utility for managing OHS instances
Let’s consider
configuration process step by step:
1. Shut
down all Weblogic instances of existing domain including Admin Server;
2. Install
Oracle HTTP
Server. You should use your Fusion
Middleware Home Path (e.g. /u01/Oracle/FMW12) for Installation
Location and select Colocated HTTP
Server option as Installation Type.
I will not focus on this topic in this post. All information related to OHS
installation you could find here: http://docs.oracle.com/middleware/1212/webtier/WTINS/install_gui.htm#i1082009
3. Next
we need to extend our existing domain with OHS
component. In order to do this you should do the following:
a. Run
Fusion Middleware Configuration Wizard
(ORACLE_HOME/oracle_common/common/bin/config.sh);
b. On
the step 1 select Update an existing
domain option and point your Fusion
Middleware Home Path;
c. On
the step 2 check Oracle HTTP
Server, Oracle Enterprise Manager Plugin for WEBTIER templates;
d. Go
through other steps without any changes and finish configuration process.
4. Start
Admin
Server and all managed servers
related to your cluster
5. Log
in to Enterprise Manager FMW Control
using http://<hostname>:<port>/em URL
6. Now
we will create OHS instance within our Weblogic Domain Infrastructure. Navigate
to Weblogic Domain -> Administration ->
Create/Delete OHS menu item;
7. Enter
to edit mode, clicking Changes ->
Lock&Edit menu item;
8. Create
new OHS instance clicking Create
button;
9. Define
Instance Name (e.g. DevOSH) and Machine parameters;
10. Now we need to define listen port. By default OHS will
use 7777 port number for income HTTP
requests. We could change it to any free port number we would like to use. In
order to do it, right click on our created OHS instance (left hand panel) and
navigate to Administration -> Port
Configuration;
11. Click on record with port number 7777 and then click Edit
button;
12. Change port number value (in our case this will be 8080) and then click OK button;
13. Now we need to edit mod_wl_ohs configuration in order to enable OHS to act as proxy for
WebLogic
Server Instances/Cluster;
14. In order to do it right click on our created OHS
instance (left panel) and navigate to Administration -> mod_wl_ohs Configuration;
a. In
Weblogic Cluster you should enter
cluster address (define <host:port> for all managed servers which participated in cluster),
e.g: 192.168.56.2:7004,192.168.56.2:7005
b. Define
Weblogic Port parameter at which the
Oracle WebLogic
Server host is listening for connection requests from the module
(or from other servers);
c. Check
Dynamic
Server List option. This
will dynamically update cluster list for every request;
d. In
the Location table define list of
endpoint locations which you would like to process. In order to do this click Add Row button and define Location, Weblogic Cluster, Path Trim
and Path Prefix parameters (if
required);
e. Click
Apply button in order to save
changes.
15. Activate changes clicking Changes ? Activate Changes menu item;
16. Finally we will start configured OHS instance. Right click on
OHS instance tree item under Web Tier
folder, select Control -> Start Up menu
item;
17. Ensure that OHS instance up and running and then test
your environment. Run deployed application to your Weblogic Cluster accessing via OHS web proxy;
Normal
0
false
false
false
RU
X-NONE
X-NONE
/* Style Definitions */
table.MsoNormalTable
{mso-style-name:"Table Normal";
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
mso-style-noshow:yes;
mso-style-priority:99;
mso-style-parent:"";
mso-padding-alt:0cm 5.4pt 0cm 5.4pt;
mso-para-margin-top:0cm;
mso-para-margin-right:0cm;
mso-para-margin-bottom:10.0pt;
mso-para-margin-left:0cm;
line-height:115%;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:"Calibri","sans-serif";
mso-ascii-font-family:Calibri;
mso-ascii-theme-font:minor-latin;
mso-hansi-font-family:Calibri;
mso-hansi-theme-font:minor-latin;
mso-bidi-font-family:"Times New Roman";
mso-bidi-theme-font:minor-bidi;
mso-fareast-language:EN-US;}
