Tuesday, January 31, 2012

Customize the OHS Home Page

If your EPM 11.1.2.x configuration uses Oracle HTTP Server (OHS) as the front-end web server you have probably seen the page shown below. This is the Fusion Middleware welcome page that OHS is configured to display as its home page by default.

The OHS welcome page

The welcome page may be confusing to end users as it talks about Fusion Middleware but doesn not mention EPM or Hyperion at all so you might want to customize it to include some more appropriate content. Here are four easy steps to accomplish this:

  1. Log in to the web server in your EPM environment.
  2. Back up the original default page by renaming the file C:\Oracle\Middleware\user_projects\epmsystem1\httpConfig\ohs\config\OHS\ohs_component\htdocs\welcome-index.html to something like welcome-index.html.bak. Note that the file's location may vary depending on the location of EPM_ORACLE_HOME.
  3. Create a new text file called welcome-index.html with the HTML content you want to show.
  4. Save the text file and test the OHS address in a browser. You don't need to restart OHS but might need to do a forced refresh (Ctrl+F5) or clean your browser cache to see the modified version.

I often use a simple HTML page that just directs the browser to the Workspace URL (and also shows a link to Workspace should the redirectrion fail for any reason). The HTML code for this is shown below. Basically the code forces a refresh that will redirect the browser from the default page ( ) to the Workspace address ( ).

        <title>Oracle EPM</title>
        <meta http-equiv="refresh" content="0; url=">
        Oracle EPM Workspace: <a href=""></a>


  1. Your workspace URL is which means that you used port 80 as your Web server port (if I'm not wrong)

    May I assume that you don't have EPMA server or HFM or FDM running on port 80?

    1. In this case I was probably thinking about a customer environment where a network load balancer is used in front of the web server. In a normal case (without load balancing) you would be using port 19000 for Workspace. Thanks for pointing this out!

      I have installed environments where OHS has been listening to port 80 though. You need to configure IIS to use some non-default port instead but after that step everything has worked automatically and smoothly (the EPM config tool even detects the current IIS port for you).

  2. You've not talked about any modifications to httpd.conf file. Does it need any if I follow this approach?

    I wanted to know if this is something different to what was mentioned in Doc ID 1492021.1?

  3. No configuration changes are needed if you just modify the default OHS welcome page (welcome-index.html). In the Support document you mentioned they use a new document named "index.html".