2
Oracle HTTP Server Migration

This chapter explains the process of migrating the Oracle HTTP Server. Each section includes information for JDK migration, servlet migration, and mod_ssl migration, where applicable.

The migration topics for this component are:

• Premigration

• Environment

• Configuration

• Application Logic

• Tools

Premigration

Make backup copies of the following default installation files before doing any migration tasks:

• NEW_HOME\Apache\Apache\conf\httpd.conf

• NEW_HOME\Apache\Jserv\conf\jserv.conf

• NEW_HOME\Apache\Jserv\conf\jserv.properties

• NEW_HOME\Apache\Jserv\servlets\zone.properties

• NEW_HOME\Apache\Apache\conf\oracle_apache.conf

Environment

No environment migration tasks are necessary.

Configuration

The following sections explain changes you must make to your configuration files so that Oracle HTTP Server continues to work as it did in Oracle Internet Application Server Release 1.0.1.

Table 2-1 lists the files that may be affected by the migration from release 1.0.1 to release 1.0.2.

Table 2-1 Configuration Files Used by Oracle HTTP Server

Configuration File	Description
NEW_HOME\Apache\Apache\conf\httpd.conf	The main HTTP server configuration file.
NEW_HOME\Apache\Jserv\conf\jserv.conf	Java servlet engine configuration file.
NEW_HOME\Apache\Jserv\conf\jserv.properties	Java servlet engine configuration file.
NEW_HOME\Apache\Jserv\servlets\zone.properties	Java servlet zone configuration file.
NEW_HOME\Apache\Apache\conf\oracle_apache.conf	Oracle configuration file.

HTTP Server, JDK, and servlets

The configuration files supplied with the Oracle9i Application Server Release 1.0.2 installation will support all of the applications deployed in release 1.0.1 without modification, unless you have changed the release 1.0.1 configuration files. In that case, you must apply those changes to the release 1.0.2 files.

Oracle has made a number of changes to these files in release 1.0.2. The changes are listed below. To migrate your files, compare your configuration files in OLD_HOME with those in NEW_HOME. In a text editor, make any changes necessary to the configuration file in NEW_HOME to match the file in OLD_HOME.

The following sections list changes made to the new configuration files by Oracle. You should not overwrite these changes when restoring your OLD_HOME configuration settings.

httpd.conf

The Oracle changes to httpd.conf are listed below.

• The LoadModule directive is uncommented for:
  • ApacheModuleAuthAnon.dll
  • ApacheModuleCERNMeta.dll
  • ApacheModuleDigest.dll
  • ApacheModuleHeaders.dll
  • ApacheModuleRewrite.dll
  • ApacheModuleSpeling.dll
  • ApacheModuleUserTrack.dll

• The AddModule directive is added for:
  • mod_rewrite.c
  • mod_speling.c
  • mod_auth_anon.c
  • mod_cern_meta.c
  • mod_digest.c
  • mod_headers.c
  • mod_usertrack.c

• In the server-status section, Allow from localhost is changed to Allow from localhost hostname.

jserv.conf

Oracle made no changes to jserv.conf. If you have changed it, you must apply the changes to this file in NEW_HOME.

jserv.properties

The Oracle changes to jserv.properties are listed below.

• A wrapper.classpath directive is added for:
  • aurora_client.jar
  • vbjorb.jar
  • vbjapp.jar

Additional appended lines or directives may have been added by other Oracle9i Application Server components and are contained within comment fields identifying the component. See the chapter for a given component to determine the necessary migration tasks.

oracle_apache.conf

Oracle made no changes to oracle_apache.conf. If you have changed it, you must apply the changes to this file in NEW_HOME.

zone.properties

Oracle made no changes to zone.properties. If you have changed it, you must apply the changes to this file in NEW_HOME.

mod_ssl

Both Oracle Internet Application Server 1.0.1 and Oracle9i Application Server 1.0.2 use open_ssl 0.9.5a. To migrate the mod_ssl configuration, you must copy the configuration files listed in Table 2-2 from the version OLD_HOME to NEW_HOME.

Table 2-2 Migration of mod_ssl configuration files

Copy all files from:	To:
OLD_HOME\Apache\Apache\conf\ssl.crl\	NEW_HOME\Apache\Apache\conf\ssl.crl\
OLD_HOME\Apache\Apache\conf\ssl.crt\	NEW_HOME\Apache\Apache\conf\ssl.crt\
OLD_HOME\Apache\Apache\conf\ssl.csr\	NEW_HOME\Apache\Apache\conf\ssl.csr\
OLD_HOME\Apache\Apache\conf\ssl.key\	NEW_HOME\Apache\Apache\conf\ssl.key\
OLD_HOME\Apache\Apache\conf\ssl.prm\	NEW_HOME\Apache\Apache\conf\ssl.prm\

Changing httpd.conf for mod_ssl migration

To migrate mod_ssl, you must replace the path of the version 1.0.1 Oracle home with the path of the version 1.0.2 Oracle home in httpd.conf, which is shown as NEW_HOME in the example below. You can safely replace the files in NEW_HOME with the files from OLD_HOME.

#SSLSessionCache shm:NEW_HOME/Apache/Apache/logs/ssl_scache(512000)
SSLSessionCache dbm:NEW_HOME/Apache/Apache/logs/ssl_scache

SSLLog NEW_HOME/Apache/Apache/logs/ssl_engine_log
SSLCertificateFile NEW_HOME/Apache/Apache/conf/ssl.crt/server.crt
SSLCertificateKeyFile NEW_HOME/Apache/Apache/conf/ssl.key/server.key
#SSLCertificateChainFile NEW_HOME/Apache/Apache/conf/ssl.crt/ca.crt
#SSLCACertificatePath NEW_HOME/Apache/Apache/conf/ssl.crt
#SSLCACertificateFile NEW_HOME/Apache/Apache/conf/ssl.crt/ca-bundle.crt
#SSLCARevocationPath NEW_HOME/Apache/Apache/conf/ssl.crl
#SSLCARevocationFile NEW_HOME/Apache/Apache/conf/ssl.crl/ca-bundle.crl

Application Logic

This section describes the migration tasks related to application logic when migrating the HTTP Server and its components.

HTTP Server

There are no differences in the Oracle HTTP Server shipped with Oracle9i Application Server release 1.0.2 that affect deployment of applications from Oracle Internet Application Server release 1.0.1.

JDK

Java applications compiled in JDK version 1.1.8 and deployed in Oracle Internet Application Server 1.0.1 should function in the same manner when deployed in Oracle9i Application Server 1.0.2 with JDK version 1.2.2.

However, be aware that the use of any Java feature that was deprecated in version 1.2.2 might require code changes and recompilation. Become familiar with JDK version 1.2.2, and review all code written for JDK 1.1.8, if necessary.

Servlets

The Apache JServ version is unchanged between Oracle Internet Application Server release 1.0.1 and Oracle9i Application Server release 1.0.2. Servlets written to the JServ version 2.0 API and deployed in Oracle Internet Application Server 1.0.1 should function in the same manner when deployed in Oracle9i Application Server 1.0.2.

mod_ssl

Copy all certificate, request, key, crl, and prm files to the new locations shown in "Changing httpd.conf for mod_ssl migration" and restart Oracle9i Application Server.

mod_perl

Modify the Perl path (typically, the first line of the Perl script) to reflect the location of the Oracle9i Application Server version 1.0.2 installation.

If any new third-party modules have been added to Perl, they need to be added to the Oracle9i Application Server version 1.0.2 installation.

Tools

No tools migration tasks are necessary for HTTP Server, JDK, servlets, or mod_ssl.