Oracle9i Application Server Migration Guide Release 1 (v1.0.2.2) for Windows NT/2000 Part Number A90222-01 |
|
Release 1 (v1.0.2.2) for Windows NT/2000
May 2001
Part No. A90222-01
This guide describes the process of migrating from earlier releases of Oracle9i Application Server to the current version. The document has the following sections:
If you are migrating from a previous version of Oracle9i Application Server, note that Oracle only supports the following options:
This document uses the following terms:
You must perform the following tasks before installing Oracle9i Application Server Release 1 (v1.0.2.2).
Before installing Oracle9i Application Server Release 1 (v1.0.2.2), review the Release Notes and latest Release Notes Addendum. You can find the latest Release Notes Addendum on the Oracle Technology Network (OTN) at
http://otn.oracle.com/docs/products/ias/content.html
Using the Windows Task Manger, verify that the dis4pr.exe
process is not running. If it is running, you must terminate it before resuming the migration process.
Make backup copies of the following files and directories before installing Oracle9i Application Server.
ORACLE_HOME\
panama
directory.
ORACLE_HOME
\ifs1.1\settings
directory and changed Oracle Internet File System configuration files stored in other directories.
OLD_806HOME
\net80\admin\tnsnames.ora
ORACLE_HOME
\Apache\Apache\htdocs\discwb4\disco4iv\html
directory.
OLD_806HOME
\discwb4\util\pref.txt
Section 5.0, "Manually Migrating Components" explains the tasks you must perform using these files after installing Oracle9i Application Server.
Install Oracle9i Application Server 1.0.2.2 into the same Oracle home as the 1.0.2.1 installation. You must follow all of the preinstallation and postinstallation tasks from the Oracle9i Application Server Installation Guide before completing the migration tasks in Section 5.0, "Manually Migrating Components" of this guide.
At the File Locations screen in the installer, you must enter the same value that was used in your Oracle9i Application Server 1.0.2.1 installation. The easiest way to find this value is to select it from the drop-down list.
Some components require additional postinstallation tasks you must perform to successfully complete the migration from Oracle9i Application Server, Release 1.0.2.1. This section describes the postinstallation tasks for the following components:
Installing Oracle9i Application Server 1.0.2.2 automatically migrates some components. There are no additional migration steps for the following components:
Some Oracle9i Application Server files contain configuration data for more than one component. To simplify migration, this section describes the migration tasks for each of these configuration files.
After installing Oracle9i Application Server 1.0.2.2, you must remove duplicate lines from jserv.properties
. The path to this file is ORACLE_HOME
\Apache\Jserv\conf\jserv.properties
.
Edit jserv.properties
so that it contains only one occurrence of the following lines:
wrapper.classpath=ORACLE_HOME\portal30\bibeans\jewt-opt-4_0_15.zip wrapper.classpath=ORACLE_HOME\portal30\bibeans\share-opt-1_1_4.zip wrapper.classpath=ORACLE_HOME\portal30\bibeans\utility.jar wrapper.classpath=ORACLE_HOME\portal30\bibeans\utilitygui.jar wrapper.classpath=ORACLE_HOME\portal30\bibeans\utilitypersist.jar wrapper.classpath=ORACLE_HOME\portal30\bibeans\utilityxml.jar wrapper.classpath=ORACLE_HOME\portal30\bibeans\swingall.jar wrapper.classpath=ORACLE_HOME\portal30\bibeans\graph.jar wrapper.classpath=ORACLE_HOME\portal30\bibeans\graphgui.jar wrapper.classpath=ORACLE_HOME\portal30\bibeans\LW_PfjBean.jar wrapper.classpath=ORACLE_HOME\portal30\bibeans\bivisbeans.jar wrapper.classpath=ORACLE_HOME\lib\http_client.jar wrapper.classpath=ORACLE_HOME\jlib\javax-ssl-1_2.jar wrapper.classpath=ORACLE_HOME\jlib\jssl-1_2.jar wrapper.env=WV_GATEWAY_CFG=ORACLE_HOME\Apache\modplsql\cfg\wdbsvr.app wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\ordim817.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\ordvir817.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\ordhttp.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\jndi.jar wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\jbomt.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\javax_ejb.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\jdev-rt.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\jbohtml.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\jboremote.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\connectionmanager.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\jbodomorcl.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\jboimdomains.zip wrapper.classpath=ORACLE_HOME\Apache\BC4J\lib\jboorasql.zip wrapper.classpath=ORACLE_HOME\Apache\Apache\htdocs\onlineorders_html
After installing Oracle9i Application Server 1.0.2.2, you must remove obsolete and duplicate lines from zone.properties
. The path to this file is ORACLE_HOME
\Apache\Jserv\servlets\zone.properties
.
Remove the following line from zone.properties
:
repositories=ORACLE_HOME\Apache\Jserv\servlets\Parallel.jar
Edit zone.properties
so that it contains only one occurrence of the following line:
servlet.page.code=oracle.webdb.page.ParallelServlet
Section 3.3, "Backing up Configuration and Data Files" instructed you to create a backup copy of the following file:
You must restore the backup copy of this file to its original location, overwriting the file that is currently there.
To enable Oracle9iAS Database Cache to work with the Oracle Intelligent Agent, the following line must exist in ORACLE_HOME
\odg\svppcart.dat
:
WTPC ALL vpxwtpc vpxwtpc
If this line does not exist in svppcart.dat
, then you must add it.
The following sections describe tasks you must perform to successfully migrate Oracle9iAS Discoverer.
Many configuration files control the appearance and behavior of Oracle9iAS Discoverer. You might have modified these files to customize Discoverer to meet your own requirements. Installing Oracle9i Application Server 1.0.2.2 replaces existing versions of these configuration files with new versions of the same files. If you have modified the configuration files, then you must edit the new files and reapply your changes using the backup files from Section 3.3, "Backing up Configuration and Data Files".
ORACLE_HOME
\Apache\Apache\htdocs\discwb4\disco4iv\html
directory, perform the following tasks:
OLD_806HOME
\discwb4\util\pref.txt
, perform the following tasks:
After installing Oracle9i Application Server 1.0.2.2 you must confirm that Oracle9iAS Discoverer Viewer uses the correct listener configuration.
ORACLE_HOME
\Apache\Apache\setupinfo.txt
to determine the Non SSL Mode port number.
This number will be the value following hostname:
. For example, the following information indicates that the port number is 7778:
Non SSL Mode (executed at install time): http://hostname:7778
ORACLE_HOME
\Apache\Jserv\servlets\disco4iviewer.properties
and make the following changes:
servlets.startup
directive that launches the viewer
servlet. Confirm that the servlet name is viewer
with a lowercase "v
". If the directive starts the Viewer
servlet, then change the directive so that viewer
starts with a lowercase "v
". The correct directive is:
servlets.startup=viewer
Viewer
servlet:
servlet.Viewer.code=oracle.discoiv.Disco4iv servlet.Viewer.initArgs=config=http://hostname:port/disco4iv/html/disco4iv.xml
setupinfo.txt
.
servlet.viewer.initArgs=config=http://hostname:port/disco4iv/html/disco4iv.xml
If the port values do not match, then change the port value in this file to the value from setupinfo.txt
.
All URL references to Discoverer4i/Viewer
are now invalid. You must manually change all references to discoverer4i/viewer
. This includes, but is not limited to, links within the Web site and client bookmarks.
The version of Oracle9iAS Discoverer that ships with Oracle9i Application Server 1.0.2.2 requires an End User Layer from Oracle Discoverer Administration Edition 4.1.36 or later. You must upgrade your End User Layer if either:
Oracle Discoverer Administration Edition is shipped as part of Oracle9i Developer Suite. Oracle9i Developer Suite 1.0.2.4 includes Oracle Discoverer Administration Edition 4.1.37.
See Also:
|
The following sections describe tasks you must perform to successfully migrate Oracle9iAS Forms Services.
Section 5.2, "Common Configuration Files" includes tasks for migrating configuration files for this component.
Review the latest Oracle9i Application Server Release Notes Addendum for additional migration tasks. You can find the latest Release Notes Addendum on OTN at
http://otn.oracle.com/docs/products/ias/content.html
The following sections describe tasks you must perform to successfully migrate Oracle9iAS Portal.
Section 5.2, "Common Configuration Files" includes tasks for migrating configuration files for this component.
Oracle9iAS Portal uses an upgrade script for migration. The script and further migration instructions are available at
http://otn.oracle.com/products/iportal
The following sections describe tasks you must perform to successfully migrate Oracle9iAS Reports Services.
Section 5.2, "Common Configuration Files" includes tasks for migrating configuration files for this component.
Review the latest Oracle9i Application Server Release Notes Addendum for additional migration tasks. You can find the latest Release Notes Addendum on OTN at
http://otn.oracle.com/docs/products/ias/content.html
See Section 1.2 in the Oracle9iAS Wireless Configuration Guide in the Oracle9i Application Server Documentation Library for manual configuration steps you must perform to successfully migrate this component.
Section 5.2, "Common Configuration Files" includes tasks for migrating configuration files for this component.
This release of Oracle HTTP Server offers a new infrastructure which provides better process management and high availability features for Oracle9i Application Server.
To use the new high available functionality, you must set the following directive in ORACLE_HOME
\Apache\Jserv\conf\jserv.conf
:
ApJServManual auto
If this directive was set to on
before installing Oracle9i Application Server 1.0.2.2, then the new installation will continue to work as the old one did. For instructions on configuring Oracle HTTP Server to take advantage of the new infrastructure, see Using mod_oprocmgr with mod_jserv in the Oracle9i Application Server Documentation Library.
If this directive was set to off
before installing Oracle9i Application Server 1.0.2.2, then the installer sets the directive to auto
and adds the following lines to jserv.conf
:
ApJServGroup group1 1 1 ORACLE_HOME\Apache\Jserv\conf\jserv.properties ApJServGroup group2 1 1 ORACLE_HOME\Apache\Jserv\conf\jservSoap.properties ApJServGroupMount /servlets balance://group1/root ApJServGroupMount /servlet balance://group1/root ApJServGroupMount /dms balance://group1/root ApJServGroupMount /soap/servlet balance://group2/soap ApJServGroupSecretKey DISABLED
These additions may not reflect your original configuration settings. They are a template to help configure your settings to the new infrastructure. The updated jserv.conf
file may require adding or changing some directives. You may also need to make changes to jserv.properties
which is in the same directory as jserv.conf
.
The following examples guide you through this process.
Example 1:This example shows the migration of a basic configuration.
Before installing Oracle9i Application Server 1.0.2.2, the configuration files for this example contain the following directives:
jserv.conf
ApJServManual off ApJServMount /servlets /root ApJServMount /dev ajpv12://localhost:8008/developers ApJServMount /prod ajpv12://localhost:8009/production ApJServSecretKey DISABLED
jserv.properties
port=8007
After installing Oracle9i Application Server 1.0.2.2 and editing the configuration files, the final files should contain the following directives:
jserv.conf
ApJServManual auto ApJServGroupMount /servlets balance://group1/root ApJServGroupMount /dev balance://group2/developers ApJServGroupMount /prod balance://group3/production ApJServGroupSecretKey DISABLED ApJServGroup group1 1 1 ORACLE_HOME\Apache\Jserv\conf\jserv.properties ApJServGroup group2 1 1 ORACLE_HOME\Apache\Jserv\conf\jserv1.properties ApJServGroup group3 1 1 ORACLE_HOME\Apache\Jserv\conf\jserv2.properties
jserv*.properties
jserv.properties: port=8007 jserv1.properties: port=8008 jserv2.properties: port=8009
For this example, jserv1.properties
and jserv2.properties
can be equivalent to the file that starts JServ processes manually.
Example 2:
This example shows the migration of a configuration with load balancing directives.
Before installing Oracle9i Application Server 1.0.2.2, the configuration files for this example contain the following directives:
jserv.conf
ApJServManual off ApJServMount /dev balance://set1/dev ApJServMount /servlets balance://set1/root ApJServBalance set1 JServ1 ApJServBalance set1 JServ2 ApJServHost JServ1 ajpv12://localhost:8008 ApJServHost JServ2 ajpv12://localhost:8009 ApJServRoute JS1 JServ1 ApJServRoute JS2 JServ2 ApJServSecretKey DISABLED ApJServShmFile logs/jserv_shm
jserv.properties
port=8007
After installing Oracle9i Application Server 1.0.2.2 and editing the configuration files, the final files should contain the following directives:
jserv.conf
ApJServManual auto ApJServGroupMount /servlets balance://set1/root ApJServGroupMount /dev balance://set1/developers ApJServGroupSecretKey DISABLED ApJServGroup set1 2 1 $ORACLE_HOME/Apache/Jserv/etc/jserv1.properties
jserv1.properties
port=8008,8009
The following steps describe tasks you must perform to successfully migrate Oracle Internet File System.
ORACLE_HOME
\ifs1.1\bin\ifsstop.bat
batch file.
ORACLE_HOME
\ifs1.1\bin\ifsstart
.bat batch file.
Oracle9i Application Server 1.0.2.1 introduced many new supplemental components. Since these components were manually installed after installing Oracle9i Application Server 1.0.2.1 and some supplemental components have not changed since the last release, no migration tasks are required.
The following table describes the migration tasks required for each supplemental component:
|
Copyright © 2001 Oracle Corporation. All Rights Reserved. |
|