B Configuration Files

This appendix lists commonly used Oracle HTTP Server configuration files.

Files discussed are:

dms.conf
httpd.conf
iaspt.conf
mime.types
mod_oc4j.conf
mod_osso.conf
opmn.xml
oracle_apache.conf
php.ini
ssl.conf

B.1 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

B.2 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 much easier to manage a single configuration file.

Note:

If you have an Oracle Application Server installation in /home/your_directory/orahome and it is linked to /private/your_directory/orahome, the files in the installation are accessible from either /home/your_directory/orahome or /private/your_directory/orahome.

After installation, the httpd.conf file contains an entry for the dms.conf file that uses the original Oracle home path. For example:

include /home/your_directory/orahome/Apache/Apache/conf/dms.conf

Do not replace the original Oracle home path with the linked Oracle home path.

B.2.1 httpd.conf File Structure

httpd.conf is arranged in the following sections:

Global Environment
Main Server Configuration
Virtual Hosts Parameters

B.2.1.1 Global Environment

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

See Also:

B.2.1.2 Main Server Configuration

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

B.2.1.3 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.

B.3 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"

B.4 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"

B.5 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"

B.6 mod_osso.conf

Configures 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"

B.7 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. opmn.xml 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

B.8 oracle_apache.conf

Stores configuration files of supported modules.

It is located at:

UNIX: ORACLE_HOME/Apache/Apache/conf
Windows: ORACLE_HOME\Apache\Apache\conf

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.

B.9 php.ini

Configures mod_php. This file should not be renamed as PHP looks for this specific file name.

It is located at:

UNIX: ORACLE_HOME/Apache/Apache/conf
Windows: ORACLE_HOME\Apache\Apache\conf

See Also:

"mod_php"

B.10 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