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:
The attributes for the LoadBalancer, Ping, and Host elements are shown in the following table.
|
|
|
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.
|
|
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.
|