Oracle® Business Intelligence Enterprise Edition Deployment Guide > Other Deployment-Related Topics > Improving Oracle BI Web Client Performance >

Static File Bypass


In deployments using J2EE based application servers, performance can be improved by configuring the HTTP Server to serve the static files. By default, the static file requests for Oracle BI are served by the J2EE server.

Because the Oracle BI static files reside outside the HTTP Server's document root, you must configure the HTTP Server to access the files from a file system that is not the document root for the HTTP Server. Consult your vendor documentation for more information on configuring the HTTP Server to access files not residing in the document root.

On Apache HTTP Servers, the Alias directive may be used to map file systems that lie outside documentroot to the web space.

Use the following procedure to configure the bypass of Oracle BI static files from the J2EE server and directing Oracle HTTP Server to serve the static file requests.

To bypass static files when using Oracle Application Server

  1. Open the httpd.conf file for editing.

    This file is located in $ORACLE_HOME/Apache/Apache/conf.

  2. Verify that the following directive is not commented out in the httpd.conf file:

    LoadModule expires_module modules/mod_expires.so

    NOTE:  For Apache versions prior to 1.3.15 on Windows, the directive is LoadModule expires_module modules/ApacheModuleExpires.dll

  3. Add the following configuration into the httpd.conf file:

    <Directory $ORACLE_HOME\j2ee\home\applications\analytics\analytics\res>
    Order allow,deny
    Allow from all
    </Directory>

    <Directory $ORACLE_HOME\j2ee\home\applications\analytics\analytics\olh>
    Order allow,deny
    Allow from all
    </Directory>

    Alias /OBIContent_res $ORACLE_HOME\j2ee\home\applications\analytics\analytics\res

    Alias /OBIContent_olh $ORACLE_HOME\j2ee\home\applications\analytics\analytics\olh


    <VirtualHost *:*>
    #ServerName bi.mycompany.com
    RewriteEngine on
    RewriteRule ^/analytics/res/(.*)$ /OBIContent_res/$1 [PT]
    RewriteRule ^/analytics/olh/(.*)$ /OBIContent_olh/$1 [PT]
    </VirtualHost>

    where:

    The aliases OBIContent_res and OBIContent_olh are used to map the static files located in the following directories on the J2EE server:

    • $ORACLE_HOME\j2ee\home\applications\analytics\analytics\res
    • $ORACLE_HOME\j2ee\home\applications\analytics\analytics\olh

      NOTE:  Replace bi.mycompany.com with the virtual host name for your deployment.

  4. If SSL has been enabled on the HTTP Server, add the following lines to the ssl.conf file located in the same directory as httpd.conf:

    RewriteEngine on
    RewriteRule ^/analytics/res/(.*)$ /OBIContent_res/$1 [PT]
    RewriteRule ^/analytics/olh/(.*)$ /OBIContent_olh/$1 [PT]

    As shown below:
    <VirtualHost _default_:443>
    # General setup for the virtual host

    DocumentRoot "C:\OAS10.1.3\OracleAS_1\Apache\Apache\htdocs"
    ServerName bi.mycompany.com


    RewriteEngine on
    RewriteRule ^/analytics/res/(.*)$ /OBIContent_res/$1 [PT]
    RewriteRule ^/analytics/olh/(.*)$ /OBIContent_olh/$1 [PT]

    ServerAdmin you@your.address

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