Skip Headers

Oracle9i Application Server Release Notes Addendum
Release 2 (9.0.2.0.1) for Microsoft Windows
Part No. A90336-10
  Go To Documentation Library
Home
Go To Table Of Contents
Contents

Previous Next  

5 Oracle HTTP Server

This chapter discusses the following topics:

5.1 General Issues and Workarounds

This section describes general issues and their workarounds for Oracle HTTP Server.

5.1.1 SSO Wallet Not Supported

Oracle9iAS, Release 2 (9.0.2.0.1) for Windows does not support SSO wallet. You should use the SSLWalletPassword directive in httpd.conf instead.

Although SSO wallet is not supported, if you choose to use it, you have to change the owner of Oracle Process Manager service. Use the account that you enabled the SSO wallet with, instead of the default SYSTEM owner.

5.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds for Oracle HTTP Server.

5.2.1 Use a Full or Partial Host Name in Oc4jMount Syntax in mod_oc4j.conf File

While using the following Oc4jMount syntax in mod_oc4j.conf file:

Oc4jMount /path/* instance://[hostname]:<ias_instance>:<oc4j_instance> 

  • Be aware that the host name is optional. It is only necessary to specify it when there are some standalone Oracle9iAS instances installed on different hosts that have identical Oracle9iAS instance names, which is rare.

  • When host name is specified, be sure to test with both a partially qualified host name as well as a fully qualified host name to see which one works. The host name that works matches the host name stored in the OC4J registration event.

5.2.2 Configuring a Virtual Host Improperly Can Cause DADs to Break

After installation, if you wish to configure virtual hosts in the httpd.conf file, or by using the 'advanced' section of the EMD console, or by using a text editor on the httpd.conf file, use the following guidelines:

  1. Ensure that the server definitions for VirtualHosts are provided after the Port, Listen and ServerName directives. A simple example of a correctly set virtual host section might be as follows:

    #
    # these are set at the end of the httpd.conf file after the IAS installation
    occurs
    #
    Port 7778
    ServerName someServer.mycompany.com
    Listen 7779
    #
    # these lines were added manually to create a virtualHost
    #
    NameVirtualHost 1.2.3.4
    <VirtualHost 1.2.3.4>
        DocumentRoot /u01/app/oracle/product/iAS9020_portal/Vhost1.htdocs
        ServerName Vhost1.mycompany.com
    </VirtualHost>
    
    
  2. Ensure that if you use a regular text editor to make changes to the file, you use the following dcmctl utility to update your changes.

    <ORACLE_HOME>/dcm/bin/dcmctl updateConfig
    
    

    This is automatically done for you if you edit the file through the EMD console.

5.2.3 Oracle HTTP Server (1.0.2.2.x) Cannot Be Used with Oracle9iAS (9.0.2.x)

Oracle Corporation does not support using the Oracle HTTP Server component that is supplied with Oracle9iAS Release 1 (1.0.2.2.x) as a front end to the Containers for J2EE (OC4J) component supplied with Oracle9iAS Release 2 (9.0.2.x), that is, you must not use the mod_Proxy module to route data between these two components.

Always use the mod_oc4j module to route data to and from the OC4J component supplied with Oracle9iAS Release 2 (9.0.2.x). Use the mod_proxy module to route data between the HTTP Server component supplied with Oracle9iAS Release 1 (1.0.2.2.x) and the OC4J component supplied with Oracle9iAS Release 1 (1.0.2.2.x).

5.3 Administration Issues and Workarounds

This section describes administration issues and their workarounds for Oracle HTTP Server.

5.3.1 Stop and Start Oracle HTTP Server After Adding a SSL-Enabled Virtual Host

In Oracle9iAS, Release 2 (9.0.2.0.1), when you add a ssl-enabled virtual host to Oracle HTTP Server, you must stop and then start Oracle HTTP Server for this virtual host to function. Simply restarting Oracle HTTP Server will not enable the virtual host and may cause Oracle HTTP Server to crash, depending on your configuration. Virtual hosts that specify a wallet file but no wallet password will cause Oracle HTTP Server to crash on restart.

5.4 Documentation Errata

This section describes documentation issues and their workarounds for Oracle HTTP Server.

5.4.1 Incorrect Information in the "Configuring the IIS Listener for Single Sign-On" Section

Step 6 in the "Configuring the IIS Listener for Single Sign-On" section of the "Using Oracle9iAS Proxy Plug-in" appendix of the Oracle HTTP Server Administration Guide incorrectly states the following:

Restart IIS (stop and then start the IIS Server), ensuring that the oproxy filter is marked with a green up-pointing arrow.

It should say:

Restart IIS (stop and then start the IIS Server), ensuring that the osso filter is marked with a green up-pointing arrow.

5.4.2 LoginServerFile Example Gives Incorrect Syntax

In the "Using Single Sign-On with the Plug-in" section of appendix A of the Oracle HTTP Server Administration Guide, the "OSSO Configuration File Examples" incorrectly presents the syntax for the LoginServerFile directive with double quotes around the value.

The correct syntax is:

LoginServerFile = /path/config/sso_conf

5.4.3 Incorrect Information in Release Notes for iASOBF and SSO Wallet Support

Oracle HTTP Server Release Notes state the following:

IASOBF and SSO Wallet Support is User-dependent

To run the Oracle HTTP Server with SSL server correctly after installation, you should create a wallet and have the certificates contained within it signed by the proper Certificate Authorities. Make sure that the SSLWallet directive in httpd.conf points to this new wallet rather than the default wallet provided by the installation. Oracle HTTP Server will not start if you fail to do one of the following:

  • Obfuscate this new wallet's password by running:

    osslpassword -p password LocalSystem
    
    

    and place this obfuscated password in httpd.conf file using the Wallet Password directive (for example "WalletPassword obfuscatedPassword"). You can always choose to put the wallet password in httpd.conf in clear text but this is not recommended by Oracle.

  • Make this new wallet an SSO wallet as the root user.


    See Also:

    Oracle9i Application Server Security Guide

In the above issue, the command to obfuscate the new wallet's password should be changed to the following:

osslpassword -p password System

5.4.4 Oracle9i Application Server mod_plsql User's Guide

The Oracle9i Application Server mod_plsql User's Guide contains the following documentation errata:

  • In Section 2.6.8, "Direct BLOB Download", Step 2, the example:

    procedure download_blob(varchar2 name) is
    
    

    should be:

    create or replace procedure download_blob(name in varchar2) is
    
    
  • In Section 2.6.8, "Direct BLOB Download", Step 2b, the example:

    htp.p('Content-Length: ' || dbms_lob.get_length(myblob))
    
    

    should be:

    htp.p('Content-Length: ' || dbms_lob.getlength(myblob));