Oracle® Application Server Upgrade and Compatibility Guide
10g Release 2 (10.1.2) for UNIX Part No. B14090-05 |
|
Previous |
Next |
This appendix provides details on the upgrade process for each component of the middle tier and the Infrastructure installations. The OracleAS Upgrade Assistant does the middle tier upgrade processing only; the Infrastructure upgrade processing is done by individual scripts for the components that require upgrades. This appendix has two major sections:
This section describes the processing actions of the OracleAS Upgrade Assistant for each component upgrade. The order in which the actions are presented is not necessarily the order in which they are actually performed. When the order is known, or significant, the processing sequence is presented as numbered steps. Depending on installation type (that is, the components included), not all of these processes are performed.
The Oracle Process Manager and Notification Server (OPMN) Upgrade Process
The Oracle Application Server Containers for J2EE (OC4J) Upgrade Process
The Oracle Application Server Web Services UDDI Registry Upgrade Process
The Oracle Application Server Forms Services Upgrade Process
The Oracle Application Server Reports Services Upgrade Process
The OracleAS Upgrade Assistant performs these steps when upgrading the Oracle Process Manager and Notification Server:
Converts the following file to the 10g Release 2 (10.1.2) format:
SOURCE_ORACLE_HOME/opmn/conf/opmn.xml
Merges the converted opmn.xml
file with the opmn.xml
file in the destination Oracle home.
During the merge, OracleAS Upgrade Assistant moves all custom nodes into opmn.xml
, except the node containing gid="dcm-daemon"
.
The following files are changed or copied in the OPMN upgrade process:
DESTINATION_ORACLE_HOME/opmn/conf/opmn.xml
Custom process binaries defined in opmn.xml
Notes: Port values of particular interest for OPMN are the notification server ports (local, remote, request) and OC4J ports (ajp, rmi, jms).The OPMN upgrade process does not upgrade any changes that were made to Oracle Application Server Containers for J2EE instances in See Section 4.6.4.4, "Completing the Upgrade of User-Created OC4J Instances". |
The OracleAS Upgrade Assistant performs these steps when upgrading instance configuration data:
Loads the following file from the source Oracle home:
SOURCE_ORACLE_HOME/config/asschema.xml
Compares the version of this file in the source Oracle home with the version in the destination Oracle home.
Writes any differences found in the source Oracle home file to the destination Oracle home file.
The Oracle Application Server Containers for J2EE (OC4J) upgrade process consists of these steps:
The OracleAS Upgrade Assistant creates a separate process, which connects to the source Oracle home.
The process uses its Distributed Configuration Management version to examine the instances selected for upgrade.
Distributed Configuration Management creates a list of the instances in the source Oracle home in which the applications are deployed. It ignores Oracle-specific OC4J instances, such as OC4J_Portal, defined in the following file:
SOURCE_ORACLE_HOME/j2ee/deploy.ini*
The instances are the OC4J upgrade candidates.
Distributed Configuration Management builds a list of EAR files for the applications listed.
The OracleAS Upgrade Assistant creates a backup of upgraded files, appending a preUpgrade suffix. If necessary, to create a unique file name, it appends an integer, for example, filename
.preUpgrade.1
.
The OracleAS Upgrade Assistant copies principals.xml
, data-sources.xml
, jazn-data.xml
, and jazn.xml
to the destination Oracle home.
Adds properties defined in the oc4j.properties
file to the opmn.xml
file, using the SMI API.
The OracleAS Upgrade Assistant rebuilds, and then redeploys the EAR files to the destination Oracle home. In this step, the OracleAS Upgrade Assistant searches for all orion-specific files in the application-deployments
directory of the applications. It also searches for application-specific configuration files, such as principals.xml
and jazn-data.xml
.
Distributed Configuration Management updates mod_oc4j.conf
with the mount points associated with each deployed application.
The following files are changed in the OC4J upgrade process:
DESTINATION_ORACLE_HOME/j2ee/<name of OC4J instance>/config/principals.xml DESTINATION_ORACLE_HOME/j2ee/<name_of_OC4J_instance>/config/data-sources.xml DESTINATION_ORACLE_HOME/j2ee/<name of OC4J instance>/config/jazn.xml DESTINATION_ORACLE_HOME/j2ee/<name of OC4J instance>/config/jazn-data.xml DESTINATION_ORACLE_HOME/Apache/Apache/conf/mod_oc4j.conf
In addition:
Properties from the oc4j.properties
files in the source Oracle home are added to the opmn.xml
file, which is stored in the following directory of the destination Oracle home:
DESTINATION_ORACLE_HOME/opmn/conf/opmn.xml
EAR files for applications discovered in OC4J
instances in the source Oracle home are also modified
Note: Manual procedures may be required to complete the Oracle Application Server Containers for J2EE upgrade. See Section 4.6.4, "Completing the Oracle Application Server Containers for J2EE (OC4J) Upgrade". |
The OracleAS Upgrade Assistant performs these steps when upgrading Oracle HTTP Server (OHS):
Copies the httpd.conf
file from the source Oracle home to the destination Oracle home, replacing the SOURCE_ORACLE_HOME
path with DESTINATION_ORACLE_HOME
, then applies 10g Release 2 (10.1.2) file changes, and customizations made since Release 2 (9.0.2), to the corresponding file in the destination Oracle home.
Searches the mod_oc4j.conf
file in SOURCE_ORACLE_HOME
for Oc4jMount
directives and copies the Oc4jMount
directives that contain the string ajp13://
, cluster://
or instance://
to the mod_oc4j.conf
file in DESTINATION_ORACLE_HOME
.
Copies the mod_osso.conf
file from the source Oracle home to the destination Oracle home, replacing the source Oracle home path with the destination Oracle home path. The osso.conf
file referenced by the OssoConfigFile directive will be copied and converted into 10g Release 2 (10.1.2) obfuscated files.
Copies the moddav.conf
file from the source Oracle home to the destination Oracle home, replacing the source Oracle home path with the destination Oracle home path.
Searches Include
directives in the httpd.conf
file recursively to locate user-defined configuration files; copies these files from the source Oracle home to the destination Oracle home
. If the files were found in the source Oracle home, the OracleAS Upgrade Assistant replaces the source Oracle home path with the destination Oracle home path. If the files were found outside of the source Oracle home
, the OracleAS Upgrade Assistant saves a copy of the original file with a .preUpgrade
extension in the destination Oracle home,
then replaces the source Oracle home file with the new file.
Searches the LoadModule
directives recursively to find related module dynamic libraries; copies the libraries from the source Oracle home to the destination Oracle home.
Searches the SSLWallet
directives recursively to find Oracle wallets; copies the wallets from the source Oracle home to the destination Oracle home.
Locates CGI and fastcgi scripts by searching all configuration files for directories and files named in ScriptAlias
or ScriptAliasMatch
directives, and the ExecCGI
option in Options
directives (defined in Directory
or File
containers). Copies the directories and files from the source Oracle home to the destination Oracle home.
Copies static document directories found in the (non-default) location specified by the DocumentRoot
directive from the source Oracle home to the destination Oracle home. If the DocumentRoot
directive is the default, static documents are not upgraded.
Notes: Web sites are often configured with Web Cache as the first listener; in these cases, the Oracle HTTP Server's Listen port may need to be synchronized with equivalent Web Cache port values after upgrade. The settings are shown in Table 4-6, "Oracle HTTP Server and Oracle Application Server Web Cache Port Settings".The OracleAS Upgrade Assistant does not upgrade the Static files referenced by the |
The following files are changed or copied in the OHS upgrade process:
DESTINATION_ORACLE_HOME/Apache/Apache/conf/httpd.conf DESTINATION_ORACLE_HOME/Apache/Apache/conf/mod_oc4j.conf DESTINATION_ORACLE_HOME/Apache/Apache/conf/mod_osso.conf DESTINATION_ORACLE_HOME/Apache/Apache/oradav/conf/moddav.conf DESTINATION_ORACLE_HOME/Apache/Apache/conf/osso/osso.conf
In addition, the following files are changed in the following ways:
User-defined configuration files named in Include
directives (found in recursive search of all configuration files starting with httpd.conf
)
Oracle wallets named in SSLWallet
directives in all configuration files
CGI and fastcgi programs named in ScriptAlias
, ScriptAliasMatch
or Options
(ExecCGI)
directives in all configuration files
Static documents and directories
Note: Manual procedures may be required to complete the Oracle HTTP Server upgrade. See Section 4.6.3, "Completing the Oracle HTTP Server Upgrade". |
The OracleAS Upgrade Assistant performs these steps when upgrading Oracle Application Server Web Cache:
Locates webcache.xml
and internal.xml
in the source Oracle home.
Moves configuration data from the webcache.xml in the source Oracle home to the webcache.xml file in the destination Oracle home. The webcache.xml file is located in the following directory of the Oracle home:
ORACLE_HOME/webcache/webcache.xml
Copies error pages and wallet files from the source Oracle home to the destination Oracle home.
Note: If you customized the directory location of the event log (specified byACCESSLOG LOGDIR property in the webcache.xml file) in Oracle9iAS Release 2 (9.0.2), be aware that this customization will not be upgraded.
|
The following files and directories are involved in the Oracle Application Server Web Cache upgrade process:
DESTINATION_ORACLE_HOME/webcache/webcache.xml DESTINATION_ORACLE_HOME/webcache/docs\ DESTINATION_ORACLE_HOME/webcache/wallets\
The OracleAS Upgrade Assistant upgrades wallets by copying them from the source Oracle home to the destination Oracle home. Wallets outside of the source Oracle home need not be copied.
Oracle Application Server Web Cache can have multiple listening ports, and each port can have a different wallet. When connecting to the origin server, it can use another wallet (OSWALLET
in the example below).
Example A-1 Oracle Application Server Web Cache Wallet Configuration after Upgrade
<LISTEN IPADDR="ANY" PORT="4445" PORTTYPE="NORM" SSLENABLED="SSLV3_V2H"> <WALLET>DESTINATION_ORACLE_HOME/webcache/wallets/subdir1</WALLET> </LISTEN> <LISTEN IPADDR="ANY" PORT="4447" PORTTYPE="NORM" SSLENABLED="SSLV3_V2H"> <WALLET>/some/other/path/wallets/default</WALLET> </LISTEN> ...... ...... <OSWALLET>DESTINATION_ORACLE_HOME/webcache/wallets/default</OSWALLET>
In this example, Oracle Application Server Web Cache is using three wallets. The first and third are in the source Oracle home. The first wallet will be copied to the following directory:
DESTINATION_ORACLE_HOME/webcache/wallets/subdir1
The third wallet will be copied to this directory:
DESTINATION_ORACLE_HOME/webcache/wallets/default
The second wallet will not be copied, since it does not reside in the Oracle home. After upgrade, the wallet in webcache.xml
will be pointing to the original directory.
Note: Web sites are often configured with Web Cache as the first listener; in these cases, the Oracle HTTP Server's Listen port may need to be synchronized with equivalent Web Cache port values after upgrade. See Section 4.6.3, "Completing the Oracle HTTP Server Upgrade". |
The OracleAS Upgrade Assistant performs these steps when upgrading mod_plsql:
Locates dads.conf, cache.conf, plsql.conf and oradav.conf in the source Oracle home.
Copies all the above configuration files from the source Oracle home to the destination Oracle home.
Parses cache.conf and plsql.conf in destination Oracle home and replaces all the occurrences of SOURCE_ORACLE_HOME with DESTINATION_ORACLE_HOME.
The following files are modified in the mod_plsql upgrade process:
DESTINATION_ORACLE_HOME/Apache/modplsql/conf/dads.conf DESTINATION_ORACLE_HOME/Apache/modplsql/conf/cache.conf DESTINATION_ORACLE_HOME/Apache/modplsql/conf/plsql.conf DESTINATION_ORACLE_HOME/Apache/oradav/conf/oradav.conf
The OracleAS Upgrade Assistant performs these steps when upgrading Oracle Enterprise Manager 10g:
Examines the following file in the following directory for port entries related to the targets in the file:
SOURCE_ORACLE_HOME/sysman/emd/targets.xml
Replaces the corresponding port entries in the targets.xml
file in the destination Oracle home.
The Oracle Universal Installer and the OracleAS Upgrade Assistant perform these steps during installation of the Portal and Wireless installation type:
The OracleAS Upgrade Assistant extracts the uddiserver.config
file from the following directory of the source Oracle home for later use:
SOURCE_ORACLE_HOME/ds/uddi/config
The OracleAS Upgrade Assistant extracts properties from the uddiserver.config
file and applies them to the uddiserver.config
file in the destination Oracle home.
The following file is changed in the Oracle Application Server Web Services Registry upgrade process:
SOURCE_ORACLE_HOME/ds/uddi/config/uddiserver.config
The OracleAS Upgrade Assistant performs these steps when upgrading Oracle Ultra Search:
Discover the data-sources.xml
file in the source Oracle home.
Copy the data-sources.xml
file from the SOURCE_ORACLE_HOME to DESTINATION_ORACLE_HOME.
The OracleAS Upgrade Assistant performs these steps when upgrading the OracleAS Portal middle tier:
Parses the dads.conf
file in the source Oracle home and creates configuration entries for each portal in the Portal dependency file (iasconfig.xml
).
Enables monitoring of a OracleAS Portal Release 2 (9.0.2) with the 10g Release 2 (10.1.2) Application Server Control Console.
Upgrades PPE settings in destination web.xml
.
Copies data-sources.xml
from the source Oracle home to the destination Oracle home.
Upgrades user specific applications deployed in source OC4J_Portal instance to destination OC4J_Portal instance. This includes Portal Development Kit Services for Java (JPDK) applications commonly deployed in that instance.
Upgrades the JPDK web providers. This includes migrating:
Extra user-created web providers created in the JPDK application under the OC4J_Portal instance.
Provider Groups, Providers, and URL Portlets that have been built using the OracleAS Portal user interface.
Configuration changes, customizations, or extensions that have been made to web provider applications in the OC4J_Portal instance.
Upgrades customizations made to the Omni Portlet and Web Clipping providers. The upgrade process automatically migrates current configurations and portlet customizations to the new installation. The upgrade process also updates the Web Clipping repository schema if upgraded from 9.0.2.4.0. The following are migrated to the new installation:
Proxy settings
Repository settings
Preference Store settings
Locale personalization level setting
Trusted certificate location setting
Portlet customizations
Retrieves Oracle Enterprise Manager target data from the source Oracle home. Applies these details to the destination Oracle home.
Updates the Monitoring Services Link on the OracleAS Portal Administer Tab for all the portals being monitored by the middle tier
The following files are changed in the OracleAS Portal upgrade process.
DESTINATION_ORACLE_HOME/portal/conf/iasconfig.xml
DESTINATION_ORACLE_HOME/portal/conf/cache.xml
DESTINATION_ORACLE_HOME/portal/pdkjava/providerGroups/iasProviders.xml
DESTINATION_ORACLE_HOME/sysman/emd/targets.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/config/data-sources.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/portal/portal/WEB-INF/web.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/portalTools/omniPortlet/WEB-INF/providers/omniPortlet/provider.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/portalTools/omniPortlet/WEB-INF/providers/omniPortlet/vaultIdMappings.properties
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/portalTools/webClipping/WEB-INF/providers/webClipping/provider.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/portalTools/providerBuilder/WEB-INF/deployment_providerui/progrp.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/portalTools/providerBuilder/WEB-INF/deployment_providerui/provideruiacls.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/jpdk/jpdk/WEB-INF/providers/PORTLETBLDGTOOLS/provider.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/jpdk/jpdk/WEB-INF/deployment_providerui/progrp.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/jpdk/jpdk/WEB-INF/deployment_providerui/provideruiacls.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/application-deployments/jpdk/jpdk/orion-web.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/jpdk/jpdk/WEB-INF/providers/
seeded_provider
/providers.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/portalTools/providerBuilder/WEB-INF/providers.xml
All subdirectories created under the following directory in the source middle-tier Oracle home are copied to the destination midtier Oracle home:
j2ee/OC4j_PORTAL/applications/portalTools/omniPortlet/ WEB-INF/providers/omniPortlet
In addition, all files and directories created under the following directories in the source Oracle home that are not part of the installation process are copied to the destination Oracle home:
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/jpdk
DESTINATION_ORACLE_HOME/j2ee/OC4J_Portal/applications/portalTools/providerBuilder
The Oracle Application Server Wireless upgrade process consists of the steps below.
If you are upgrading a Release 2 (9.0.2) instance of Oracle Application Server that is using a Release 2 (9.0.2) OracleAS Metadata Repository, the OracleAS Wireless Configuration Assistant upgrades the OracleAS Wireless schema to 10g (9.0.4) in the OracleAS Metadata Repository during installation of the first OracleAS Wireless middle tier.
You can then use the Metadata Repository Upgrade Assistant (MRUA) to upgrade the OracleAS Wireless 10g (9.0.4) schema to 10g Release 2 (10.1.2) as described in Chapter 7.
The OracleAS Upgrade Assistant copies runtime customization classes such as listener hooks and customized folder renderers from the source Oracle home to the destination Oracle home.
See Section A.1.11.1, "Oracle Application Server Wireless Upgrade Items (List A)".
The OracleAS Upgrade Assistant copies the process configuration information for the OracleAS Wireless standalone processes from the Oracle Application Server Wireless source middle tier to the OracleAS Wireless 10g Release 2 (10.1.2) middle tier, and configures the 10g Release 2 (10.1.2) middle tier accordingly.
See Section A.1.11.2, "Oracle Application Server Wireless Upgrade Items (List B)".
The configuration information for the OracleAS Wireless Java processes is stored in the OracleAS Wireless schema in the OracleAS Metadata Repository. During the upgrade to 10g Release 2 (10.1.2), the OracleAS Upgrade Assistant copies the process configuration information from the source middle tier to the 10g Release 2 (10.1.2) middle tier by creating additional entries in the OracleAS Wireless schema.
Because these processes are managed by Oracle Process Manager and Notification Server (OPMN) in 10g Release 2 (10.1.2), the OPMN configuration for the OracleAS Wireless middle tier is also upgraded.
The following files are changed in the first phase of the Oracle Application Server Wireless upgrade process:
DESTINATION_ORACLE_HOME/wireless/server/classes/*.class DESTINATION_ORACLE_HOME/wireless/server/classes/*.properties
In addition, if you are upgrading from 10g (9.0.4), the following additional file is also changed during the upgrade:
DESTINATION_ORACLE_HOME/wireless/config/iaswcfg.xml
The OracleAS Upgrade Assistant performs these steps when upgrading Oracle Business Intelligence Discoverer:
Merges the changes made to the Pref.txt
and .reg_key.dc
files in the Release 2 (9.0.2) instance to the equivalent files in the 10g Release 2 (10.1.2) instance.
Merges the changes made to the *.xml
files in the Release 2 (9.0.2) instance to the equivalent files in the 10g Release 2 (10.1.2) instance.
Creates a backup copy of each configuration file, named as follows:
file_name_upgrade_backup.file_suffix
The following files are changed in the Oracle Business Intelligence Discoverer upgrade process:
DESTINATION_ORACLE_HOME/util/Pref.txt
DESTINATION_ORACLE_HOME/discoverer/.reg_key.dc
DESTINATION_ORACLE_HOME/j2ee/OC4J_BI_Forms/applications/discoverer/web/WEB-INF/configuration.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_BI_Forms/applications/discoverer/web/common/xsl/ui_config.xml
DESTINATION_ORACLE_HOME/j2ee/OC4J_BI_Forms/applications/discoverer/web/plus_files/xsl/plus_config.xml
Note: The OracleAS Upgrade Assistant does not upgrade*.xsl (style sheet) files. If any of these are customized in the Release 2 (9.0.2) installation, and you want these customizations in the 10g Release 2 (10.1.2) installation, you must re-apply the customizations manually.
|
The OracleAS Upgrade Assistant performs the following tasks during the upgrade of OracleAS Forms Services:
Extracts the user-defined configuration from the user deployment of the OracleAS Forms Services EAR file (described in Section A.1.13.1, "OracleAS Forms Services Upgrade Items (List A)"), generates a new EAR file based on this configuration from the source Oracle home and the OracleAS Forms Services servlet contents from the destination Oracle home. The OracleAS Upgrade Assistant then deploys the newly generated EAR file to the destination Oracle home.
Extracts the user information from the files described in Section A.1.13.2, "OracleAS Forms Services Upgrade Items (List B)" from the source Oracle home, makes a backup of the files in the destination Oracle home (with a .preUpgrade
suffix), and then merges the extracted user information into items in the destination Oracle home.
Copies the files described in Section A.1.13.3, "OracleAS Forms Services Upgrade Items (List C)" from the source Oracle home to the destination Oracle home with a suffix that identifies them as orginating in the source Oracle home.
Makes a backup of the files described in Section A.1.13.4, "OracleAS Forms Services Upgrade Items (List D)" in the destination Oracle home (with a .preUpgrade
suffix), copies the files from the source Oracle home to the destination Oracle home, and then modifies the path in the files to point to the destination Oracle home.
The following sections describe the OracleAS Forms Services items that are upgraded by the Oracle Application Server Upgrade Assistant:
Section A.1.13.1, "OracleAS Forms Services Upgrade Items (List A)"
Section A.1.13.2, "OracleAS Forms Services Upgrade Items (List B)"
Section A.1.13.3, "OracleAS Forms Services Upgrade Items (List C)"
Section A.1.13.4, "OracleAS Forms Services Upgrade Items (List D)"
Section A.1.13.5, "Parameters in the formsweb.cfg Files That Are Not Upgraded"
User deployments of the OracleAS Forms Services EAR file (forms90app.ear
) in the OC4J_BI_Forms
OC4J instance in the source Oracle home.
SOURCE_ORACLE_HOME/j2ee/OC4J_BI_Forms/applications/forms90app/forms90web/WEB-INF/web.xml
SOURCE_ORACLE_HOME/j2ee/OC4J_BI_Forms/applications/
USER_APP_NAME
/forms90web/WEB-INF/web.xml
In this path name, USER_APP_NAME refers to the customized name used to redeploy the OracleAS Forms Services EAR file (forms90app.ear
) in the user configuration.
SOURCE_ORACLE_HOME/j2ee/properties/oc4j_bi_forms.properties
Upgrades the OracleAS Forms Services deployment entries.
SOURCE_ORACLE_HOME/j2ee/OC4J_BI_Forms/config/oc4j.properties
Upgrades the OracleAS Forms Services deployment entries.
SOURCE_ORACLE_HOME/forms90/server/formsweb.cfg
SOURCE_ORACLE_HOME/forms90/server/default.env
SOURCE_ORACLE_HOME/forms90/server/forms90.conf
SOURCE_ORACLE_HOME/tools/jvm/jvmconrollers.cfg
SOURCE_ORACLE_HOME/bin/g90runm.sh
User-defined Oracle Application Server Forms Services configuration file replacements and additions for formsweb.cfg
, forms90.conf
and default.env
.
SOURCE_ORACLE_HOME/forms90/search_replace.properties
SOURCE_ORACLE_HOME/forms90/converter.properties
SOURCE_ORACLE_HOME/forms90/ftrace.cfg
SOURCE_ORACLE_HOME/forms90/java/oracle/forms/registry/Registry.dat
User-defined OracleAS Forms Services template htm
files used by the Forms Servlet to render the Forms client html page.
When you upgrade OracleAS Forms Services, the OracleAS Upgrade Assistant upgrades the contents of the formsweb.cfg
file, but it does not upgrade the following entries in the file:
jinit_download_page jinit_classid jinit_exename jinit_mimetypejpi_download_page jpi_classid jpi_codebase jpi_mimetype
The names of many OracleAS Forms Services files, environment variables, paths, and directories have changed in OracleAS Forms Services 10g Release 2 (10.1.2.0.2).
Table A-1 the name changes. The OracleAS Upgrade Assistant takes care of replacing the older names with new names in the user-defined configurations during the upgrade.
Table A-1 OracleAS Forms Services File Name, Directory Name, URL, and Variable Name Changes in 10g Release 2 (10.1.2.0.2)
Release 2 (9.0.2) and 10g (9.0.4) Name | 10g Release 2 (10.1.2.0.2) Name | Description |
---|---|---|
http://host.port/forms90 |
http://host.port/forms |
Default URL for accessing OracleAS Forms Services |
ORACLE_HOME/forms90 |
ORACLE_HOME/forms |
Default directory for OracleAS Forms Services configuration files |
|
|
OracleAS Forms Services EAR file |
|
|
OracleAS Forms Services Oracle HTTP Server configuration file |
|
|
OracleAS Forms Services client jar file |
|
|
OracleAS Forms Services client jar file |
|
|
OracleAS Forms Services client jar file |
|
|
OracleAS Forms Services client jar file |
|
|
OracleAS Forms Services client jar file |
|
|
OracleAS Forms Services client jar file |
|
|
OracleAS Forms Services servlet jar file |
|
|
Listener servlet alias |
|
|
OracleAS Forms Services default alias |
|
|
Graphics integration script. |
The OracleAS Upgrade Assistant performs these steps when upgrading Oracle Application Server Reports Services:
Copies all configuration files except jdbcpds.conf
from the source Oracle home to the destination Oracle home.
Copies all resource files from the source Oracle home to the destination Oracle home.
Copies DESTINATION_ORACLE_HOME/bin/reports.sh
to the destination Oracle home, and adds the NLS_LANG
environment variable, if it is not in the script.
Copies reports server persistent files from the source Oracle home to the destination Oracle home.
The following files are changed in the Oracle Application Server Reports Services upgrade process:
DESTINATION_ORACLE_HOME/reports/conf/*.conf
(except jdbcpds.conf
)
DESTINATION_ORACLE_HOME/reports/conf/*.xml
DESTINATION_ORACLE_HOME/reports/plugins/resource/*.*
DESTINATION_ORACLE_HOME/reports/conf/cgicmd.dat
DESTINATION_ORACLE_HOME/reports/server/*.dat
DESTINATION_ORACLE_HOME/bin/reports.sh
DESTINATION_ORACLE_HOME/reports/conf/rwservlet.properties
This section describes the upgrade processing of the Infrastructure. Infrastructure components and functionality are described in Chapter 7, "Upgrading the OracleAS Metadata Repository" and Chapter 5, "Upgrading Identity Management Services".
It contains the following subsections:
The Oracle Application Server Certificate Authority Upgrade Process
The Oracle Application Server Web Services UDDI Registry Schema Upgrade Process
The Oracle Application Server Wireless Schema Upgrade Process
The Identity Management components Oracle Application Server Single Sign-On and Oracle Internet Directory are upgraded by the Oracle Universal Installer. There are two possible configurations upgraded: distributed, in which Oracle Application Server Single Sign-On and Oracle Internet Directory reside on different computers, each with its own metadata repository, and non-distributed, in which they share a metadata repository on one computer.
The upgrade processing is interactive, and performed by the Oracle Universal Installer in each scenario. The Oracle Universal Installer is aware of the configuration being upgraded, and prompts for the necessary information and launches the appropriate configuration tools.
The source and destination configurations are depicted in:
The Metadata Repository Container schema upgrade is performed by the Metadata Repository Upgrade Assistant (MRUA). This part of the Metadata Repository Upgrade Assistant procedure adds support for new schemas in the metadata repository, and updates the Oracle Internet Directory entry. The script performs one or both functions, depending on the credentials supplied when it is executed.
During the Metadata Repository Container schema phase of the upgrade, MRUA performs these steps:
Checks to determine whether the Oracle home is a Release 2 (9.0.2) or 10g (9.0.4) Infrastructure; if it is not, the process reports an error and exits.
Connects to the metadata repository database; if unable to connect, the process exits.
Checks to determine whether the database version is a supported version; if not, the process reports an error and exits.
Creates these schemas: wcrsys
, oca
, oraoca_public
, ip
, wk_test
and internet_appserver_registry
(with the same password as the user name and corresponding tablespace) and these tablespaces: ias_meta
, wcrsys_ts
, ocats
, ip_dt
, ip_rt
, ip_idx
, ip_lob
OLTS_SVRMGSTORE
, oltsbattrstore
. If the creation of any tablespace or user fails, the process reports an error and continues.
Writes message to standard output "Creation of new schemas successful" if all schemas were created successfully.
The Metadata Repository Container Oracle Internet Directory entry upgrade process performs these steps:
Checks to determine whether the ORACLE_HOME
environment variable is set; if not, the process reports an error and exits.
Checks to determine whether the Oracle home is a Release 2 (9.0.2) or 10g (9.0.4) Infrastructure; if it is not, the process reports an error and exits.
Connects to the metadata repository database using the following user names and passwords: oca/oca
, oraoca_public
, and wcrsys/wcrsys
. (These should have been created by the first phase of the schema creation process performed by MRUA, which preceded the Oracle Internet Directory entry update.) If unable to connect to all of these users, the process reports an error and exits.
Randomizes the password for the users.
Creates all required security entries in Oracle Internet Directory and new schema entry, using randomized password.
Changes the password of users in metadata repository.
Writes message to standard output "Update of new OID entries successful" if creation of Oracle Internet Directory entries and update of randomized passwords was successful.
The Process Connect upgrade process creates Process Connect schema.
Oracle Application Server Certificate Authority (OCA) is an OracleAS Identity Management component.
The OCA files are upgraded by Oracle Universal Installer as part of the OracleAS Identity Management upgrade procedure and the Oracle Application Server Certificate Authority.
When you use Oracle Universal Installer to upgrade OCA as a part of a 10g (9.0.4) OracleAS Identity Management upgrade, the password store, wallets, customized email and screen templates, and custom policies are copied from the source Oracle home to the new Oracle home.
In addition, the upgraded OCA is registered with OracleAS Single Sign-On, added to Oracle HTTP Server, and registered with Distributed Configuration Management (DCM). The certificate usage types for all the certificates ever issued by OCA are changed to the new 10.1.2 certificate usage types, and some new OCA configuration parameters are added.
If you are upgrading from Release 2 (9.0.2), you can use the Metadata Repository Upgrade Assistant (MRUA) to create the OCA schema from scratch. This is because OCA was not available as a Release 2 (9.0.2) Oracle Application Server component.
The Oracle Ultra Search schema upgrade process performs these steps. Note that most of these steps are performed by the Database Upgrade Assistant (DBUA) when you upgrade the database:
Copies the Oracle Ultra Search 10g Release 2 (10.1.2) binaries to the Infrastructure database directories.
Connects to repository database as SYS
.
Performs existence check for the WKSYS
schema. Gets version number stored in the schema. If the version number is not 9.0.2 (or its patch release version), an error occurs and the process stops.
Runs the SQL*Plus script wkdbmig.sql
to upgrade the schema and data in WKSYS
.
Executes a loadjava
command to load Java stored packages into the WKSYS
schema.
Runs the SQL*Plus script to create the demo schema and create an Ultra Search instance based on the demo schema.
Updates the version number in the component registry.
If you are upgrading from Release 2 (9.0.2), configures the Oracle Ultra Search schema information stored in the Oracle Internet Directory.
The OracleAS Portal schema upgrade process (the upgrade.pl
script) performs these steps:
Runs a series of prechecks to ensure that the upgrade should proceed.
Exports a subset of the OracleAS Portal tables to a dump file.
Displays all invalid objects before the upgrade starts. (All OracleAS Portal packages must be valid at this stage.)
Disables all provisioning profiles so that synchronizations between OracleAS Portal and Oracle Internet Directory are suspended.
Disables the DBMS jobs in the OracleAS Portal schema. These will be re-enabled at the end of the upgrade.
Drops statistics gathered on all tables in the OracleAS Portal schema. The statistics supported by the OracleAS Portal will be gathered near the end of the upgrade.
Installs OWA packages, if necessary.
Note: This step is executed only the current version of the OWA packages is not the latest expected version. This step causes invalidation of all packages in the instance that depend on the OWA packages. In particular, most OracleAS Portal packages in all OracleAS Portal schemas on the instance will become invalid. For this reason, after upgrade, you may need to recompile packages on other affected schemas after the upgrade. The upgrade script only recompiles packages in the Portal schema being upgraded. |
Loads new versions of OracleAS Portal Java objects into the schema.
Deletes all product messages in all languages.
Loads all of the latest product messages in all languages that were previously installed.
Note: If any product messages were altered before the upgrade, you must manually re-apply the changes. |
Changes the schema and compiles all OracleAS Portal packages.
Exports temporary tables created during the upgrade.
Recompiles any invalid non-OracleAS Portal objects. Warnings are issued if any invalid non-Oracle9iAS Portal objects remain after this step.
Updates the OracleAS Portal version if there are no fatal compilation errors.
Enables all provisioning profiles so that synchronizations between OracleAS Portal and Oracle Internet Directory resume.
Searches for errors and warnings in the upgrade log file and displays those encountered; if there were no errors, the process displays a success message.
The Oracle Application Server Web Services schema upgrade script wuru9023.sql
(used for Oracle Application Server Release 2 (9.0.2) with the UDDI 9.0.2.3 patch) performs these steps:
Connects to repository database.
Performs pre-upgrade validations (such as proper UDDI version) to determine whether the upgrade can proceed. If any of the checks fail, the upgrade stops.
Performs initial structural changes, such as creating and dropping tables, columns, and indexes.
Performs upgrades to the UDDI server properties and configuration, inserting new rows and updating existing rows in the configuration tables.
The Oracle Application Server Web Services schema upgrade helper script wuru9020.sql
(used for Oracle Application Server Release 2 (9.0.2)) performs these steps:
Performs pre-upgrade validations (such as proper UDDI version) to determine whether the upgrade can proceed. If any of the checks fail, the upgrade stops.
Destroys all schema contents, such as tables, PL/SQL packages, and so on, in the UDDI database schema.
Invokes the 9.0.4 installation script to install the 10g Release 2 (10.1.2) database schema.
Web Clipping is a new component, so there are no dependencies on other upgrade processes in the middle tier or Infrastructure. The upgrade process creates new tables and constraints, defines a package with functions and procedures, and seeds the tables with randomized data.
MRUA upgrades the OracleAS Wireless schema from 10g (9.0.4) to 10g Release 2 (10.1.2), but it cannot upgrade the OracleAS Wireless schema from Release 2 (9.0.2).
As a result, if you are upgrading from 10g (9.0.4), or if you are upgrading Release 2 (9.0.2) and you did not configure OracleAS Wireless, then MRUA upgrades the OracleAS Wireless schema successfully.
However, if you are upgrading from Release 2 (9.0.2) and you configured OracleAS Wireless in a Release 2 (9.0.2) middle tier, then you must install and configure OracleAS Wireless 10g Release 2 (10.1.2) before running MRUA to upgrade the OracleAS Metadata Repository to 10g Release 2 (10.1.2).