1. Enterprise Deployment Guide for Oracle Business Intelligence
  2. Configuring the Enterprise Deployment
  3. Configuring Oracle HTTP Server for an Enterprise Deployment

11 Configuring Oracle HTTP Server for an Enterprise Deployment

When you configure the web tier, you have the option of using Oracle HTTP Server or Oracle Traffic Director. If you choose to use Oracle HTTP Server, then you must install Oracle HTTP Server on each of the web tier hosts and configure Oracle HTTP standalone domains on each host.

The Oracle HTTP Server instances on the web tier direct HTTP requests from the hardware load balancer to specific Managed Servers in the application tier.

Before you configure Oracle HTTP Server, be sure to review Understanding the Web Tier.

Note:

If you plan to configure Oracle Managed File Transfer, then you must configure Oracle Traffic Director to route FTP and SFTP requests over TCP.

Parent topic: Configuring the Enterprise Deployment

Variables Used When Configuring the Oracle HTTP Server

As you perform the tasks in this chapter, you reference the directory variables that are listed in this topic.

The values for several directory variables are defined in File System and Directory Variables Used in This Guide.

  • WEB_ORACLE_HOME

  • WEB_DOMAIN_HOME

  • JAVA _HOME

In addition, you reference the following virtual IP (VIP) address and host names:

  • ADMINVHN

  • WEBHOST1

  • WEBHOST2

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment

About the Oracle HTTP Server Domains

In an enterprise deployment, each Oracle HTTP Server instance is configured on a separate host and in its own standalone domain. This allows for a simple configuration that requires a minimum amount of configuration and a minimum amount of resources to run and maintain.

Note:

Oracle Fusion Middleware requires that a certified Java Development Kit (JDK) is installed on your system and JAVA_HOME is set on the web tier hosts.

For more information about the role and configuration of the Oracle HTTP Server instances in the web tier, see Understanding the Web Tier.

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment

Installing a Supported JDK

Oracle Fusion Middleware requires that a certified Java Development Kit (JDK) is installed on your system.

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment

Locating and Downloading the JDK Software

To find a certified JDK, see the certification document for your release on the Oracle Fusion Middleware Supported System Configurations page.

After you identify the Oracle JDK for the current Oracle Fusion Middleware release, you can download an Oracle JDK from the following location on Oracle Technology Network:

http://www.oracle.com/technetwork/java/index.html

Be sure to navigate to the download for the Java SE JDK.

Parent topic: Installing a Supported JDK

Installing the JDK Software

Oracle Fusion Middleware requires you to install a certified Java Development Kit (JDK) on your system.

You must install the JDK in the following locations:

On the local storage device for each of the Web tier host computers. The Web tier host computers, which reside in the DMZ, do not necessarily have access to the shared storage on the application tier.

See the Understanding the Recommended Directory Structure for an Enterprise Deployment.

To install JDK 1.8.0_131:
  1. Change directory to the location where you downloaded the JDK archive file.
    cd download_dir
  2. Unpack the archive into the JDK home directory, and then run the following commands:
    tar -xzvf jdk-8u131-linux-x64.tar.gz
    Note that the JDK version listed here was accurate at the time this document was published. For the latest supported JDK, see the Oracle Fusion Middleware System Requirements and Specifications for the current Oracle Fusion Middleware release.
  3. Move the JDK directory to the recommended location in the directory structure.
    For example:
    mv ./jdk1.8.0_131 /u02/oracle/products/jdk
  4. Define the JAVA_HOME and PATH environment variables for running Java on the host computer.
    For example:
    export JAVA_HOME=/u02/oracle/products/jdk
export PATH=$JAVA_HOME/bin:$PATH
  5. Run the following command to verify that the appropriate java executable is in the path and your environment variables are set correctly:
    java -verison
    The Java version in the output should be displayed as 1.8.0_131.

Parent topic: Installing a Supported JDK

Installing Oracle HTTP Server on WEBHOST1

