> Upgrade Guide > Upgrading to WebLogic Portal 10.0

Upgrade Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Upgrading to WebLogic Portal 10.0

This chapter describes upgrade tasks related to upgrading your WebLogic Portal product to 10.0. Tasks related to upgrading individual portal projects that you created with previous releases of WebLogic Portal are described in Appendix B of the Portal Development Guide.

This chapter contains the following sections:

 

Before You Begin

You can upgrade WebLogic Portal 8.1 and 9.2 portal applications directly to 10.0. For information on upgrading earlier versions to WebLogic Portal 8.1 SP4, SP5, or SP6, see the Upgrade Guide for Version 8.1.

Database Changes During Upgrade

The WebLogic Upgrade Wizard executes database scripts to add and modify database tables for WebLogic Portal 10.0. Before you run the Upgrade Wizard to perform database upgrade tasks, you should perform full backups of all WebLogic Portal databases.

Note: Oracle 8.1.7 (DBMS version and drivers) is no longer supported. Upgrade to either Oracle 9i or 10G by following your vendor's instructions before you upgrade to WebLogic 10.0.

WebLogic Portal 8.1 supports only the Oracle Thin driver. A WebLogic Portal 8.1 domain that was configured with either the weblogic.jdbcx.oracle.OracleDataSource or the weblogic.jdbc.oracle.OracleDriver driver is not supported. The domain might upgrade successfully, but the following error will occur when you start the server: 

<Warning> <JDBC> <BEA-001129> <Received exception while creating connection for pool "portalDataSourceAlwaysXA": Invalid Oracle URL specified>
<Error> <Deployer> <BEA-149205> <Failed to initialize the application
'portalDataSourceAlwaysXA' due to error weblogic.application.ModuleException: - with nested exception:
[weblogic.common.ResourceException: Invalid Oracle URL specified]

When you run the 10.0 Upgrade Wizard, the default is to automatically upgrade the following two databases:

Note: If the database objects associated with the database being upgraded do not exist (for example, the appsGroupSpaceDataSource exists in the domain, but the GroupSpace database objects do not exist in the database), then the database upgrade from WebLogic Portal 9.2.x to 10.0.x will return an SQLException. To successfully complete the database upgrade, you will have to run database scripts from the WebLogic Upgrade Wizard by selecting appsGroupSpaceDataSource and clicking on the Run Scripts button. Alternatively, you can use the following command to run the scripts:
Note: create_db.cmd -database.properties=groupspace_database.properties
Note: You can upgrade a database to a particular version only once.

You can choose to defer database upgrades and do them manually. Certain database upgrade tasks, such as dropping deprecated database objects, upgrading separate behavior tracking databases, and upgrading separate content management databases require a manual database upgrade.

For additional information on how to perform database upgrade tasks manually, see Performing Database Upgrade Tasks Manually.

DDL Files

Table 2 -2 lists the .SQL files containing the Data Definition Language (DDL) for the database upgrade from WebLogic Portal 8.1 to 10.0.

Table 2 -2 Files Containing the DDL for Upgrading from 8.1 to 10.0
Directory Name
File Name
<WL-HOME>/common/p13n/db/<DBMS>
p13n9_create_tables.sql
 
p13n9_create_indexes.sql
 
upgrade_fromdbmsauth_towlssqlauth.sql (if the domain is configured for the DBMS authenticator)
 
dep9_drop_tables.sql (manual upgrade only)
<WL-HOME>/cm/db/<DBMS>
cm9_create_tables.sql
 
cm9_create_indexes.sql
 
cm9_create_fkeys.sql
 
cm9_create_triggers.sql
 
cmv9_create_tables.sql
 
cmv9_create_indexes.sql
<WL-HOME>/portal/db/<DBMS>
pf9_create_tables.sql
 
pf9_create_fkeys.sql
 
pf9_create_views.sql
 
comm_create_tables.sql
 
comm_create_fkeys.sql
 
comm_create_indexes.sql
 
comm_create_views.sql
 
comm_create_triggers.sql
 
dep9_drop_tables.sql (manual upgrade only)

Table 2-3 lists the .SQL files containing the DDL for the database upgrade from WebLogic Portal 9.2 to10.0

Table 2-3 Files Containing the DDL for Upgrading from 9.2 to 10.0
Directory Name
File Name
<WL-HOME>/portal/db/<DBMS>
pf10_create_tables.sql
<WL-HOME>/cm/db/<DBMS>
cm10_create_tables.sql
 
cmv10_create_tables.sql

Backing Up Your Applications and Data

Before you upgrade your application environment, you should manually back up the domain and any external application and application database resources in a separate process. You should back up the relevant information on all machines in the domain. The wizard backs up only the domain directory and does not preserve file permissions.

 

Upgrade Steps

This section provides general upgrade information for WebLogic Portal database and metadata files. The process consists of the following steps:

  1. Verify that the WebLogic domain is not running.
  2. Upgrade the portal domain using the WebLogic Upgrade Wizard before upgrading any applications.

    3. To start the WebLogic Upgrade Wizard in graphical mode and upgrade a WebLogic domain on a Windows platform, either:

    • Run upgrade.cmd from the WL_HOME\common\bin directory

      • or

    • Go to Start > All Programs > BEA Products > Tools > Domain Upgrade Wizard
      • Note: The WebLogic Upgrade Wizard is described in detail in Upgrading WebLogic Application Environments.
      WARNING: If you have a platform domain containing WebLogic Integration 8.1, you cannot perform a domain upgrade using this wizard. Contact Technical Support.

      The wizard upgrades your portal, content management, and personalization database data. It optionally upgrades your 8.1 RDBMSAuthenticator to the WebLogic 10.0 SQLAuthenticator. For more information on upgrading your user store, see Security.

  3. Read Functional Changes Affecting Your WebLogic Portal Environment.
  4. As needed, upgrade individual applications, as described in Appendix B of the Portal Development Guide.
    5. Note: The BEA Workshop for WebLogic Platform Programmer's Guide, available as part of the Workshop for WebLogic help, contains several useful topics that you should review as you prepare to upgrade your portal application. The Workshop for WebLogic documentation includes step-by-step instructions for using the Import Wizard, and detailed information about what happens during the upgrade process and any required manual pre- or post-upgrade tasks.
Caution: You should be familiar with the Workshop for WebLogic upgrade steps, and any related limitations, before you attempt to upgrade a WebLogic Portal application from 8.1 to 10.0. Before proceeding, refer to the Workshop for WebLogic documentation on e-docs or by choosing Help > Help Contents > BEA Workshop for WebLogic Platform Programmer's Guide in the main menu of the product.

 

Functional Changes for WebLogic Portal 10.0

Review the functional changes that are described in Functional Changes Affecting Your WebLogic Portal Environment. If any manual upgrade tasks are required for your particular environment, perform those tasks as instructed.


  Back to Top       Previous  Next