Bookshelf Home | Contents | Index | PDF     

Oracle® Business Intelligence Enterprise Edition Deployment Guide > Clustering, Load Balancing, and Failover in Oracle Business Intelligence > Configuration of BI Components for Clustering, Load Balancing, and Failover >

Configuring BI Presentation Services Plug-in

BI Presentation Services Plug-in must be configured to direct requests to the BI Presentation Services instances in the deployment.

BI Presentation Services consists of two types:

Configuring BI Presentation Services Plug-in (ISAPI Plug-in)

The instances of BI Presentation Services that the BI Presentation Services Plug-in can direct requests to is specified in the ServerConnectInfo element the in the isapiconfig.xml. The isapiconfig.xml file is located in OracleBIDATA_HOME\web\config.

The top level element, ServerConnectInfo, contains the following elements:

  • LoadBalancer

    Contains the Ping element.

  • Hosts

    Contains one or more Host elements. Each Host element identifies a specific instance of BI Presentation Services and port.

The attributes for the LoadBalancer, Ping, and Host elements are shown in the following table.

Element
Attribute
Attribute Description

LoadBalancer

autoRoute

Specifies whether to automatically redirect requests to another instance of Oracle BI Presentation Services if the current server fails:

  • True. Automatically redirects requests.
  • False. Does not automatically redirect requests. (The default setting is false).

encryptHostID

Specifies whether to encrypt the value of the cookie used for session binding.

  • True. Encrypts the cookie value. (The default setting is true.)
  • False. Does not encrypt the cookie value.

LoadBalancer/Ping

keepAliveMaxFailures

Specifies the number of ping failures required before the host is declared dead. The default is 5.

keepAliveFrequencySecs

Specifies the ping frequency in seconds. The default is 20.

Hosts/Host

Address

Identifies the BI Presentation Services instance.

Port

Identifies the port number that BI Presentation Services is listening on. The default is 9710

When more than one Host element is specified, load balancing of requests to the multiple BI Presentation Services instances is automatically enabled.

The following is an example of a ServerConnectInfo entry.

<?xml version="1.0" encoding="utf-8" ?>
<WebConfig>
   <ServerInstance>
      <ServerConnectInfo>
         <LoadBalancer autoRoute="true"/>
            <Hosts>
               <Host address="BI Presentation Services Machine1" port="9710"/>
               <Host address="BI Presentation Services Machine2" port="9710"/>
            </Hosts>
      </ServerConnectInfo>
   </ServerInstance>
</WebConfig>

NOTE:  This configuring must be performed for all BI Presentation Services Plug-in instances in the deployment.

Configuring BI Presentation Services Plug-in (Java Servlet)

The instances of BI Presentation Services that the BI Presentation Services Plug-in can direct requests to is specified in the web.xml file for the Java Servlet. The default version of this file is located in OracleBI_HOME\web\app\WEB-INF on Windows and OracleBI_HOME/web/app/WEB-INF on Linux or UNIX.

The following table contains parameters for the Java Servlet.

Connection
Element Description

oracle.bi.presentation.Sawservers

Identifies the Oracle BI Presentation Services instances that requests can be directed to. The value of this element is a list of host:port pairs, with each pair identifying a BI Presentation Services instance.

oracle.bi.presentation.sawconnect.
loadbalance.AlwaysKeepSessionAffiliation

Controls whether requests belonging to the same session can be redirected to another instance of Oracle BI Presentation Services if the current Oracle BI Presentation Services instance score is too low:·

  • Y. Allows redirection of requests.
  • N. Disallows redirection of requests.

The following entry is an example of a web.xml file.

<init-param>
   <param-name>oracle.bi.presentation.Sawservers</param-name>
   <param-value>server1:port;server2:port2;server3:port</param-value>
   <param- name>oracle.bi.presentation.sawconnect.loadbalance.AlwaysKeepSessionAffliation
   </param-name>
   <param-value>Y</param-value>
</init-param>

Where server:port identifies the BI Presentation Services instance. The default port that BI Presentation Services listens on is 9710.

NOTE:  This configuration must be performed on all machines where the BI Presentation Services Plug-in Java Servlet has been deployed.

  
Oracle® Business Intelligence Enterprise Edition Deployment Guide Copyright © 2006, Oracle. All rights reserved.