Skip Headers
Oracle® HTTP Server Administrator's Guide
10g Release 2 (10.2)

Part Number B14190-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

1 Overview

This chapter describes the Oracle HTTP Server, highlighting the differences between the Oracle distribution and the open source Apache product on which it is based. It also explains how to start, stop, and restart the server.

Topics discussed are:

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 the hyperlinks.

1.1 Oracle HTTP Server Features

Oracle HTTP Server is the Web server component of Oracle Database. Based on the Apache infrastructure, Oracle HTTP Server is a robust, reliable Web server, preconfigured to do the following:

1.2 Oracle HTTP Server Components

Oracle HTTP Server consists of several components that run within the same process. These components provide the extensive list of features that Oracle HTTP Server offers when handling client requests. Major components are:

1.2.1 Oracle HTTP Server Modules

Table 1-1 identifies the modules shipped with Oracle HTTP Server. Modules extend the basic functionality of the Web server, and support integration between Oracle HTTP Server and other Oracle Database components. Note that the list differs from the Apache open source distribution (given the inclusion of Oracle modules).

Table 1-1 Oracle HTTP Server Modules

Module Note Module Note
mod_access
 
mod_log_agent
Deprecated
mod_actions
 
mod_log_config
 
mod_alias
 
mod_log_referer
Deprecated
mod_asis
 
mod_mime
 
mod_auth
 
mod_mime_magic
 
mod_auth_anon
 
mod_mmap_static

mod_auth_dbm
 
mod_negotiation

mod_autoindex
 
mod_onsint
Oracle module
mod_cern_meta
 
mod_ossl
Oracle module
mod_certheaders
Oracle module mod_perl
 
mod_cgi
 
mod_php
 
mod_define
UNIX systems only mod_plsql
Oracle module 
mod_digest
 
mod_proxy
 
mod_dir
 
mod_rewrite
 
mod_dms
Oracle module mod_security
 
mod_env
 
mod_setenvif
 
mod_example
 
mod_speling
 
mod_expires
 
mod_status
 
mod_fastcgi
 
mod_unique_id
 
mod_headers
 
mod_userdir
 
mod_imap
 
mod_usertrack
 
mod_include
 
mod_vhost_alias
 
mod_info
 
mod_wchandshake
Oracle module 

1.3 Oracle HTTP Server Support

Oracle provides technical support for the following Oracle HTTP Server features and conditions:

1.4 Oracle HTTP Server Management

You can manage Oracle HTTP Server using opmnctl. It is the command-line utility for Oracle Process Manager and Notification Server (OPMN) for process management. It is located in the following directories:

1.5 Starting, Stopping, and Restarting Oracle HTTP Server

Oracle HTTP Server is managed by Oracle Process Manager and Notification Server (OPMN). You must always use OPMN to start, stop and restart Oracle HTTP Server. Otherwise, the configuration management infrastructure cannot detect or communicate with the Oracle HTTP Server processes, and problems may occur.

Note:

Do not use the apachectl utility to manage Oracle HTTP Server.

To determine the state of Oracle HTTP Server, use the following command:

opmnctl status

The processes are listed with their current state (Up, Down, and so on.)

1.5.1 Starting Oracle HTTP Server

To start Oracle HTTP Server, use the startproc command:

  • UNIX: ORACLE_HOME/opmn/bin> opmnctl [verbose] startproc ias-component=HTTP_Server

  • Windows: ORACLE_HOME\opmn\bin> opmnctl [verbose] startproc ias-component=HTTP_Server

1.5.2 Stopping Oracle HTTP Server

To stop Oracle HTTP Server, use the stopproc command:

  • UNIX: ORACLE_HOME/opmn/bin> opmnctl [verbose] stopproc ias-component=HTTP_Server

  • Windows: ORACLE_HOME\opmn\bin> opmnctl [verbose] stopproc ias-component=HTTP_Server

1.5.3 Restarting Oracle HTTP Server

Restarting Oracle HTTP Server performs a graceful restart, which is invisible to clients. In a graceful restart, on UNIX, a USR1 signal is sent. When the process receives this signal, it tells the children to exit after processing the current request. (Children that are not servicing requests exit immediately.)

The parent re-reads the configuration files and re-opens the log files, replacing the children with new children in accordance with the settings it finds when re-reading the configuration files. It always observes the process creation settings (MaxClients, MaxSpareServers, MinSpareServers) specified, and takes the current server load into account.

To restart Oracle HTTP Server, use the restartproc command: