D
Oracle HTTP Server Configuration Files

This appendix lists commonly used Oracle HTTP Server configuration files.

Files discussed are:

• iaspt.conf

• httpd.conf

• opmn.xml

Documentation from the Apache Software Foundation is referenced when applicable.

Note: Readers using this guide in PDF or hard copy formats will be unable to access third-party documentation, which Oracle provides in HTML format only. To access the third-party documentation referenced in this guide, use the HTML version of this guide and click on the hyperlinks.

iaspt.conf

Configures the port tunneling process. Port tunneling allows all communication between Oracle HTTP Server and OC4J to happen on a single, or a small number of ports.

It is located at:

• UNIX: ORACLE_HOME/iaspt/conf

• Windows: ORACLE_HOME\iaspt\conf

  See Also: "Understanding Port Tunneling"

httpd.conf

This is a server configuration file which typically contains directives that affect how the server runs, such as user and group IDs it should use, and location of other files. Because the server configuration file is the main file that the server starts with, Oracle HTTP Server does not include any directive that says where to locate it. The location is passed on command line when the server starts.

It is located at:

• UNIX: ORACLE_HOME/Apache/Apache/conf/httpd.conf

• Windows: ORACLE_HOME\Apache\Apache\conf\httpd.conf

You should use only this file, and not srm.conf or access.conf because it is must easier to manage a single configuration file.

httpd.conf File Structure

httpd.conf is arranged in the following sections:

• Global Environment

• Main Server Configuration

• Virtual Hosts Parameters

Global Environment

This is section one of the httpd.conf file. It contains configuration directives dealing with Oracle HTTP Server.

See Also: "Specifying File Locations" "Limiting the Number of Processes and Connections" Chapter , "Specifying Listener Ports and Addresses"

Main Server Configuration

This is section two of the httpd.conf file. It contains the directives of the default server.

See Also: "Setting Server and Administrator Functions".

Virtual Hosts Parameters

This is section three of the httpd.conf file.It contains parameters specific to virtual hosts, which override some of the main server configuration defaults.

Figure D-1 illustrates the file structure of the httpd.conf file.

Figure D-1 httpd.conf File

Text description of the illustration conffiles.gif

Note: For the Oracle Application Server Infrastructure install type, another configuration file is included by oracle_apache.conf called oracle_ocm.conf. It contains configuration for Oracle Application Server Certificate Authority.

As per Figure D-1, httpd.conf contains directives to include configuration files such as:

• jserv.conf

• mime.types

• dms.conf

• mod_oc4j.conf

• mod_osso.conf

• oracle_apache.conf

• ssl.conf

jserv.conf

jserv.conf loads the Apache JServ communication module. The module is not loaded by default.

It is located at:

• UNIX: ORACLE_HOME/Apache/Jserv/etc

• Windows: ORACLE_HOME\Apache\Jserv\etc

  See Also: "mod_jserv"

mime.types

mime.types controls the Multi Internet media types that are sent to the client for the given file extensions. Sending the correct media type to the client is important so that the client knows how to handle the content of the file. You can add extra types in the mime type file or add an AddType directive in the configuration file.

It is located at:

• UNIX: ORACLE_HOME/Apache/Apache/conf

• Windows: ORACLE_HOME\Apache\Apache\conf

  See Also: "mod_mime"

dms.conf

dms.conf enables you to monitor performance of site components with Oracle's Dynamic Monitoring Service (DMS).

It is located at:

• UNIX: ORACLE_HOME/Apache/Apache/conf

• Windows: ORACLE_HOME\Apache\Apache\conf

  See Also: Oracle Application Server 10g Performance Guide

mod_oc4j.conf

mod_oc4j.conf configures and loads the mod_oc4j module, and is enabled by default. It routes requests from Oracle HTTP Server to OC4J, and therefore contains routing information.

It is located at:

• UNIX: ORACLE_HOME/Apache/Apache/conf

• Windows: ORACLE_HOME\Apache\Apache\conf

  See Also: "mod_oc4j"

mod_osso.conf

mod_osso.conf is the configuration file for mod_osso, which enables single sign-on for Oracle HTTP Server.

It is located at:

• UNIX: ORACLE_HOME/Apache/Apache/conf

• Windows: ORACLE_HOME\Apache\Apache\conf

  See Also: "mod_osso"

oracle_apache.conf

oracle_apache.conf is included in the main configuration file to store configuration files of supported modules. It contains directives to include the following configuration files:

• aqxml.conf

• moddav.conf

• ojsp.conf

• plsql.conf

• xml.conf

aqxml.conf

aqxml.conf enables and configures Advanced Queuing.

It is located at:

• UNIX: ORACLE_HOME/Apache/Apache/conf

• Windows: ORACLE_HOME\Apache\Apache\conf

moddav.conf

moddav.conf configures and loads the mod_oradav module to enable distributed authoring and versioning of Web documents.

It is located at:

• UNIX: ORACLE_HOME/Apache/oradav/conf

• Windows: ORACLE_HOME\Apache\oradav\conf

  See Also: Chapter 9, "Configuring and Using mod_oradav" "mod_oradav"

ojsp.conf

ojsp.conf configures Java Server Pages.

It is located at:

• UNIX: ORACLE_HOME/Apache/jsp/conf

• Windows: ORACLE_HOME\Apache\jsp\conf

plsql.conf

plsql.conf configures and loads the PL/SQL module.

It is located at:

• UNIX: ORACLE_HOME/Apache/modplsql/conf

• Windows: ORACLE_HOME\Apache\modplsql\conf

  See Also: "mod_plsql"

xml.conf

xml.conf is associated the .xsql extension with the XSQL servlet.

It is located at:

• UNIX: ORACLE_HOME/xdk/admin

• Windows: ORACLE_HOME\xdk\admin

  Example D-1 oracle_apache.conf file

  # Advanced Queuing - AQ XML
  include "/private1/oracle/Apache/Apache/conf/aqxml.conf"
  #
  #Directives needed for OraDAV module
  include "/private1/oracle/Apache/oradav/conf/moddav.conf"
  include "/private1/oracle/Apache/jsp/conf/ojsp.conf"
  include "/private1/oracle/Apache/modplsql/conf/plsql.conf"
  #
  include "/private1/oracle/xdk/admin/xml.conf"
  #
  
  

ssl.conf

ssl.conf includes the SSL definitions and virtual host container. Out of the box, it is disabled by default.

It is located at:

• UNIX: ORACLE_HOME/Apache/Apache/conf

• Windows: ORACLE_HOME\Apache\Apache\conf

opmn.xml

opmn.xml describes the processes that Oracle Process Manager and Notification Server (OPMN) manages within an Oracle Application Server installation.

The opmn.xml file is the main configuration file for OPMN. It contains information for the ONS, the PM, and Oracle Application Server component-specific configuration.The opmn.xml file shows you which Oracle Application Server components OPMN is managing on your system. It contains Oracle Application Server component entries arranged in the following hierarchical structure:

<ias-component> 
  <process-type> 
    <process-set> 

• <ias-component>: This entry represents the Oracle Application Server component. It enables management of the component for processes such as starting and stopping.

• <process-type>: This subcomponent of the <ias-component> entry declares the type of process to run by association with a specific PM module.

• <process-set>: This sub-subcomponent of the <ias-component> entry enables you to declare different sets of optional runtime arguments and environments for the Oracle Application Server component.

opmn.xml is located at:

• UNIX: ORACLE_HOME/opmn/conf

• Windows: ORACLE_HOME\opmn\conf

  See Also: Oracle Process Manager and Notification Server Administrator's Guide