A
Oracle HTTP Server Configuration Files

This appendix lists commonly used Oracle HTTP Server configuration files.

Files discussed are:

• httpd.conf
• opmn.xml

Documentation from the Apache Software Foundation is referenced when applicable.

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

Global Environment

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

Main Server Configuration

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

Virtual Hosts

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 A-1 illustrates the file structure of the httpd.conf file.

Figure A-1 httpd.conf File

Text description of the illustration conffiles.gif

As shown in Figure A-1, httpd.conf contains directives to include configuration files such as:

• mime.types
• dms.conf
• oracle_apache.conf
• ssl.conf

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

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
• 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

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 A-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 Database installation.

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

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

• <ias-component>: This entry represents the Oracle Database 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 Database 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