It is important to understand the procedure for installing the Oracle HTTP Server software on the web tier.

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment

Starting the Installer on WEBHOST1

To start the installation program, perform the following steps.

  1. Log in to WEBHOST1.
  2. Go to the directory in which you downloaded the installation program.
  3. Launch the installation program by entering the following command:

    ./fmw_12.2.1.1.0_ohs_linux64.bin

    When the installation program appears, you are ready to begin the installation.

Parent topic: Installing Oracle HTTP Server on WEBHOST1

Navigating the Oracle HTTP Server Installation Screens

The following table lists the screens in the order that the installation program displays them.

If you need additional help with any of the installation screens, click the screen name.

Table 11-1 Oracle HTTP Server Installation Screens

Screen Description

Installation Inventory Setup

On UNIX operating systems, this screen appears if you install any Oracle product on this host for the first time. Specify the location where you want to create your central inventory. Ensure that the operating system group name selected on this screen has write permissions to the central inventory location.

See Understanding the Oracle Central Inventory in Installing Software with the Oracle Universal Installer.

Note:

Oracle recommends that you configure the central inventory directory within the products directory. Example: /u02/oracle/products/oraInventory

You may also need to execute the createCentralinventory.sh script as root from the oraInventory folder after the installer completes.

Welcome

This screen introduces you to the product installer.

Auto Updates

Use this screen to automatically search My Oracle Support for available patches or automatically search the local directory for patches that you have already downloaded for your organization.

Installation Location

Use this screen to specify the location of your Oracle home directory.

For the purposes of an enterprise deployment, enter the value of the WEB_ORACLE_HOME variable listed in Table 7-3.

Installation Type

Select Standalone HTTP Server (Managed independently of WebLogic server).

This installation type allows you to configure the Oracle HTTP Server instances independently from any other existing Oracle WebLogic Server domains.

JDK Selection

For the value of JDK Home, enter the value of JAVA_HOME that you set when installing the JDK software.

Prerequisite Checks

This screen verifies that your system meets the minimum necessary requirements.

If there are any warning or error messages, verify that your host computers and the required software meet the system requirements and certification information described in Host Computer Hardware Requirements and Operating System Requirements for the Enterprise Deployment Topology.

Installation Summary

Use this screen to verify the installation options that you selected. If you want to save these options to a response file, click Save Response File and provide the location and name of the response file. Response files can be used later in a silent installation situation.

See Using the Oracle Universal Installer in Silent Mode in Installing Software with the Oracle Universal Installer.

Installation Progress

This screen allows you to see the progress of the installation.

Installation Complete

This screen appears when the installation is complete. Review the information on this screen, then click Finish to close the installer.

Parent topic: Installing Oracle HTTP Server on WEBHOST1

Verifying the Oracle HTTP Server Installation

To verify that the Oracle HTTP Server installation completed successfully, use the ls --format=single-column command to list the files that are installed in the new Oracle home directory.

You should see the following directories in the Oracle HTTP Server Oracle home: 

bin
cfgtoollogs
crs
css
has
install
inventory
jlib
ldap
lib
network
nls
ohs
OPatch
oracle_common
oracore
oraInst.loc
oui
perl
plsql
plugins 
precomp 
rdbms 
slax 
sqlplus
srvm
webgate 
wlserver
xdk

Parent topic: Installing Oracle HTTP Server on WEBHOST1

Creating an Oracle HTTP Server Domain on WEBHOST1

The following topics describe how to create a new Oracle HTTP Server standalone domain on the first web tier host.

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment

Starting the Configuration Wizard on WEBHOST1

To start the Configuration Wizard, navigate to the following directory and start the WebLogic Server Configuration Wizard, as follows:

cd WEB_ORACLE_HOME/oracle_common/common/bin
./config.sh

Parent topic: Creating an Oracle HTTP Server Domain on WEBHOST1

Navigating the Configuration Wizard Screens for an Oracle HTTP Server Domain

