For proxying requests from Oracle HTTP Server to Oracle WebLogic Server, use the mod_wl_ohs
plug-in. This plug-in is similar to the plug-in for Apache HTTP Server. However, you do not need to download and install the plug-in separately. For information about configuring mod_wl_ohs
, see Configuring the Plug-In for Oracle HTTP Server.
WebLogic Server Proxy Plug-in 12.2.1.0 and later version builds are moved from Intel compiler to MSVC Compiler. When Apache HTTP Server is used as a front end with WebLogic Server Proxy Plug-in, the plug-in library depends on the two dlls — msvcp110.dll
and msvcr110.dll
, provided by Microsoft. These dlls are available with Microsoft Visual C ++ Redistributable Package for x64.
To install and configure the Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server, read the following sections:
The Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server is supported on Apache 2.2 and 2.4 web servers and can front-end WebSocket applications.
After you download the Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server, as described in Availability of Oracle WebLogic Server Proxy Plug-In, you can install it as an Apache HTTP Server module in your Apache HTTP Server installation.
Before you install the Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server, complete these installation and verification tasks.
Download the Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server, as described in Availability of Oracle WebLogic Server Proxy Plug-In.
Extract the plug-ins zip distribution to PLUGIN_HOME. For example, /home/myhome/weblogic-plugins-12.2.1.3.0/
. This is the directory to which the extract the plug-in is extracted.
This distribution contains these files:
Table 3-1 Files Included in the Apache Web Server Plug-in Zip
(path)/filename | Description |
---|---|
|
The README file for the plug-in. |
|
orapki tool for configuring Oracle wallets |
j |
orapki helper Java libraries |
|
WebLogic proxy module for Apache 2.2 |
|
Helper libraries |
l |
WebLogic proxy module for Apache 2.4 |
Install JDK 8 to use SSL. The JDK 8 installation is required to use the orapki utility, which manages public key infrastructure (PKI) elements, such as wallets and certificate revocation lists, for use with SSL.
Ensure that you have a supported Apache HTTP Server installation. See http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html
.
Ensure that a supported version of Oracle WebLogic Server is configured and running on a target system. This server does not need to be running on the system on which you extracted the plug-in zip distribution. For the supported Oracle WebLogic Server versions, see http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html
.
The Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server is distributed as a shared object (.so) file. You can obtain the plug-in here:
http://www.oracle.com/technetwork/middleware/webtier/overview/index.html
To install the Apache HTTP Server plug-in:
This section describes how to edit the httpd.conf file to proxy requests by path or by MIME type, to enable HTTP tunneling, and to use other Oracle WebLogic Server plug-in parameters.
Edit the httpd.conf file in your Apache HTTP Server installation to configure the Apache HTTP Server plug-in. Complete these tasks:
You can proxy requests by MIME type and/or by path. Open the httpd.conf file in a text editor.
Note:
If both MIME type and proxying by path are enabled, proxying by path takes precedence over proxying by MIME type.
Define any additional parameters for the Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server.
The Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server recognizes the parameters listed in General Parameters for Web Server Plug-Ins. To modify the behavior of your Oracle WebLogic Server Proxy Plug-In for Apache HTTP Server, define these parameters either:
In a <Location>
block, for parameters that apply to proxying by path, or
At global or virtual host scope, for parameters that apply to proxying by MIME type.
You can enable HTTP tunneling for the t3 or IIOP protocols by configuring <Location>
blocks.
To enable HTTP tunneling if you are using the t3 protocol and weblogic.jar, add the following <Location>
block to the httpd.conf file:
<Location /bea_wls_internal> WLSRequest On </Location>
To enable HTTP tunneling if you are using the IIOP, the only protocol used by the WebLogic Server thin client, wlclient.jar, add the following Location
block to the httpd.conf file:
<Location /bea_wls_internal> WLSRequest On </Location>
<Location>
blocks. The <wls-wsat> parameter applies to proxying by path. You can optionally define the parameter to modify the behavior of your WebLogic Web Server Proxy Plug-In for Apache HTTP Server.
<Location /wls-wsat> WLSRequest On </Location>
WebLogic web services enable interoperability with other external transaction processing systems, such as IBM WebSphere, JBoss, Microsoft .NET. For more information about Web Services Atomic Transaction (WS-AtomicTransaction), see https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=ws-tx.
If you choose to not use the <IfModule>
, you can instead directly place the WebLogic properties inside Location
or <VirtualHost>
blocks. Consider the following examples of the <Location>
and <VirtualHost>
blocks:
<Location /weblogic> WLSRequest On WebLogicHost myweblogic.server.com WebLogicPort 7001 </Location> <Location /weblogic> WLSRequest On WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001 </Location> <VirtualHost apachehost:80> WLSRequest On WebLogicServer weblogic.server.com WebLogicPort 7001 </VirtualHost>
This example demonstrates basic instructions for quickly setting up the Apache plug-in to proxy requests to a backend WebLogic Server.
To keep several separate configuration files, you can define parameters in a separate configuration file called weblogic.conf
file, by using the Apache HTTP Server Include
directive in an <IfModule>
block in the httpd.conf file.
<IfModule mod_weblogic.c> # Config file for WebLogic Server that defines the parameters Include conf/weblogic.conf </IfModule>
The syntax of weblogic.conf files is the same as that for the httpd.conf file.
The following sections describe how to create weblogic.conf files, and include sample weblogic.conf files.
Be aware of the following rules and best practices for constructing a weblogic.conf file.
Enter each parameter on a new line. Do not put "=
" between a parameter and its value. For example:
PARAM_1 value1 PARAM_2 value2 PARAM_3 value3
If a request matches both a MIME type specified in a MatchExpression
in an <IfModule>
block and a path specified in a Location
block, the behavior specified by the <Location>
block takes precedence.
If you use an Apache HTTP Server <VirtualHost>
block, you must include all configuration parameters (MatchExpression
, for example) for the virtual host within the <VirtualHost>
block (see Apache Virtual Host documentation at http://httpd.apache.org/docs/vhosts/
).
Sample httpd.conf file:
<IfModule mod_weblogic.c> WebLogicCluster johndoe02:8005,johndoe:8006 WLTempDir "c:\myTemp" DebugConfigInfo ON KeepAliveEnabled ON KeepAliveSecs 15 </IfModule> <Location /jurl> WLSRequest On WebLogicCluster myCluster:7001 WLTempDir "c:\jurl" </Location> <Location /web> WLSRequest On PathTrim /web WebLogicHost myhost WebLogicPort 8001 WLTempDir "c:\web" </Location> <Location /foo> WLSRequest On WebLogicHost myhost02 WebLogicPort 8090 WLTempDir "c:\foo" PathTrim /foo </Location>
All the requests that match /jurl/* will have the POST data files in c:\jurl and will reverse proxy the request to agarwalp01 and port 7001. All the requests that match /web/* will have the POST data files in c:\web and will reverse proxy the request to myhost and port 8001. All the requests that match /foo/* will have the POST data files written to c:\foo and will reverse proxy the request to myhost02 and port 8090.
You should use the MatchExpression
statement instead of the <Files>
block.
These examples of weblogic.conf files may be used as templates that you can modify to suit your environment and server. Lines beginning with # are comments.
Example Using WebLogic Clusters
# These parameters are common for all URLs which are # directed to the current module. If you want to override # these parameters for each URL, you can set them again in # the <Location> or <Files> blocks. <IfModule mod_weblogic.c> WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001 ErrorPage http://myerrorpage.mydomain.com MatchExpression *.jsp </IfModule> ####################################################
MatchExpression
parameter syntax for expressing the filename pattern, the WebLogic Server host to which HTTP requests should be forwarded, and various other parameters is as follows:
MatchExpression [filename pattern] [WebLogicHost=host] | [paramName=value]
The first MatchExpression parameter below specifies the filename pattern *.jsp, and then names the single WebLogicHost
. The paramName=value
combinations following the pipe symbol specify the port at which WebLogic Server is listening for connection requests, and also activate the Debug option. The second MatchExpression
specifies the filename pattern *.html
and identifies the WebLogic Cluster hosts and their ports. The paramName=value
combination following the pipe symbol specifies the error page for the cluster.
Example Using Multiple WebLogic Clusters
# These parameters are common for all URLs which are # directed to the current module. If you want to override # these parameters for each URL, you can set them again in # the <Location> or <Files> blocks. <IfModule mod_weblogic.c> MatchExpression *.jsp WebLogicHost=myHost|WebLogicPort=7001|Debug=ON MatchExpression *.html WebLogicCluster=myHost1:7282,myHost2:7283|ErrorPage= http://www.xyz.com/error.html </IfModule>
Example Without WebLogic Clusters
# These parameters are common for all URLs which are # directed to the current module. If you want to override # these parameters for each URL, you can set them again in # the <Location> or <Files> blocks. <IfModule mod_weblogic.c> WebLogicHost myweblogic.server.com WebLogicPort 7001 MatchExpression *.jsp </IfModule>
Example Configuring Multiple Name-Based Virtual Hosts
# VirtualHost1 = localhost:80 <VirtualHost 127.0.0.1:80> DocumentRoot "C:/test/VirtualHost1" ServerName localhost:80 <IfModule mod_weblogic.c> #... WLS parameter ... WebLogicCluster localhost:7101,localhost:7201 # Example: MatchExpression *.jsp <some additional parameter> MatchExpression *.jsp PathPrepend=/test2 </IfModule> </VirtualHost> # VirtualHost2 = 127.0.0.2:80 <VirtualHost 127.0.0.2:80> DocumentRoot "C:/test/VirtualHost1" ServerName 127.0.0.2:80 <IfModule mod_weblogic.c> #... WLS parameter ... WebLogicCluster localhost:7101,localhost:7201 # Example: MatchExpression *.jsp <some additional parameter> MatchExpression *.jsp PathPrepend=/test2 #... WLS parameter ... </IfModule> </VirtualHost>
You must define a unique value for ServerName
or some plug-in parameters will not work as expected.
This section contains a sample httpd.conf file for Apache HTTP Server. You can use this sample as a template and modify it to suit your environment and server. Lines beginning with # are comments.
Note:
Apache HTTP Server is not case sensitive.
Sample httpd.conf file for Apache HTTP Server
#################################################### # APACHE-HOME/conf/httpd.conf file #################################################### LoadModule weblogic_module /home/myhome/weblogic-plugins-12.2.1/lib/mod_wl.so <Location /weblogic> WLSRequest On PathTrim /weblogic ErrorPage http://myerrorpage1.mydomain.com </Location> <Location /servletimages> WLSRequest On PathTrim /something ErrorPage http://myerrorpage1.mydomain.com </Location> <IfModule mod_weblogic.c> MatchExpression *.jsp WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001 ErrorPage http://myerrorpage.mydomain.com </IfModule>
You can configure and view DMS performance metrics for Apache HTTP Server. The Apache HTTP server provides the same set of DMS metrics as the Oracle WebLogic Server.
The DMS metrics that can be returned are described in DMS State Metrics, DMS Event Metrics, and DMS PhaseEvent Metrics.
This section contains the following information:
To configure DMS metrics for the Apache HTTP Server, add the following code to the httpd.conf
file.
# Add the following LoadModule only if it is not already present # Use mod_wl.so for Apache httpd 2.2 LoadModule weblogic_module $PLUGIN_HOME/mod_wl_24.so <Location /metrics> SetHandler dms-handler </Location>
You can view the raw metrics using the URL:
http://apachehost:apacheport/metrics
where apachehost
is the host name of the Apache server and apacheport
is the port number.
The metrics that are coming from Oracle WebLogic Server plug-in can be found under the section /WebLogicProxy [type=OHSWebLogic]
.
The WebLogic Server plug-in logs are now part of the Apache HTTP Server error log. References can be identified with the prefix weblogic:
to easily identify them.
Apache 2.4 example:
[Thu May 14 23:15:05.160459 2015] [weblogic:debug] [pid 6571:tid 139894556022528] ApacheProxy.cpp(875): [client 10.184.61.77:53634] <657114316705052> =========New Request: [GET /weblogic/index.html HTTP/1.1] ======
Apache 2.2 example:
[Thu Apr 16 04:15:37 2015] [debug] ApacheProxy.cpp(873): [client 10.184.61.77] <2157714291829372> weblogic: ======New Request: [GET /weblogic/index.html HTTP/1.1] ======
The directives WLLogFile and Debug are deprecated. If the configuration uses these directives, the following note appears during startup:
[Thu May 14 23:22:19 2015] [warn] weblogic: The Debug directive is ignored. The web server log level is used instead.
To enable plug-in logs, set LogLevel to debug
. The logs will be included in the file pointed to by the ErrorLog directive.