This chapter describes upgrade tasks related to upgrading your WebLogic Portal product to 10.3.
This chapter contains the following sections:
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.
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.
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-2 lists the .SQL files containing the DDL for the database upgrade from WebLogic Portal 9.2 to 10.0
.
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.
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:
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:
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:
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.
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. |
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:
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. |
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:
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. |
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.