Oracle recommends that you create a standalone domain for the Oracle HTTP Server instances on each web tier host.

The following topics describe how to create a new standalone Oracle HTTP Server domain:

Task 1   Selecting the Domain Type and Domain Home Location

On the Configuration Type screen, select Create a new domain.

In the Domain Location field, enter the value assigned to the WEB_DOMAIN_HOME variable.

Note the following:

  • The Configuration Wizard creates the new directory that you specify here.

  • Create the directory on local storage, so the web servers do not have any dependencies on storage devices outside the DMZ.

Note:

Task 2   Selecting the Configuration Templates

On the Templates screen, select Oracle HTTP Server (Standalone) - 12.2.1.3.0 [ohs].

Tip:

More information about the options on this screen can be found in Templates in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

Task 3   Selecting the JDK for the Web Tier Domain.

Select the Oracle HotSpot JDK installed in the /u02/oracle/products/jdk directory prior to the Oracle HTTP Server installation.

Task 4   Configuring System Components

On the System Components screen, configure one Oracle HTTP Server instance. The screen should, by default, have a single instance defined. This is the only instance that you need to create.

  1. The default instance name in the System Component field is ohs1. Use this default name when you configure WEBHOST1.

  2. Make sure that OHS is selected in the Component Type field.

  3. If an application is not responding, use the Restart Interval Seconds field to specify the number of seconds to wait before you attempt a restart if an application is not responding.

  4. Use the Restart Delay Seconds field to specify the number of seconds to wait between restart attempts.

Task 5   Configuring OHS Server

Use the OHS Server screen to configure the OHS servers in your domain:

  1. Select ohs1 from the System Component drop-down menu.

  2. In the Listen Address field, enter WEBHOST1.

    All the remaining fields are prepopulated, but you can change the values as required for your organization. See OHS Server in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

  3. In the Server Name field, verify the value of the listen address and listen port.

    It should appear as follows:

    http://WEBHOST1:7777
Task 6   Configuring Node Manager

Select Per Domain Default Location as the Node Manager type, and specify the user name and password for the Node Manager.

Note:

For more information about the options on this screen, see Node Manager in Creating WebLogic Domains Using the Configuration Wizard.

For information about Node Manager configuration, see Configuring Node Manager on Multiple Machines in Administering Node Manager for Oracle WebLogic Server.

Task 7   Reviewing Your Configuration Specifications and Configuring the Domain

The Configuration Summary screen contains detailed configuration information for the domain that you are about to create. Review the details of each item on the screen and verify that the information is correct.

If you need to make any changes, you can go back to any previous screen either by using the Back button or by selecting the screen in the navigation pane.

Domain creation does not begin until you click Create.

In the Configuration Progress screen, click Next when it finishes.

Tip:

More information about the options on this screen can be found in Configuration Summary in Creating WebLogic Domains Using the Configuration Wizard.

Task 8   Writing Down Your Domain Home

The Configuration Success screen shows the domain home location.

Make a note of the information provided here, as you need it to start the servers and access the Administration Server.

Click Finish to close the Configuration Wizard.

Parent topic: Creating an Oracle HTTP Server Domain on WEBHOST1

Installing and Configuring an Oracle HTTP Server Domain on WEBHOST2

After you install Oracle HTTP Server and configure a domain on WEBHOST1, then you must also perform the same tasks on WEBHOST2.

  1. Log in to WEBHOST2 and install Oracle HTTP Server by using the instructions in Installing Oracle HTTP Server on WEBHOST1.

  2. Configure a new standalone domain on WEBHOST2 by using the instructions in Creating a Web Tier Domain on WEBHOST1.

    Use the name ohs2 for the instance on WEBHOST2, and be sure to replace all occurrences of WEBHOST1 with WEBHOST2 and all occurrences of ohs1 with ohs2 in each of the examples.

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment

Starting the Node Manager and Oracle HTTP Server Instances on WEBHOST1 and WEBHOST2

