Review and ensure that you meet the necessary prerequisites.

• Obtaining the WLS Apache Plug-In
  
• Java Requirements
  
• Apache HTTP Server Installation
  
• Oracle WebLogic Server Installation
  
• Setting the Environment Variables for the WLS Apache Plug-In
  
• Installing Microsoft Redistributable Package 2015-2022
  

1. Verify that the mod_so.c module is enabled.

   If you installed Apache HTTP Server using the script supplied by Apache, mod_so.c is already enabled. Verify that mod_so.c is enabled by running the following command:

   UNIX/Linux:

   APACHE_HOME/bin/apachectl -l

   (APACHE_HOME is the directory that contains the Apache HTTP Server installation.)

   This command lists all enabled modules. If mod_so.c is not listed, you must rebuild your Apache HTTP Server, ensuring that the following configuration option is specified:

   ...
   --enable-module=so
   ...

   The output appears as follows:

   # apachectl -l
   Compiled in modules:
   ...
     mod_so.c
   ...

2. Make a copy of the APACHE_HOME/conf/httpd.conf file for backup.
3. Open the httpd.conf file.
4. Verify the syntax of the httpd.conf file by running the following command:
   UNIX/Linux:

   > APACHE_HOME/bin/apachectl -t

   If the httpd.conf file contains any errors, the output of this command shows the errors; ensure that you get a clean output before continuing. If there are no errors, the command returns the following:

   Syntax OK

   Note:

   Ensure that you have resolved all the configuration errors from Steps 1 through 4 before contacting Oracle Support.
5. The WLS Apache Plug-In modules for Apache 2.4.x are shipped with the 14.1.2.0.0 proxy plug-in distributions. Apache 2.2.x is no longer supported. Therefore, the WLS Apache Plug-In module for Apache 2.2.x is no longer supported. Use the WLS Apache Plug-In module for Apache 2.4.x which continues to be supported.

   Note:

   If you are using Apache 2.2.x version of the web server, migrate to the Apache 2.4.x version, and then install the Oracle WebLogic Server Proxy Plug-in module for Apache 2.4.x.

   Install the WLS Apache Plug-In module for Apache 2.4.x by adding the following line:

   LoadModule weblogic_module /home/myhome/weblogic-plugins-14.1.2.0.0/lib/mod_wl_24.so

6. After installing the WLS Apache Plug-In module, verify the syntax of the httpd.conf file by running the following command:
   UNIX/Linux:

   > APACHE_HOME/bin/apachectl -t

   If the httpd.conf file contains any errors, the output of this command shows the errors. Contact Oracle Support for resolving the errors. If there are no errors, the command returns the following:

   Syntax OK

To configure the WLS Apache Plug-In, edit the httpd.conf file in your Apache HTTP Server installation. Complete the following tasks:

• Task 1: Configure MIME Requests
  
• Task 2: Define Additional Parameters for the WLS Apache Plug-In
  
• Task 3: Enable HTTP Tunneling (Optional)
  
• Task 4: Enable Web Services Atomic Transaction (Optional)
  
• Task 5: Verify and Apply Your Configuration
  

If you choose to not use the <IfModule>, you can instead directly place the WebLogic properties inside the 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>

1. Make a copy of $APACHE_HOME/conf/httpd.conf file.
2. Edit the file to add the following code:

   ... 
   LoadModule weblogic_module /home/myhome/weblogic-plugins-14.1.2.0.0/lib/mod_wl_24.so
   
   <IfModule mod_weblogic.c>
     WebLogicHost wls-host
     WebLogicPort wls-port
   </IfModule>
   
   <Location /mywebapp>
     WLSRequest On
   </Location>
   ...
   

3. Include $PLUGINS_HOME/lib in the LD_LIBRARY_PATH, using the following command:

   $ export LD_LIBRARY_PATH=/home/myhome/weblogic-plugin-14.1.2.0.0/lib:$LD_LIBRARY_PATH

   Note:

   You can also update the LD_LIBRARY_PATH by copying the 'lib' contents to APACHE_HOME/lib or by editing the APACHE_HOME/bin/apachectl to update the LD_LIBRARY_PATH.

4. Set PLUGINS_HOME to point to the directory where the proxy plug-ins zip file is extracted to, using the following command:

   export PLUGINS_HOME=/home/myhome/weblogic-plugins-14.1.2.0.0/

5. Include the path containing the OpenSSL libraries in the LD_LIBRARY_PATH, using the following command:

   export LD_LIBRARY_PATH=/home/myhome/openssl_installation/lib:$LD_LIBRARY_PATH

6. At the prompt, start the Apache HTTP Server by entering:

   $ ${APACHE_HOME}/bin/apachectl start

7. Send a request to http://apache-host:apache-port/mywebapp/my.jsp from the browser and validate the response

To keep several separate configuration files, you can define parameters in a separate configuration file called weblogic.conf, by using the Apache HTTP Server Include directive in an <IfModule> block in the httpd.conf file.

<IfModule mod_weblogic.c>
 # Config file for Oracle 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 the weblogic.conf files, and include the sample weblogic.conf files:

• Rules for Creating the weblogic.conf Files
  
• Sample weblogic.conf Configuration Files
  
• Template for the Apache HTTP Server httpd.conf File
  

You can view the raw metrics using the following 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 the WLS Apache Plug-In can be found under the /WebLogicProxy [type=WebLogicProxy] section.