1
Oracl
e HTTP Server Overview
This chapter describes the Oracle HTTP Ser
ver, highlighting the differences between the Oracle distribution and the open source Apache product on which it is based. It also ex
plains how to start, stop and restart the server.
Topics discussed are:
D
ocumentation 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.
|
Oracle HTTP Server Features
Oracle HTTP Server is the Web server c
omponent of Oracle Database. It is based on the Apache HTTP Server, version 1.3.28. It is a robust, reliable Web server, preconfigured to
do the following:
- provide a high availability infrastructure i
ntegration with Oracle Process Manager and Notification Server (OPMN)
, for process management, death detection and failover for Oracle HTTP Server processes.
- provide Dynamic Monitoring Services (DMS) m
etrics that give runtime performance statistics for Oracle HTTP Server processes.
- provide a request ID, which enhances request tracking th
rough various components by attaching a request ID to each request. This provides more detailed information, allowing you to see how
much time a particular request spends in any component or layer.
- enable securi
ng of transactions with Secure Sockets Layer (SSL) technology.
- <
/a>execute Perl scripts in the same process as the Oracle HTTP Server, or as CGI
strong> script.
- access database stored procedures with a PL/SQL engine.
<
p>
- e
nable scripting of HTML pages with PL/SQL code.
Oracle HTTP Server Components
Oracle HTTP Server consists of several components that run within the same process. These components provide the extensive lis
t of features that Oracle HTTP Server offers when handling client requests. Following are the major components:
- HTTP Listener: Oracle HTTP Server is based on an Apac
he HTTP listener to serve client requests. An HTTP server listener handles incoming requests and routes them to the appropriate proce
ssing utility.
- Modules (mods): Many of the stand
ard Apache modules are included with Oracle HTTP Server. Oracle also includes several internal modules that are specific to Oracle Da
tabase components.
- Perl Interpreter: A persistent Perl runtime environment embedded in Oracl
e HTTP Server through
mod_perl.
<
table class="NoteAlso" border="0" width="80%" cellpadding="0" cellspacing="0" dir="ltr" summary="This is a layout table to format a n
ote" title="This is a layout table to format a note">
| See Also:
Oracle Application Server 10g Concepts for more informat
ion regarding Oracle Database components, and how they relate to each other. |
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 HT
TP Server and other Oracle Database components. Note that the list differs from the Apache open source distribution (given the inclus
ion of Oracle modules), and that not all modules are supported by Oracle.
Table 1-1 Oracle HTTP Server Modules
font>
Oracle HTTP Server Support
<
p class="BP">Oracle provides technical support for the following Oracle HTTP Server features and conditions:
- Modules included in the Oracle distribution, except as noted in the table in Table 1-1, "Oracle HTTP Server Modules". Modules from any other source, including the Apache Software
Foundation, are not supported by Oracle.
- Problems that can be reproduced withi
n an Apache configuration consisting only of supported Oracle Apache modules.
-
Use of the included Perl interpreter within the supported Apache configuration.
Oracle HTTP Server Management
You can manage Oracle HTTP Server using opmnctl. It is the command-line utility f
or Oracle Process Manager and Notification Server (OPMN) for process management. It is located in
- UNIX:
ORACLE_HOME/opmn/bin
- Windows:
ORACLE_HOME\opmn\bin
Oracle HTTP
Server is managed by Oracle Process Manager and Notification Server (OPMN). You must always use the opmnctl utility to s
tart, stop and restart Oracle HTTP Server. Otherwise, the configuration management infrastructure cannot detect or communicate with t
he Oracle HTTP Server processes, and problems may occur.
Note:
Do not use the apachectl utility to manage th
e Oracle HTTP Server.
|
To determine the state of Oracle H
TTP Server, use the following command:
opmnctl status
The processes are listed with their current state such as "Up" or "Down".
<
!--TOC=h2-"1006865"-->
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
- Wi
ndows:
ORACLE_HOME\opmn\bin> opmnctl [verbose] startproc ias-component=HTTP_
Server
Stopping Oracle HTTP Server
To stop Oracle HTTP Server, u
se the stopproc command:
- UNIX:
ORACLE_H
OME/opmn/bin> opmnctl [verbose] stopproc ias-component=HTTP_Server
- Windows:
ORACLE_HOME\opmn\bin> opmnctl [verbos
e] stopproc ias-component=HTTP_Server
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 c
urrent 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, MaxS
pareServers, MinSpareServers) specified, and takes the current server load into account.
a>
To restart Oracle HTTP Server, use the restartproc command:
- UNIX:
ORACLE_HOME/opmn/bin> opmnctl [verbose] r
estartproc ias-component=HTTP_Server
- Windows:
ORACLE_HOME\opmn\bin> opmnctl [verbose] restartproc ias-component=HTTP_Server
<
/li>