Configuration Overview

In this section:

How to:

You have several configuration options for WebFOCUS. This section addresses web server and application server deployment.

Important: For a split-tier environment, see Configuring WebFOCUS in a Split Web-Tier and Application Server-Only Environment.

Top of page

Procedure: How to Configure a Web Server and an Application Server for WebFOCUS

The following is an overview of the steps needed to configure the web or application server for WebFOCUS.

  1. Ensure application server and web server components are installed and properly functioning. Refer to third-party documentation, if necessary.

    If you do not have an application server, the WebFOCUS Client installation can install and configure Apache Tomcat for you.

  2. Configure the application server to support WebFOCUS graphics. To do this, you must either set the DISPLAY variable to an X Windows Server or set the Java VM headless option (-Djava.awt.headless=true).
  3. Add the WebFOCUS repository JDBC driver to your application server CLASSPATH.
  4. Deploy the WebFOCUS web application on the application server.

    WebFOCUS components are packaged as a J2EE web application. The web application is provided as the following WAR file:


    It is also provided as the following expanded directory:


    You can deploy either the WAR files or expanded directories, depending on your preference and the capabilities of your application server. Be aware that when applying a service pack, any changes made to the web applications must be in the expanded directories to be maintained.

    The default deployment parameters for WebFOCUS are:

    Context Root/Path

    Doc base or location


  5. Ensure your web server routes requests for the web application context root (/ibi_apps, /ibi_help, and /approot) to the application server.

    Note: For information on manually configuring the ibi_html alias, see Removal of the ibi_html WebFOCUS Alias.

  6. Verify the configuration using the tools in the WebFOCUS Administration Console, as explained in WebFOCUS Post-Installation Tasks.

    Note: If you are installing multiple instances, completely install and configure a single instance, and then refer to Additional WebFOCUS Repository Topics and Tasks for instructions on configuring the second instance.

Top of page

Documented Configurations

The following configurations are explained in this chapter:

For other web and/or application servers, review the information for the servers above and consult your third party documentation for the corresponding steps.

Note: If you changed the default names for the WebFOCUS context root (/ibi_apps), substitute accordingly.