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.3

This chapter describes upgrade tasks related to upgrading your WebLogic Portal product to 10.3.

This chapter contains the following sections:

 

Before You Begin

You can upgrade directly to WebLogic Portal 10.3 from 8.1, 9.2, and 10.0/10.2 portal applications. For information on upgrading earlier versions to WebLogic Portal 8.1, 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.3. 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.3.

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 occurs 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.3 Upgrade Wizard, the default is to automatically upgrade the following two databases:

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 -1 lists the .SQL files containing the Data Definition Language (DDL) for the database upgrade from WebLogic Portal 8.1 to 9.2.

Table 2 -1 Files Containing the DDL for Upgrading from 8.1 to 9.2
Directory Name
File Name
<WLPORTAL_HOME>/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)
<WLPORTAL_HOME>/content-mgmt/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
<WLPORTAL_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-2 lists the .SQL files containing the DDL for the database upgrade from WebLogic Portal 9.2 to 10.0

Table 2-2 Files Containing the DDL for Upgrading from 9.2 to 10.0
Directory Name
File Name
<WLPORTAL_HOME>/portal/db/<DBMS>
pf10_create_tables.sql
<WLPORTAL_HOME>/content-mgmt/db/<DBMS>
cm10_create_tables.sql
 
cmv10_create_tables.sql

.

Table 2-3 Files Containing the DDL for Upgrading from 10.0/10.2 to 10.3
Directory Name
File Name
<WLPORTAL_HOME>/p13n/db/<DBMS>
p13n102_create.tables.sql
p13n102_drop.tables.sql
p13n103_create_tables.sql
<WLPORTAL_HOME>/portal/db/<DBMS>
pf102_create_tables.sql
pf102_drop_tables.sql
<WLPORTAL_HOME>/content-mgmt/db/<DBMS>
cmv102_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.

Removing Unneeded Database Objects

You can clean up an existing database (any database prior to Portal 10.3) that contains unused and deprecated WebLogic Commerce Services database objects.

Run the following scripts to remove the objects from the database:

 

Upgrading to WebLogic Portal 10.3

The upgrade process requires you to upgrade your portal domain and your portal application. Upgrading from the following WebLogic Portal versions is supported: 9.2, 9.2 MP1, 10.0, 10.0 MP1, and 10.2 applications.

This section contains the following topics:

Upgrading Your Portal Domain

This section provides upgrade instructions for WebLogic Portal database and metadata files.

As you prepare to upgrade your portal application, review the Workshop for WebLogic upgrade documentation available by choosing Help > Help Contents > Oracle Workshop for WebLogic User’s Guide > Upgrading to Workshop for WebLogic 10.x. 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.

Perform the following steps to upgrade your portal domain:

  1. Verify that the WebLogic domain is not running.
  2. Upgrade the portal domain using the WebLogic Upgrade Wizard before you upgrade your portal application. To start the WebLogic Upgrade Wizard in graphical mode and upgrade a WebLogic domain on a Windows platform:
    • Run upgrade.cmd from the <WLPORTAL_HOME>\common\bin directory
Note: Do not use the menu option Start > All Programs > Oracle Products > WebLogic Server 10.x > Tools > Domain Upgrade Wizard. This launches the WebLogic Server domain upgrade wizard.
Note: The WebLogic Upgrade Wizard is described in detail in Upgrading WebLogic Application Environments.

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

  1. Read Functional Changes Affecting Your WebLogic Portal Environment.
  2. As needed, upgrade individual applications as described in the Production Operations Guide.
Tip: If you customized how you set the domain in your start scripts, your changes will be overwritten when you run the WebLogic Portal 10.3 start scripts. You should manually copy any start script (and setDomainEnv.cmd/sh) modifications you made and want to preserve in the upgraded domain.

Upgrading from Portal 9.2 and 10.0/10.2 to 10.3

You can upgrade your WebLogic Portal 9.2, 9.2 MP1, 10.0, 10.0 MP1, or 10.2 applications to 10.3. The WebLogic Portal APIs have been maintained in WebLogic Portal 10.3 (except for the Commerce API, which was deprecated in 10.0), and most core formats for the database and file based assets have not changed. For general information on this type of upgrade, see Portal 9.2, 10.0, 10.2 to 10.3 Upgrade Overview.

The upgrade process involves upgrading WebLogic Portal applications and resources to WebLogic Portal 10.3. The 9.2 and 10.0/10.2 upgrades are performed on the Workshop for WebLogic Eclipse project folder. After you upgrade to Portal 10.3, you cannot go back to a previous portal version.

Choose one of the following ways to upgrade your Portal 9.2 or 10.0/10.2 application to 10.3:

Tip: You can choose to point your upgraded application to a new or upgraded 10.3 domain.

Perform the following steps to upgrade a 9.2 or 10.0/10.2 application to 10.3:

  1. In Workshop for WebLogic, ensure that Project > Build Automatically is enabled to resolve any build errors. By default, it is enabled.
  2. Upgrade your domain using the WebLogic Upgrade Wizard. For more information, see Upgrading Your Portal Domain.
  3. Perform one of the following steps in Workshop for WebLogic to upgrade an existing WebLogic Portal 9.2 and 10.0 application:
    1. Open an existing portal application as a workspace in Workshop for WebLogic – Choose File > Switch Workspace, locate the existing workspace, and click OK. You can also choose the existing portal application in the Workspace Launcher when you launch Workshop for WebLogic, and click OK.
      2. Tip: To open an existing portal application as a workspace, ensure that the workspace and the application are created and accessed on the same machine. The project directory stores non-transferable preferences.
    2. Import an exploded 9.2 or 10.0 project into Workshop for WebLogic – Choose File > Import > General > Existing Projects into Workspace, and click Next. Click Select root directory, locate the project’s directory, and click Finish. Click Finish again on the next dialog box to complete the upgrade.
    3. Import an archived 9.2 or 10.0 project file (such as a .ZIP file) into Workshop for WebLogic – Choose File > General > Existing Projects into Workspace, and click Next. Click Select archive file, locate the archive file, and click Finish. Click Finish again on the next dialog box to complete the upgrade.

Upgrading from Portal 8.1 to 10.3

WebLogic Portal enables you to upgrade your 8.1 SP4, SP5, and SP6 applications directly to 10.3. Most WebLogic Portal APIs have been maintained in WebLogic Portal 10.3 (except for the Commerce API, which was deprecated in 10.0), and most core formats for the database and file based assets have not changed. Where changes have been made, tools are provided to upgrade you to the new format, or provide manual changes where needed. For general information on this type of upgrade, see Portal 8.1 to 10.3 Upgrade Overview.

The upgrade process involves upgrading WebLogic Portal 8.1 portal applications and resources to WebLogic Portal 10.3. The 8.1 to 10.3 upgrade is performed on a .work file. When you upgrade from WebLogic Portal 8.1 to 10.3, your PointBase database is upgraded.

The high-level steps in the upgrade process include the following:

  1. Upgrade your domain using the WebLogic Upgrade Wizard. For more information, see Upgrading Your Portal Domain.
  2. Upgrade existing WebLogic Portal 8.1 SP4, SP5, and SP6 applications to run in WebLogic Portal 10.3. You can do this automatically using the Import utility that is provided in Workshop for WebLogic. For additional details on importing an 8.1 appl.ication, see Upgrading WebLogic Portal 8.1 Projects to WebLogic Portal 10.3..
Tip: If you customized how you set the domain in your start scripts, your changes will be overwritten when you run the WebLogic Portal 10.3 start scripts.

 

Functional Changes for WebLogic Portal 10.3

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