It is important to understand how to start the Oracle HTTP Server instances on WEBHOST1 and WEBHOST2.

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment

Starting the Node Manager on WEBHOST1 and WEBHOST2

Before you can start the Oracle HTTP Server instances, you must start the Node Manager on WEBHOST1 and WEBHOST2:

  1. Log in to WEBHOST1 and navigate to the following directory:
    WEB_DOMAIN_HOME/bin
  2. Start the Node Manager as shown in the following sections by using nohup and nodemanager.out as an example output file:
    nohup WEB_DOMAIN_HOME/bin/startNodeManager.sh > WEB_DOMAIN_HOME/nodemanager/nodemanager.out 2>&1 &
  3. Log in to WEBHOST2 and perform steps 1 and 2.

See Advanced Node Manager Configuration in Administering Node Manager for Oracle WebLogic Server.

Parent topic: Starting the Node Manager and Oracle HTTP Server Instances on WEBHOST1 and WEBHOST2

Starting the Oracle HTTP Server Instances

To start the Oracle HTTP Server instances:

  1. Navigate to the following directory on WEBHOST1:
    WEB_DOMAIN_HOME/bin

    For more information about the location of the WEB_DOMAIN_HOME directory, see File System and Directory Variables Used in This Guide.

  2. Enter the following command:
    ./startComponent.sh ohs1

    Note:

    Every time you start the Oracle HTTP server, you will be asked for the Node Manager password. If you do not wish this behaviour, then use the following command the first time you start the Oracle HTTP server:

    ./startComponent.sh ohs1 storeUserConfig

    This time when you enter the Node Manager password, it will be encrypted and stored. Future start and stop of the Oracle HTTP server will not require you to enter the Node Manager password.

  3. When prompted, enter the Node Manager password.
  4. Repeat steps 1 through 3 to start the ohs2 instance on WEBHOST2. See Starting Oracle HTTP Server Instances in Administering Oracle HTTP Server.

Parent topic: Starting the Node Manager and Oracle HTTP Server Instances on WEBHOST1 and WEBHOST2

Configuring Oracle HTTP Server to Route Requests to the Application Tier

It is important to understand how to update the Oracle HTTP Server configuration files so that the web server instances route requests to the servers in the domain.

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment

About the Oracle HTTP Server Configuration for an Enterprise Deployment

The following topics provide overview information about the changes that are required to the Oracle HTTP Server configuration files in an enterprise deployment.

Parent topic: Configuring Oracle HTTP Server to Route Requests to the Application Tier

Purpose of the Oracle HTTP Server Virtual Hosts

The reference topologies in this guide require that you define a set of virtual servers on the hardware load balancer. You can then configure Oracle HTTP Server to recognize requests to specific virtual hosts (that map to the load balancer virtual servers) by adding <VirtualHost> directives to the Oracle HTTP Server instance configuration files.

For each Oracle HTTP Server virtual host, you define a set of specific URLs (or context strings) that route requests from the load balancer through the Oracle HTTP Server instances to the appropriate Administration Server or Managed Server in the Oracle WebLogic Server domain.

Recommended Structure of the Oracle HTTP Server Configuration Files

Rather than adding multiple virtual host definitions to the httpd.conf file, Oracle recommends that you create separate, smaller, and more specific configuration files for each of the virtual servers required for the products that you are deploying. This avoids populating an already large httpd.conf file with additional content, and it can make troubleshooting configuration problems easier.

For example, in a typical Oracle Fusion Middleware Infrastructure domain, you can add a specific configuration file called admin_vh.conf that contains the virtual host definition for the Administration Server virtual host (ADMINVHN).

Modifying the httpd.conf File to Include Virtual Host Configuration Files

