8
Oracle Form Services Migration

This chapter explains the process of migrating from Oracle Form Services version 6.0.8.8 to 6.0.8.11 in Oracle9i Application Server.

Contents

• Pre-migration

• Environment

• Configuration

• Application Logic

• Tools

Pre-migration

The following sections explain pre-migration steps. These instructions must be followed before beginning any migration work.

Shutting Down Oracle Form Services

Before installing Oracle9i Application Server, Release 1.0.2, shut down any Oracle Form Services running in the OLD_HOME. If you are using the default Oracle Internet Application Server configuration, this can be done by running the following command:

prompt> <OLD_HOME>/6iserver/forms60server stop 

If you have started any Oracle Form Services manually or are using Enterprise Manager, you should shut them down using the above mentioned command.

Backing Up Configuration Files

Make backup copies of the following files and directories before doing any migration tasks:

• <NEW_HOME>/6iserver/conf/6iserver.conf

• <NEW_HOME>/6iserver/forms60/server/formsweb.cfg

• <NEW_HOME>/6iserver/forms60/server/base.htm

• <NEW_HOME>/6iserver/forms60/server/basejini.htm

• <NEW_HOME>/6iserver/forms60.csh

• <NEW_HOME>/6iserver/forms60.sh

• <NEW_HOME>/6iserver/forms60server

Environment

The forms60server script is provided to properly setup the environment necessary to start and stop Oracle Form Services. If you have modified this script in OLD_HOME/6iserver, then you should make the same changes to the new version of the script in NEW_HOME/6iserver.

There are two additional scripts provided to enable the Forms executables to run from the command line in a shell executable:

• forms60.csh for the C Shell

• forms60.sh for the default UNIX shell, sh

Again, if you have made changes to these scripts in OLD_HOME/6iserver, then the same changes should be made to these scripts in NEW_HOME/6iserver.

Configuration

The following sections explain changes you must make to your configuration files for Oracle Form Services to continue to work as it did with Oracle Internet Application Server, Release 1.0.0.

You will need to make changes to the configuration files in Table 8-1.

Table 8-1 Configuration Files Used by Oracle Form Services

Configuration File	Description
NEW_HOME/6iserver/conf/6iserver.conf	Contains information for web server configuration.
NEW_HOME/6iserver/forms60/server/formsweb.cfg	Contains information for Oracle Form Services configuration.
NEW_HOME/6iserver/forms60/server/base*.htm	Contains the first HTML files read by Oracle Form Services when a user starts a Forms application.

6iserver.conf

Many of the paths in the old 6iserver.conf file reference the old Oracle home, so do not copy the old 6iserver.conf file from OLD_HOME to NEW_HOME. You should instead apply any changes made in the old file to the new version.

formsweb.cfg

You can safely replace this configuration file with your old file. If you choose to make this replacement, you should also manually add lines from the new file to your existing configuration file as follows:

1. Copy the lines beginning with archive_ie= and archive_jini= from formsweb.cfg in NEW_HOME.

2. Add the lines to the new version of the file.

base*.htm

You can safely replace the base HTML files in NEW_HOME with your old base HTML files. Simply copy any base HTML files you have to NEW_HOME.

Application Logic

You will need to manually copy any Forms applications deployed using Oracle Internet Application Server, Release 1.0.0 in OLD_HOME to NEW_HOME. This process will vary from application to application. Approach this requirement as if you are deploying your application to a completely new installation. If you are migrating from Oracle Internet Application Server, Release 1.0.0, then you are not required to re-generate any portion of your Forms applications with this release.

Tools

No tools migration tasks are necessary.