6
OracleJSP Migration

OracleJSP and Apache JServ are application platforms. They allow developers to customize the configuration to suit their applications. Unlike some tools included with Oracle9i Application Server, migration of JSP and servlet applications can be more complicated. It requires working knowledge of JavaServer Pages, the servlet API, Apache Web Server configuration, HTTP, and the applications that are being migrated.

This chapter explains the process of migrating JSP applications from Oracle Internet Application Server release 1.0.1 to Oracle9i Application Server release 1.0.2.

The migration topics for this component are:

• Premigration

• Environment

• Configuration

• Application Logic

• Tools

Premigration

The following sections explain premigration steps. These instructions must be followed before beginning any migration work. Premigration consists of two steps:

• Verifying the New Installation

• Backing Up Configuration Files

Verifying the New Installation

Before you start any migration, you should first verify whether your new Oracle9i Application Server 1.0.2 installation is working correctly. To verify that OracleJSP 1.1 has been installed correctly, perform these steps:

1. Navigate to the default home page of your new installation. There you see a list of links for the different components.

2. Click the OracleJSP samples link to see a list of OracleJSP samples, and run the basic sample.

After verifying that OracleJSP has been installed correctly, you are ready to back up your configuration files.

Backing Up Configuration Files

Before making any changes to the configuration files, you should back up all the configuration files in NEW_HOME that you are going to change. Then, if you make a mistake during migration, you can restore the old configuration files and perform the migration steps again.

Typically, the following files are changed when you migrate your JSP and servlet applications after installing Oracle9i Application Server 1.0.2:

• 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\jsp\conf\ojsp.conf

Most of these configuration files of the old installation should be just under the directory with the same path under OLD_HOME. For example, jserv.conf should be in OLD_HOME\Apache\JServ\conf\jserv.conf, if the files have not been moved.

Note: The default location of ojsp.conf in OLD_HOME is slightly different. It is in the OLD_HOME\Apache\ojsp\conf\ directory.

Environment

No environment migration tasks are necessary.

Configuration

Anyone performing the OracleJSP 1.1 migration should have working knowledge of the applications and the JSP/servlet environment. First, you must identify what environment settings are made by the Oracle9i Application Server 1.0.2 installation and what environment settings are used for your applications.

JSP Environment

The environment settings typically used include (but are not limited to) those listed in Table 6-1:

Table 6-1 Environment Variables and Settings for OracleJSP 1.1

Variable	Setting
PATH	Specified by wrapper.env in jserv.properties.
CLASSPATH	Specified by wrapper.classpath entries in jserv.properties.
LD_LIBRARY_PATH	Specified by wrapper.env entry in jserv. properties.
Any alias directories settings.	Specified in your httpd.conf.
Any web resource protection settings.	Specified in your httpd.conf.

Oracle9i Application Server 1.0.2 Installation Configuration Changes

After backing up the configuration files, we recommend that you compare the old with the new configuration files. Check the differences line-by-line to determine whether the difference is due to the new Oracle9i Application Server 1.0.2 installation or it is due to prior configuration customizations. If the difference in configuration settings is required for an application, then apply the changes to the new configuration.

Examples of changes in the new Oracle9i Application Server 1.0.2 installation include (but are not limited to):

• tools.jar has been added for javac compilation

• the version of servlet.jar has been changed from 2.1 to 2.2

• ojsputil.jar has been added for supporting JavaBeans and custom tag libraries

• the version of zip files for SQLJ and JDBC drivers has been changed from 8.1.6 to 8.1.7 and from JDK 1.1 to JDK 1.2, respectively

Keep these changes in your new configuration because they provide faster performance and a richer set of functionality for your JSP applications.

General Guideline

Follow these steps as a general guideline for applying changes to the new configuration files:

1. Add changes in small batches. If you make a small number of changes and check your work before making further changes, then it is easier to locate errors.

2. Restart your Oracle9i Application Server machine after you have made a batch of changes.

3. Verify whether your changes work in the new installation by checking that you can run the OracleJSP samples.

4. If everything works correctly after you apply a batch of changes, then continue to apply your next batch of changes.

   Note: In most cases, you do not need to remove or comment out any lines in the new configuration files. If you need to, then remove configuration lines after you have made your additions and have verified the new configuration.

5. After you have applied all the necessary changes, copy your JSP files and class files to the right locations. Then you can test whether your application runs on the new server.

   See Also: Oracle JavaServer Pages Developer's Guide and Reference and Apache JServ documentation in the Oracle9i Application Server Documentation Library

Application Logic

No application logic migration tasks are necessary.

Tools

No tools migration tasks are necessary.