Manually Configuring Oracle HTTP Server

You can choose to manually configure the Oracle HTTP Server installed by EPM System Installer instead of configuring it with EPM System Configurator.

If you are using a supported web server other than the Oracle HTTP Server that is installed by EPM System Installer, you must manually configure the web server.

Manual web server configuration notes:

Manual configuration of IIS is not supported.

This section assumes you have already used EPM System Configurator to configure EPM System components and deployed Java web applications manually or by using EPM System Configurator.

  To manually configure Oracle HTTP Server:

  1. Launch EPM System Configurator: Change to EPM_ORACLE_INSTANCE\BIN and then launch configtool.bat|sh.

  2. In EPM System Configurator, on the Task Selection panel, select Uncheck All, expand Hyperion Foundation, select Configure Web Server, and then click Next.

  3. In Configure Web Server, from Web Server Type, select Setup Registry for manual web server configuration, and then click Next.

  4. Complete the steps in EPM System Configurator and, when configuration is complete, click Finish.

    EPM System Configurator creates autogenerated files in EPM_ORACLE_INSTANCE/httpConfig/autogenerated/ohs to simplify manual web server configuration.

  5. Copy the autogenerated files to a location of your choice related to your installation of Oracle HTTP Server.

  6. If you configured Oracle HTTP Server and EPM System components to use SSL, update files as follows:

    • Update the port in ssl.conf in the “Listen” directive and in the <VirtualHost> tree-directive.

    • Update the port in httpd.conf in the “Listen” directive to any port other than the SSL port.

    • Update the port in HYSL-WebLogic-autogenerated.conf in the <VirtualHost> tree-directive to any port other than the SSL port.

  7. Update HYSL-WebLogic-autogenerated.conf as follows:

    • If necessary, update all “LoadModule” directives so that the ${ORACLE_HOME} environment variable is correct.

    • Update the OHS_LISTEN_PORT alias and replace it with the actual value, for example <VirtualHost *:OHS_LISTEN_PORT> would be <VirtualHost *:19000>.

    • Update the following lines with the actual file location:

      Include "conf/epm_online_help.conf"
      Include "conf/epm_rewrite_rules.conf"
      Include "conf/epm.conf"

      For example:

      Include "path_to_conf_files/epm_online_help.conf"
      Include "path_to_conf_files/epm_rewrite_rules.conf"
      Include "path_to_conf_files/epm.conf"
  8. In the Oracle HTTP Server installation folder, browse to httpd.conf, open it in a text editor, and make the following changes:

    1. Comment all the lines that contain ssl.conf and mod_wl_ohs.conf.

    2. Add the following lines to the end of the file:

      • Include path_to_modified_conf_files/HYSL-WebLogic-autogenerated.conf

      • Include path_to_modified_conf_files/ssl.conf

        where ssl.conf is the autogenerated file

      You can use UNC-style paths on Windows only if the Oracle HTTP Server Windows Service is running as a user account that has network access and has "Logon as a service" rights.

    3. Update the “Listen” directive with the actual web server's port.

  9. If you are using Financial Close Management or Tax Governance, perform the following tasks:

    1. On the machine hosting the web server, copy the autogenerated file EPM_ORACLE_INSTANCE/httpConfig/autogenerated/soa/mod_wl_ohs.conf, and rename it to mod_wl_soa_ohs.conf.

    2. Open mod_wl_soa_ohs.conf in a text editor and replace soa_server_host:soa_server_port and admin_server_host:admin_server_port with the actual values for the SOA host and port and the WebLogic Administration Server host and port.

    3. Copy the modified mod_wl_soa_ohs.conf to EPM_ORACLE_INSTANCE/httpConfig/ohs/config/OHS/ohs_component/conf.

    4. Open EPM_ORACLE_INSTANCE/httpConfig/ohs/config/OHS/ohs_component/httpd.conf in a text editor and add the following line inside of the <VirtualHost> tag:

      Include “conf/mod_wl_soa_ohs.conf"

      For example:

      <VirtualHost *:19000>
          include "conf/mod_wl_ohs.conf"
          Include "conf/epm_online_help.conf"
          Include "conf/epm_rewrite_rules.conf"
          Include "conf/epm.conf"
          Include "conf/mod_wl_soa_ohs.conf"
      </VirtualHost>
      
    5. Restart Oracle HTTP Server.

  10. Update the WEB_SERVER component in the Shared Services Registry so that the port property is the actual value of the port on which Oracle HTTP Server is running. For example, to change the actual port to 19000:

    1. Generate a registry report by launching EPM_ORACLE_INSTANCE/bin/epmsys_registry.bat. Enter the Shared Services database password when prompted.

    2. Look for the WEB_SERVER component with properties "type" = MANUAL, "port" = -1, and "instance_home" with the EPM_ORACLE_INSTANCE that is configured.

    3. Look for the object id for the WEB_SERVER component, and copy it into following command:

      EPM_ORACLE_INSTANCE/bin/epmsys_registry.bat updateproperty #object_id/@property_name property_value

      For example:

      EPM_ORACLE_INSTANCE/bin/epmsys_registry.bat updateproperty #df17801dfc1dca40S24e400aa13a736f8a46S7921/@port 19000
  11. Restart Oracle HTTP Server and EPM System servers.