Perform the following tasks to prepare the httpd.conf file for the additional virtual hosts required for an enterprise topology:

  1. Log in to WEBHOST1.

  2. Locate the httpd.conf file for the first Oracle HTTP Server instance (ohs1) in the domain directory: 

    cd WEB_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1/

  3. Verify if the httpd.conf file has the appropriate configuration as follows:

    1. Run the following command to verify the ServerName parameter, be sure that it is set correctly, substituting the correct value for the current WEBHOSTn: 

      grep "ServerName http" httpd.conf   
ServerName http://WEBHOST1:7777 

    2. Run the following command to verify there is an include statement that includes all *.conf files from the moduleconf subdirectory: 

      grep moduleconf httpd.conf   
IncludeOptional "moduleconf/*.conf"

    3. If either validation fails to return results, or returns results that are commented out, open the httpd.conf file in a text editor and make the required changes in the appropriate locations. 

      # 
# ServerName gives the name and port that the server uses to identify itself. 
# This can often be determined automatically, but we recommend you specify 
# it explicitly to prevent problems during startup. 
# 
# If your host doesn't have a registered DNS name, enter its IP address here. 
# 
ServerName http://WEBHOST1:7777 
#  and at the end of the file:  
# Include the admin virtual host (Proxy Virtual Host) related configuration 
include "admin.conf"  
IncludeOptional "moduleconf/*.conf"

    4. Save the httpd.conf file.

  4. Log in to WEBHOST2 and perform steps 2 and 3 for the httpd.conf file, replacing any occurrences of WEBHOST1 or ohs1 with WEBHOST2 or ohs2 in the instructions as necessary.

Parent topic: Configuring Oracle HTTP Server to Route Requests to the Application Tier

Creating the Virtual Host Configuration Files for Oracle Business Intelligence

You can route the Oracle HTTP Server requests to the Oracle Business Intelligence servers by creating the host configuration files.

Note:

Do not update the host entries in the virtual host configuration files mentioned in this topic if you have not planned to scale out the BI deployment to that host. For example, if you do not plan to extend the BI domain to HOST2 (BIHOST2 for WSM setup), do not specify "BIHOST2" in the directives while creating the virtual host configuration files.

Note:

Before you create the virtual host configuration files, be sure you have configured the virtual servers on the load balancer, as described in Purpose of the Oracle HTTP Server Virtual Hosts.

To create the virtual host configuration files:

  1. Sign in to WEBHOST1 and change directory to the configuration directory for the first Oracle HTTP Server instance (ohs1):
    cd OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1/moduleconf
  2. Create the admin_vh.conf file and add the following directive:
    <VirtualHost WEBHOST1:7777>
   ServerName admin.example.com:80
   ServerAdmin you@your.address
   RewriteEngine On
   RewriteOptions inherit
   
# Admin Server and EM
<Location /console>
    SetHandler weblogic-handler
    WebLogicHost ADMINVHN
    WeblogicPort 7001
</Location>

<Location /consolehelp>
    SetHandler weblogic-handler
    WebLogicHost ADMINVHN
    WeblogicPort 7001
</Location>

<Location /em>
    SetHandler weblogic-handler
    WebLogicHost ADMINVHN
    WeblogicPort 7001
</Location>

</VirtualHost>
  3. Create the biinternal_vh.conf file and add the following directives:
    <VirtualHost WEBHOST1:7777>
    ServerName biinternal.example.com
    ServerAdmin you@your.address
    RewriteEngine On
    RewriteOptions inherit

#redirect browser requests that omit document/dir
RedirectMatch 301 /analytics$ /analytics/
RedirectMatch 301 /biservices$ /biservices/
RedirectMatch 301 /analytics-ws$ /analytics-ws/
RedirectMatch 301 /AdminService$ /AdminService/
RedirectMatch 301 /AsyncAdminService$ /AsyncAdminService/
RedirectMatch 301 /wsm-pm$ /wsm-pm/
RedirectMatch 301 /xmlpserver$ /xmlpserver/
RedirectMatch 301 /bisearch$ /bisearch/
RedirectMatch 301 /mapviewer$ /mapviewer/
RedirectMatch 301 /va$ /va/
RedirectMatch 301 /bicomposer$ /bicomposer/
RedirectMatch 301 /mobile$ /mobile/
RedirectMatch 301 /aps$ /aps/
RedirectMatch 301 /bi-security$ /bi-security/
RedirectMatch 301 /workspace$ /workspace/

