![]() ![]() ![]() ![]() ![]() ![]() |
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:
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.
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.
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-3 lists the .SQL files containing the DDL for the database upgrade from WebLogic Portal 9.2 to10.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.
This section provides general upgrade information for WebLogic Portal database and metadata files. The process consists of the following steps:
To start the WebLogic Upgrade Wizard in graphical mode and upgrade a WebLogic domain on a Windows platform, either:
upgrade.cmd
from the WL_HOME\common\bin
directoryNote: | 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.
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. |
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.
![]() ![]() ![]() |