# WSM-PM
<Location /wsm-pm>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

# BIEE Analytics
<Location /analytics>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

<Location /analytics-ws>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

<Location /bicontent>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

<Location /mobile>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

<Location /va>    
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003 
</Location>

# MapViewer
<Location /mapviewer>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location> 

# BI Publisher
<Location /xmlpserver>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>
 
# BI Search
<Location /bisearch>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

# BI Composer
<Location /bicomposer>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

# EPM Provider Services
<Location /aps>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

# EPM Workspace
<Location /workspace>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>
  
# BI SOA Services
<Location /biservices>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>
 
# AdminService
<Location /AdminService>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>
 
# AsyncAdminService
<Location /AsyncAdminService>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>
 
#OWSM
<Location /wsm-pm>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location>

#BI Security
<Location /bi-security>
	SetHandler weblogic-handler
	WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
</Location> 

</VirtualHost>
  4. Create the bi_vh.conf file and add the following directives
    <VirtualHost WEBHOST1:7777>
   ServerName https://bi.example.com:443
   ServerAdmin you@your.address
   RewriteEngine On
   RewriteOptions inherit

#redirect browser requests that omit document/dir
RedirectMatch 301 /analytics$ /analytics/
RedirectMatch 301 /xmlpserver$ /xmlpserver/
RedirectMatch 301 /analytics/res$ /analytics/res/
RedirectMatch 301 /biofficeclient$ /biofficeclient/
RedirectMatch 301 /biservices$ /biservices/
RedirectMatch 301 /analytics-ws$ /analytics-ws/
RedirectMatch 301 /wsm-pm$ /wsm-pm/
RedirectMatch 301 /bisearch$ /bisearch/
RedirectMatch 301 /mapviewer$ /mapviewer/
RedirectMatch 301 /va$ /va/
RedirectMatch 301 /bicontent$ /bicontent/
RedirectMatch 301 /bicomposer$ /bicomposer/
RedirectMatch 301 /mobile$ /mobile/
RedirectMatch 301 /aps$ /aps/
RedirectMatch 301 /workspace$ /workspace/

# BIEE Analytics
<Location /analytics>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>

<Location /analytics-ws>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>

<Location /bicontent>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>

<Location /mobile>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>

<Location /va>
   SetHandler weblogic-handler    
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003    
   WLProxySSL ON    
   WLProxySSLPassThrough ON 
</Location>

# MapViewer
<Location /mapviewer>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location> 

# BI Publisher
<Location /xmlpserver>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>
 
# BI Search
<Location /bisearch>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>

# BI Composer

<Location /bicomposer>
   SetHandler weblogic-handler
   WebLogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>

# EPM Provider Services
<Location /aps>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>

# EPM Workspace
<Location /workspace>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>
 
# OWSM
<Location /wsm-pm>
   SetHandler weblogic-handler
   WeblogicCluster BIHOST1VHN:7003,BIHOST2VHN:7003
   WLProxySSL ON
   WLProxySSLPassThrough ON
</Location>

</VirtualHost>
  5. Restart the ohs1 instance:
    1. Change to the following directory:
      OHS_DOMAIN_HOME/bin
    2. Enter the following commands to stop and start the instance; provide the node manager password when prompted:
      ./stopComponent.sh ohs1
./startComponent.sh ohs1
  6. Copy the three .conf files (admin_vh.conf, biinternal_vh.conf, and bi_vh.conf) to the configuration directory for the second Oracle HTTP Server instance (ohs2) on WEBHOST2:
    OHS_DOMAIN_HOME/config/fmwconfig/components/OHS/ohs2/moduleconf
  7. Edit the .conf files and change any references from WEBHOST1 to WEBHOST2 in the <VirtualHost> directives.
  8. Restart the ohs2 instance:
    1. Change to the following directory:
      OHS_DOMAIN_HOME/bin
    2. Enter the following commands to stop and start the instance:
      ./stopComponent.sh ohs2
./startComponent.sh ohs2

Parent topic: Configuring Oracle HTTP Server to Route Requests to the Application Tier

Configuring the WebLogic Proxy Plug-In

Before you can validate that requests that are routed correctly through the Oracle HTTP Server instances, you must set the WebLogic Plug-In Enabled parameter for the clusters that you just configured. To configure the WebLogic Proxy Plug-in:

  1. Log in to the Oracle WebLogic Server Administration Console.
  2. In the Domain Structure pane, expand the Environment node.
  3. Click Lock & Edit in the Change Center.
  4. Click Clusters.
  5. Select the cluster to which you want to proxy requests from Oracle HTTP Server.

    The Configuration: General tab is displayed.

  6. Scroll down to the Advanced section and expand it.
  7. Set WebLogic Plug-In Enabled to yes.
  8. Click Save.
  9. If more than one cluster was deployed for the latest domain extension, repeat steps 4 through 8 until all the clusters are consistently updated.
  10. Click Activate Changes in the Change Center.
  11. Restart all Managed Servers in all the clusters that you modified in this chapter.

Parent topic: Configuring Oracle HTTP Server to Route Requests to the Application Tier

Validating the Virtual Server Configuration on the Load Balancer

From the load balancer, access the following URLs to ensure that your load balancer and Oracle HTTP Server are configured properly. These URLs should show the initial Oracle HTTP Server 12c web page.

  • http://admin.example.com/index.html

  • http://biinternal.example.com/index.html

  • https://bi.example.com/index.html

Parent topic: Configuring Oracle HTTP Server to Route Requests to the Application Tier

Validating Access to the Management Consoles and Administration Server

To verify the changes that you have made in this chapter:

  1. Use the following URL to the hardware load balancer to display the Oracle WebLogic Server Administration Console, and log in by using the Oracle WebLogic Server administrator credentials:

    http://admin.example.com/console

    This validates that the admin.example.com virtual host on the load balancer is able to route requests to the Oracle HTTP Server instances on the web tier, which in turn can route requests for the Oracle WebLogic Server Administration Console to the Administration Server in the application tier.

  2. Similarly, you should be able to access the Fusion Middleware Control by using a similar URL:

    http://admin.example.com/em

Parent topic: Configuring Oracle HTTP Server to Route Requests to the Application Tier

Validating HTTP Access to the Business Intelligence Components

After you configure the Oracle HTTP Server instances, you can validate your work by accessing key Oracle Business Intelligence URLs. If these URLs display the proper content, then you can be assured the Web tier components are configured correctly.

To validate HTTP access to the Oracle Business Intelligence components, enter each of the following URLs in your Web browser and make sure the proper content displays:

  • https://bi.example.com/analytics

  • https://bi.example.com/mapviewer

  • https://bi.example.com/xmlpserver

  • http://biinternal.example.com/wsm-pm

  • http://bi.example.com/bicomposer

  • http://bi.example.com/aps/Essbase

  • http://bi.example.com/aps/SmartView

Parent topic: Configuring Oracle HTTP Server to Route Requests to the Application Tier

Backing Up the Configuration

It is an Oracle best practices recommendation to create a backup after you successfully configure a domain or at another logical point. Create a backup after you verify that the installation so far is successful. This is a quick backup for the express purpose of immediate restoration in case of problems in later steps.

The backup destination is the local disk. You can discard this backup when the enterprise deployment setup is complete. After the enterprise deployment setup is complete, you can initiate the regular deployment-specific Backup and Recovery process. See Performing Backups and Recoveries for an Enterprise Deployment.

Parent topic: Configuring Oracle HTTP Server for an Enterprise Deployment