http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/index.html
Upgrading Silent Configuration Scripts
If you have an existing silent configuration script from SP2 or earlier that you wish to use with SP3 or later, and that script configures domains to use a nondefault database—that is, a database other than PointBase—you need to configure the following JDBC connection pools, which were introduced in SP3:
cgJMSPool-nonXA
—Provided by WebLogic Workshop and used by WebLogic Workshop, WebLogic Portal, and WebLogic Integration for a WebLogic JMS persistent file or database store. The configuration of this connection pool is required for all domains that include Workshop, WebLogic Portal, or WebLogic Integration.
portalPool
—Provided and used by WebLogic Portal for portal framework, services, and content management. The addition of this new pool contributes to the simplification of creating a domain using a database with an XA driver. The configuration of this connection pool is required only for domains that include WebLogic Portal.
For a description of the default JDBC configuration introduced in 8.1 SP3, see "Default JDBC Configurations for WebLogic Platform" in Managing WebLogic Platform Database Resources at the following URL:
http://download.oracle.com/docs/cd/E13196_01/platform/docs81/db_mgmt/default_JDBC_configs.html
Upgrading WebLogic Server Plug-Ins
If you are using a Web server with your WebLogic Platform installation, it is important that you keep your Web server up to date to ensure you have all the latest security patches and support. Updated Web server plug-ins are included when you upgrade your WebLogic Server installation. Although it is not required, you may want to replace the Web server plug-ins installed with your Web server with the updated versions.
For details about installing the Web server plug-ins included with your WebLogic Platform installation, see Using Web Server Plug-Ins With WebLogic Server at the following URL:
http://download.oracle.com/docs/cd/E13222_01/wls/docs81/plugins/index.html
Roadmap for Upgrading to WebLogic Platform 8.1 SP6
This section includes the following topics about upgrading to SP6:
Summary of Required SP6 Upgrade Procedures for WebLogic Platform 8.1
This section includes the following information:
- A summary of the required procedures for upgrading each category of WebLogic Platform 8.1 applications to SP6
- Links to documents that provide more details
- Important notes about upgrade-related information
Table 2-2 Upgrading WebLogic Platform 8.1 to SP6
To upgrade applications built using...
|
From version...
|
Do the following...
|
WebLogic Platform
|
8.1 SP4 or SP5
|
See Upgrading WebLogic Platform Applications to SP6.
|
WebLogic Server
|
8.1 SP4 or SP5
|
Modify the startWebLogic script in each domain to point to the new 1.4.2 SDK (see SDKs Bundled with WebLogic Platform 8.1). This task is the only one required for upgrading WebLogic Server applications.
|
WebLogic Workshop
|
8.1 SP4 or SP5
|
|
WebLogic Portal
|
8.1 SP4 or SP5
|
|
WebLogic Integration
|
8.1 SP4 or SP5
|
See "Upgrading WebLogic Integration 8.1 SP4 or SP5 to WebLogic Integration 8.1 SP 6" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/roadmap.html
|
BEA JRockit
|
8.1 SP4 or SP5
|
N/A. There is no required upgrade procedure.
|
Upgrading WebLogic Platform Applications to SP6
Depending on the upgrade path appropriate for your WebLogic Platform environment—namely, depending on whether you are upgrading an existing domain, or creating a new domain and deploying your applications to it—we recommend the basic steps provided in the following sections to complete the SP6 upgrade process for applications that include WebLogic Integration and WebLogic Portal resources. Such applications typically are deployed in domains based on the Basic WebLogic Platform Domain template.
The following sections include:
If, after reading these sections, you need more information before starting the upgrade procedure, see FAQ for Upgrading WebLogic Platform.
If You Are Upgrading an Existing WebLogic Platform Domain
To upgrade an existing WebLogic Platform domain, complete the following procedure:
- Choose an upgrade installation method. For example, if you want to upgrade your WebLogic Platform 8.1 software on a Windows system to SP6, you might choose to run Smart Update. For more information, see Choosing an Upgrade Installation Method.
- Make sure that all running instances of WebLogic Server are shut down.
- Complete the steps described in the following sections:
Upgrade the Domain's WebLogic Integration Resources
To upgrade the domain's WebLogic Integration resources, complete the following steps:
When your PointBase update is complete, go to the next step.
Note: If your domain is configured with a database other than PointBase, make sure it is stopped before you proceed.
- Open a UNIX shell or Windows command prompt window, as appropriate.
- Set the
ANT_OPTS
environment variable on your machine to -Xmx256m
, to ensure that Ant has enough memory available to complete the domain upgrade procedure. To set the ANT_OPTS
variable, enter the command appropriate for your operating system:
Windows:
prompt> set ANT_OPTS=-Xmx256m
UNIX:
prompt> setenv ANT_OPTS -Xmx256m
- Go to the following directory:
WL_HOME
/integration/upgrade
- Create an
options.properties
file that contains settings for your domain environment. The WL_HOME
/integration/upgrade
directory contains the file options.properties.sample
, which you can use as a template for creating this file.
Define the properties shown in Table 2-5.
Note: Use "/
" as a file separator in directory paths.
Table 2-3 Values You Specify in the options.properties File
Set the following property...
|
To the following values...
|
current.version=sp n
|
Service pack level of the domain being upgraded:
|
domain.path= path
|
Absolute path of the directory containing the domain to be upgraded. For example:
c:/bea/user_projects/domains/myDomain
|
beahome.path= path
|
Absolute path of the BEA Home directory in which the pre-upgraded WebLogic Integration 8.1 software is installed. For example:
c:/bea
|
beahome.latest.path= path
|
Absolute path of the BEA Home directory in which the WebLogic Integration 8.1 SP6 software is installed. For example:
c:/bea
|
os=both
|
Default value of both .
Note: If you specify the property os=unix , substitutions may be skipped when executing the upgrade Ant script target, as described in the steps that follow this table. Therefore, we recommend that you use the default property os= both ; this ensures that all paths are properly upgraded.
If you choose run the upgrade script using the os=unix property, you should run the update_paths target manually.
|
weblogic=weblogic81
|
Name of the directory in which the pre-upgrade WebLogic Integration 8.1 software is installed. The default is weblogic81 .
|
weblogic.latest=weblogic81
|
Name of the directory in which the WebLogic Integration 8.1 SP6 software is installed. The default is weblogic81 .
|
db_upgrade=true
|
Value of true for all supported databases, except PointBase. If your domain is configured with PointBase, set this property to false .
|
platform.hp=false
|
Value of false , which is the default value in the options.properties.sample file. For HP-UX platforms, however, this property must be set to true .
|
- Go to the root directory of the domain you are upgrading. For example:
BEA_HOME
/user_projects/domains/
your_domain
- Open the
workshop.properties
file in a text editor and change the absolute paths to relative paths in the definitions of the wlsHome.path
and jdkHome.path
variables.
- Return to the following directory:
BEA_HOME
/weblogic81/integration/upgrade
- Run the
domain_upgrade.xml
script to upgrade the WebLogic Integration resources in your domain, using the following syntax:
ant -f domain_upgrade.xml upgrade -Doptions.properties=
your_options_file
-Dsingle.node=
true
|
false
-Ddb_type=
your_db_vendor
-Ddb_user=
user_name
-Ddb_password=
password
-Ddb_server=
your_server:port
-Ddb_name=
database_name
In the preceding syntax:
your_options_file
represents the options.properties
file that you created in step 5.
- If you are upgrading a single-node domain, set the
-Dsingle.node
parameter to true
. If you are upgrading a clustered domain, set this parameter to false
.
- If you are using PointBase, complete the following steps:
- Go to the following directory:
BEA_HOME
/weblogic81/integration/dbscripts/pointbase
- Run one of the following WebLogic Integration database schema upgrade scripts, as appropriate:
For upgrading SP4 to SP6:
upgrade_runtime_sp4_sp6.sql
For upgrading SP5 to SP6:
upgrade_runtime_sp5_sp6.sql
- Remove the domain server's
.wlnotdelete
subdirectory and all its contents. This subdirectory, which contains the server's cache, is located in the domain's server directory. For example:
BEA_HOME
/user_projects/domains/mydomain/examplesServer/.wlnotdelete
Removing the .wlnotdelete
subdirectory ensures that all domain upgrade changes become effective when the server is restarted.
For complete details about each of these steps, see "Upgrading WebLogic Integration 8.1 SP4 or SP5 to WebLogic Integration 8.1 SP6" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/roadmap.html.
Upgrade the Domain's WebLogic Portal Resources
To upgrade the domain's WebLogic Portal resources, complete the following steps:
- If you are doing a complete, new installation as part of your upgrade, update the WebLogic Portal scripts in your domain as necessary, as explained in "WebLogic Portal Full Installer" in "Upgrading to Service Pack 6" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack5to6.html
- If you are upgrading from SP5 to SP6, skip to step 3. If you are upgrading from SP4 to SP6, your first step is to upgrade the WebLogic Portal database schema in the domain to SP4. To do so, complete the following procedure:
- Go to the following directory:
BEA_HOME
/weblogic81/portal/upgrade/SP5
- Complete the steps for your specific database provided in "Step 2: Upgrade Existing Database Schema" in Upgrading to Service Pack 5 in the WebLogic Portal 8.1 Upgrade Guide.
- Update the
db_settings.properties
file with your 8.1 database settings. (The instructions at the beginning of the file explain the specific settings that you need to make.)
- Run the appropriate WebLogic Portal database schema upgrade script:
On Windows: upgrade_db_schema_to_81SP6.cmd
On UNIX: upgrade_db_schema_to_81SP6.sh
For complete details about each of these steps, see "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 6" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack5to6.html
- Upgrade the domain to use the new SP6 libraries and database modules, which may be appropriate if you want to preserve a highly customized domain, including LDAP setup. The following procedure summarizes the steps that are required:
- Go to the following directory:
BEA_HOME/weblogic81/portal/upgrade/SP6
- Run the WebLogic Portal database update script,
pf_update_system_data.sql
.
- Make a backup copy of the upgraded database.
For complete details about each of these steps, see "Step 2: Upgrade Existing Portal Framework Data" in in "Upgrading to Service Pack 6" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack5to6.html
- Upgrade your WebLogic Portal applications in the domain by completing the following steps:
- When upgrading applications that are stored as EAR files, you must manually update the encryption.
- Start WebLogic Workshop 8.1 SP6. If the server is running, shut it down in Workshop by choosing Tools—> WebLogic Server—> Stop WebLogic Server.
- In WebLogic Workshop, open the portal application you want to update.
- In the Application window, right-click the application directory and choose Install—> Update Portal Libraries. In the Application window, right-click the application directory and choose Install—> Update Portal Libraries. Workshop prompts you to indicate whether you want to overwrite files with SP6 versions. Click OK.
After the portal application libraries are updated, a dialog box prompts you to select Web projects in the application that you want to have updated.
- Select the Web projects for which you want to have the libraries updated, and click OK.
For complete details about upgrading WebLogic Portal resources and applications in an existing domain, see "Upgrading to Service Pack 6" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack5to6.html
Redeploy the Upgraded Application
The final upgrade step is to redeploy the application on your server.
For deployment instructions, see the following documents:
Congratulations! You have completed the SP6 domain upgrade procedure.
If You Are Creating a New Domain and Deploying Your Applications to It
To create a new WebLogic Platform domain and deploy your existing applications to it, complete the following procedure:
- Use the Configuration Wizard and the Basic WebLogic Platform Domain template to create a new domain.
- Make sure that all running instances of WebLogic Server are shut down.
- Complete the steps described in the following sections:
Upgrade the WebLogic Integration Resources for Your New Domain
To upgrade the WebLogic Integration resources used by your application in the new domain, complete the following steps:
- If your domain is configured with a database other than PointBase, make sure it is stopped before you proceed.
- Go to the following directory:
BEA_HOME
/weblogic81/integration/dbscripts/
db_directory
Here db_directory
represents the name of the database directory configured for your domain, such as sybase
.
- Run the appropriate WebLogic Integration database schema upgrade scripts, as appropriate:
For upgrading SP4 to SP6:
upgrade_runtime_sp4_sp6.sql
For upgrading SP5 to SP6:
upgrade_runtime_sp5_sp6.sql
For complete details, see "Upgrading WebLogic Integration 8.1 SP4 or SP5 to WebLogic Integration 8.1 SP6" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/roadmap.html.
Upgrading the WebLogic Portal Resources for Your New Domain
To upgrade the WebLogic Portal resources used by your application in the new domain, complete the following steps:
- If you are doing a complete, new installation as part of your upgrade, update the WebLogic Portal scripts as necessary, as explained in "WebLogic Portal Full Installer" in "Upgrading to Service Pack 6" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack5to6.html
- If you are upgrading from SP5 to SP6, skip to step 3. If you are upgrading from SP4 to SP6, your first step is to upgrade the WebLogic Portal database schema in the domain to SP5. To do so, complete the following procedure:
- Go to the following directory:
BEA_HOME
/weblogic81/portal/upgrade/SP5
- Complete the steps for your specific database as provided in "Step 2: Upgrade Existing Database Schema" in Upgrading to Service Pack 5 in the WebLogic Portal 8.1 Upgrade Guide.
- Update the
db_settings.properties
file with your 8.1 database settings. (The instructions at the beginning of the file explain the specific settings that you need to make.)
- Run the appropriate WebLogic Portal database schema upgrade script:
On Windows: upgrade_db_schema_to_81SP5.cmd
On UNIX: upgrade_db_schema_to_81SP5.sh
For complete details about each of these steps, see "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 5" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack4to5.html
- Upgrade the domain to use the new SP6 libraries and database modules, which may be appropriate if you want to preserve a highly customized domain, including LDAP setup. The following procedure summarizes the steps that are required:
- Go to the following directory:
BEA_HOME
/weblogic81/portal/upgrade/SP6
- Run the WebLogic Portal database update script,
pf_update_system_data.sql
.
- Make a backup copy of the upgraded database.
- Upgrade your WebLogic Portal applications in the domain by completing the following steps:
- If you are using a third-party content management system, re-configure that repository before deploying it. This allows the passwords to be re-encrypted for the new domain.
- Re-encrypt any passwords that are used to access WSRP portlets. Encryption is domain-specific so it needs to be updated when switching domains. Also, when upgrading applications that are stored as EAR files, you must manually update the encryption.
- Start WebLogic Workshop 8.1 SP6. If the server is running, shut it down in Workshop by choosing Tools—> WebLogic Server—> Stop WebLogic Server.
- In WebLogic Workshop, open the portal application you want to update.
- In the Application window, right-click the name of the application directory and choose Install—> Update Portal Libraries. Workshop prompts you to indicate whether you want to overwrite the existing files with SP6 versions. Click OK.)
After the portal application libraries are updated, a dialog box prompts you to select Web projects in the application that you want to have updated.
- Select the Web projects for which you want to have libraries updated, and click OK.
For complete details about upgrading WebLogic Portal resources and applications in an existing domain, see "Upgrading to Service Pack 6" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack5to6.html
Redeploy the Upgraded Application
The final upgrade step is to redeploy the application on your server.
For deployment instructions, see the following documents:
Congratulations! You have completed the SP6 upgrade procedure.
Roadmap for Upgrading to WebLogic Platform 8.1 SP5
This section includes the following topics about upgrading to SP5:
Summary of Required SP5 Upgrade Procedures for WebLogic Platform 8.1
This section includes the following information:
- A summary of the required procedures for upgrading each category of WebLogic Platform 8.1 applications to SP5.
- Links to documents that provide more details
- Important notes about upgrade-related information
Table 2-4 Upgrading WebLogic Platform 8.1 to SP5
To upgrade applications built using...
|
From version...
|
Do the following...
|
WebLogic Platform
|
8.1 SP3 or SP4
|
See Upgrading WebLogic Platform Applications to SP5.
|
WebLogic Server
|
8.1 SP3 or SP4
|
Modify the startWebLogic script in each domain to point to the new 1.4.2 SDK (see SDKs Bundled with WebLogic Platform 8.1). This task is the only one required for upgrading WebLogic Server applications.
|
WebLogic Workshop
|
8.1 SP3 or SP4
|
|
WebLogic Portal
|
8.1 SP3 or SP4
|
|
WebLogic Integration
|
8.1 SP3 or SP4
|
See "Upgrading WebLogic Integration 8.1 SP3 or SP4 to WebLogic Integration 8.1 SP5" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/roadmap.html
|
BEA JRockit
|
8.1 SP3 or SP4
|
N/A. There is no required upgrade procedure.
|
Upgrading WebLogic Platform Applications to SP5
Depending on the upgrade path appropriate for your WebLogic Platform environment—namely, depending on whether you are upgrading an existing domain, or creating a new domain and deploying your applications to it—we recommend the basic steps provided in the following sections to complete the SP5 upgrade process for applications that include WebLogic Integration and WebLogic Portal resources. Such applications typically are deployed in domains based on the Basic WebLogic Platform Domain template.
The following sections include:
If, after reading these sections, you need more information before starting the upgrade procedure, see FAQ for Upgrading WebLogic Platform.
If You Are Upgrading an Existing WebLogic Platform Domain
To upgrade an existing WebLogic Platform domain, complete the following procedure:
- Choose an upgrade installation method. For example, if you want to upgrade your WebLogic Platform 8.1 software on a Windows system to SP5, you might choose to run Smart Update. For more information, see Choosing an Upgrade Installation Method.
- Make sure that all running instances of WebLogic Server are shut down.
- Complete the steps described in the following sections:
Upgrade the Domain's WebLogic Integration Resources
To upgrade the domain's WebLogic Integration resources, complete the following steps:
When your PointBase update is complete, go to the next step.
Note: If your domain is configured with a database other than PointBase, make sure it is stopped before you proceed.
- Open a UNIX shell or Windows command prompt window, as appropriate.
- Set the
ANT_OPTS
environment variable on your machine to -Xmx256m
, to ensure that Ant has enough memory available to complete the domain upgrade procedure. To set the ANT_OPTS
variable, enter the command appropriate for your operating system:
Windows:
prompt> set ANT_OPTS=-Xmx256m
UNIX:
prompt> setenv ANT_OPTS -Xmx256m
- Go to the following directory:
WL_HOME
/integration/upgrade
- Create an
options.properties
file that contains settings for your domain environment. The WL_HOME
/integration/upgrade
directory contains the file options.properties.sample
, which you can use as a template for creating this file.
Define the properties shown in Table 2-5.
Note: Use "/
" as a file separator in directory paths.
Table 2-5 Values You Specify in the options.properties File
Set the following property...
|
To the following values...
|
current.version=sp n
|
Service pack level of the domain being upgraded:
|
domain.path= path
|
Absolute path of the directory containing the domain to be upgraded. For example:
c:/bea/user_projects/domains/myDomain
|
beahome.path= path
|
Absolute path of the BEA Home directory in which the pre-upgraded WebLogic Integration 8.1 software is installed. For example:
c:/bea
|
beahome.latest.path= path
|
Absolute path of the BEA Home directory in which the WebLogic Integration 8.1 SP5 software is installed. For example:
c:/bea
|
os=both
|
Default value of both .
Note: If you specify the property os=unix , substitutions may be skipped when executing the upgrade Ant script target, as described in the steps that follow this table. Therefore, we recommend that you use the default property os= both ; this ensures that all paths are properly upgraded.
If you choose run the upgrade script using the os=unix property, you should run the update_paths target manually.
|
weblogic=weblogic81
|
Name of the directory in which the pre-upgrade WebLogic Integration 8.1 software is installed. The default is weblogic81 .
|
weblogic.latest=weblogic81
|
Name of the directory in which the WebLogic Integration 8.1 SP5 software is installed. The default is weblogic81 .
|
db_upgrade=true
|
Value of true for all supported databases, except PointBase. If your domain is configured with PointBase, set this property to false .
|
platform.hp=false
|
Value of false , which is the default value in the options.properties.sample file. For HP-UX platforms, however, this property must be set to true .
|
- Go to the root directory of the domain you are upgrading. For example:
BEA_HOME
/user_projects/domains/
your_domain
- Open the
workshop.properties
file in a text editor and change the absolute paths to relative paths in the definitions of the wlsHome.path
and jdkHome.path
variables.
- Return to the following directory:
BEA_HOME
/weblogic81/integration/upgrade
- Run the
domain_upgrade.xml
script to upgrade the WebLogic Integration resources in your domain, using the following syntax:
ant -f domain_upgrade.xml upgrade -Doptions.properties=
your_options_file
-Dsingle.node=
true
|
false
-Ddb_type=
your_db_vendor
-Ddb_user=
user_name
-Ddb_password=
password
-Ddb_server=
your_server:port
-Ddb_name=
database_name
In the preceding syntax:
your_options_file
represents the options.properties
file that you created in step 5.
- If you are upgrading a single-node domain, set the
-Dsingle.node
parameter to true
. If you are upgrading a clustered domain, set this parameter to false
.
- If you are using PointBase, complete the following steps:
- Go to the following directory:
BEA_HOME
/weblogic81/integration/dbscripts/pointbase
- Run one of the following WebLogic Integration database schema upgrade scripts, as appropriate:
For upgrading SP3 to SP5:
upgrade_runtime_sp3_sp5.sql
For upgrading SP4 to SP5:
upgrade_runtime_sp4_sp5.sql
- Remove the domain server's
.wlnotdelete
subdirectory and all its contents. This subdirectory, which contains the server's cache, is located in the domain's server directory. For example:
BEA_HOME
/user_projects/domains/mydomain/examplesServer/.wlnotdelete
Removing the .wlnotdelete
subdirectory ensures that all domain upgrade changes become effective when the server is restarted.
For complete details about each of these steps, see "Upgrading WebLogic Integration 8.1 SP3 or SP4 to WebLogic Integration 8.1 SP5" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/roadmap.html.
Upgrade the Domain's WebLogic Portal Resources
To upgrade the domain's WebLogic Portal resources, complete the following steps:
- If you are doing a complete, new installation as part of your upgrade, update the WebLogic Portal scripts in your domain as necessary, as explained in "WebLogic Portal Full Installer" in "Upgrading to Service Pack 5" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack4to5.html
- If you are upgrading from SP4 to SP5, skip to step 3. If you are upgrading from SP3 to SP5, your first step is to upgrade the WebLogic Portal database schema in the domain to SP4. To do so, complete the following procedure:
- Go to the following directory:
BEA_HOME
/weblogic81/portal/upgrade/SP4
- Complete the steps for your specific database provided in "Step 2: Upgrade Existing Database Schema" in Upgrading to Service Pack 4 in the WebLogic Portal 8.1 Upgrade Guide.
- Update the
db_settings.properties
file with your 8.1 database settings. (The instructions at the beginning of the file explain the specific settings that you need to make.)
- Run the appropriate WebLogic Portal database schema upgrade script:
On Windows: upgrade_db_schema_to_81SP4.cmd
On UNIX: upgrade_db_schema_to_81SP4.sh
For complete details about each of these steps, see "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 4" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack3to4.html
- Upgrade the domain to use the new SP5 libraries and database modules, which may be appropriate if you want to preserve a highly customized domain, including LDAP setup. The following procedure summarizes the steps that are required:
- Go to the following directory:
BEA_HOME/weblogic81/portal/upgrade/SP5
- Run the WebLogic Portal database update script,
pf_update_system_data.sql
.
- Make a backup copy of the upgraded database.
For complete details about each of these steps, see "Step 2: Upgrade Existing Portal Framework Data" in in "Upgrading to Service Pack 5" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack4to5.html
- Upgrade your WebLogic Portal applications in the domain by completing the following steps:
- When upgrading applications that are stored as EAR files, you must manually update the encryption.
- Start WebLogic Workshop 8.1 SP5. If the server is running, shut it down in Workshop by choosing Tools—> WebLogic Server—> Stop WebLogic Server.
- In WebLogic Workshop, open the portal application you want to update.
- In the Application window, right-click the application directory and choose Install—> Update Portal Libraries. In the Application window, right-click the application directory and choose Install—> Update Portal Libraries. Workshop prompts you to indicate whether you want to overwrite files with SP5 versions. Click OK.
After the portal application libraries are updated, a dialog box prompts you to select Web projects in the application that you want to have updated.
- Select the Web projects for which you want to have the libraries updated, and click OK.
For complete details about upgrading WebLogic Portal resources and applications in an existing domain, see "Upgrading to Service Pack 5" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack4to5.html
Redeploy the Upgraded Application
The final upgrade step is to redeploy the application on your server.
For deployment instructions, see the following documents:
Congratulations! You have completed the SP5 domain upgrade procedure.
If You Are Creating a New Domain and Deploying Your Applications to It
To create a new WebLogic Platform domain and deploy your existing applications to it, complete the following procedure:
- Use the Configuration Wizard and the Basic WebLogic Platform Domain template to create a new domain.
- Make sure that all running instances of WebLogic Server are shut down.
- Complete the steps described in the following sections:
Upgrade the WebLogic Integration Resources for Your New Domain
To upgrade the WebLogic Integration resources used by your application in the new domain, complete the following steps:
- If your domain is configured with a database other than PointBase, make sure it is stopped before you proceed.
- Go to the following directory:
BEA_HOME
/weblogic81/integration/dbscripts/
db_directory
Here db_directory
represents the name of the database directory configured for your domain, such as sybase
.
- Run the appropriate WebLogic Integration database schema upgrade scripts, as appropriate:
For upgrading SP3 to SP5:
upgrade_runtime_sp3_sp5.sql
For upgrading SP4 to SP5:
upgrade_runtime_sp4_sp5.sql
For complete details, see "Upgrading WebLogic Integration 8.1 SP3 or SP4 to WebLogic Integration 8.1 SP5" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/roadmap.html.
Upgrading the WebLogic Portal Resources for Your New Domain
To upgrade the WebLogic Portal resources used by your application in the new domain, complete the following steps:
- If you are doing a complete, new installation as part of your upgrade, update the WebLogic Portal scripts as necessary, as explained in "WebLogic Portal Full Installer" in "Upgrading to Service Pack 5" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack4to5.html
- If you are upgrading from SP4 to SP5, skip to step 3. If you are upgrading from SP3 to SP5, your first step is to upgrade the WebLogic Portal database schema in the domain to SP4. To do so, complete the following procedure:
- Go to the following directory:
BEA_HOME
/weblogic81/portal/upgrade/SP4
- Complete the steps for your specific database as provided in "Step 2: Upgrade Existing Database Schema" in Upgrading to Service Pack 4 in the WebLogic Portal 8.1 Upgrade Guide.
- Update the
db_settings.properties
file with your 8.1 database settings. (The instructions at the beginning of the file explain the specific settings that you need to make.)
- Run the appropriate WebLogic Portal database schema upgrade script:
On Windows: upgrade_db_schema_to_81SP4.cmd
On UNIX: upgrade_db_schema_to_81SP4.sh
For complete details about each of these steps, see "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 4" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack3to4.html
- Upgrade the domain to use the new SP5 libraries and database modules, which may be appropriate if you want to preserve a highly customized domain, including LDAP setup. The following procedure summarizes the steps that are required:
- Go to the following directory:
BEA_HOME
/weblogic81/portal/upgrade/SP5
- Run the WebLogic Portal database update script,
pf_update_system_data.sql
.
- Make a backup copy of the upgraded database.
- Upgrade your WebLogic Portal applications in the domain by completing the following steps:
- If you are using a third-party content management system, re-configure that repository before deploying it. This allows the passwords to be re-encrypted for the new domain.
- Re-encrypt any passwords that are used to access WSRP portlets. Encryption is domain-specific so it needs to be updated when switching domains. Also, when upgrading applications that are stored as EAR files, you must manually update the encryption.
- Start WebLogic Workshop 8.1 SP5. If the server is running, shut it down in Workshop by choosing Tools—> WebLogic Server—> Stop WebLogic Server.
- In WebLogic Workshop, open the portal application you want to update.
- In the Application window, right-click the name of the application directory and choose Install—> Update Portal Libraries. Workshop prompts you to indicate whether you want to overwrite the existing files with SP5 versions. Click OK.)
After the portal application libraries are updated, a dialog box prompts you to select Web projects in the application that you want to have updated.
- Select the Web projects for which you want to have libraries updated, and click OK.
For complete details about upgrading WebLogic Portal resources and applications in an existing domain, see "Upgrading to Service Pack 5" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack4to5.html
Redeploy the Upgraded Application
The final upgrade step is to redeploy the application on your server.
For deployment instructions, see the following documents:
Congratulations! You have completed the SP5 upgrade procedure.
Roadmap for Upgrading to WebLogic Platform 8.1 SP4
This section includes the following topics about upgrading to SP4:
Summary of Required SP4 Upgrade Procedures for WebLogic Platform 8.1
This section includes the following information:
- A summary of the required procedures for upgrading each category of WebLogic Platform 8.1 applications to SP4
- Links to documents that provide more details
- Important notes about upgrade-related information.
Table 2-6 Upgrading WebLogic Platform 8.1 to SP4
To upgrade applications built using...
|
From version...
|
Do the following...
|
WebLogic Platform
|
8.1 SP2 or SP3
|
See the following:
http://download.oracle.com/docs/cd/E13196_01/platform/docs81/db_m
gmt/default_JDBC_configs.html
The default JDBC configuration for the prepackaged
WebLogic Platform configuration templates has changed.
Existing silent configuration scripts that use the prepackaged
templates may need to be revised to accommodate the new
default JDBC configuration.
Otherwise, the only upgrade procedures required for
WebLogic Platform applications are at the component level.
|
WebLogic Server
|
8.1 SP2 or SP3
|
Modify the startWebLogic script in each domain to point to the new 1.4.2 SDK (see SDKs Bundled with WebLogic Platform 8.1). Otherwise, there is no required upgrade procedure for WebLogic Server applications.
|
WebLogic Workshop
|
8.1 SP2 or SP3
|
|
WebLogic Portal
|
8.1 SP2 or SP3
|
|
WebLogic Integration
|
8.1 SP2 or SP3
|
See "Upgrading WebLogic Integration 8.1 SP2 and SP3 to WebLogic Integration 8.1 SP4" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/upgradetosp4.html
Note: WebLogic Platform 8.1 SP2 requires you to install the SDK1.4.2/Oracle10gdriver/Database patch if you are using the 1.4.2 SDK or Oracle 10g driver, or the SQL Server, Sybase, or DB2 databases. If you are upgrading from SP2, the SP4 upgrade procedure assumes that you have installed this patch if your domain is configured with that database. For more information about this patch, see Roadmap for Upgrading to WebLogic Platform 8.1 SP2.
|
WebLogic JRockit
|
8.1 SP2 or SP3
|
N/A. There is no required upgrade procedure.
|
Upgrading WebLogic Platform Applications to SP4
Depending on the upgrade path appropriate for your WebLogic Platform environment—namely, upgrading an existing domain, or creating a new domain and deploying your applications to it—we recommend the basic steps provided in the following subsections to complete the SP4 upgrade process for applications that include WebLogic Integration and WebLogic Portal resources. Such applications typically are deployed in domains that have been created based on the Basic WebLogic Platform Domain template.
These subsections include:
After you finish reading these subsections, we recommend that you see FAQ for Upgrading WebLogic Platform, for more information before beginning the upgrade process.
If You Are Upgrading an Existing WebLogic Platform Domain
If you have chosen to upgrade an existing WebLogic Platform domain, perform the following steps to complete the update process:
- Choose an upgrade installation method. For example, if you are using Smart Update on Windows systems, and upgrade your WebLogic Platform 8.1 software to SP4. See Choosing an Upgrade Installation Method for more information.
- Upgrade the WebLogic Integration resources in the domain. The following procedure summarizes the steps that are required:
After you have upgraded your PointBase database, proceed with the following steps.
- Go to the following directory:
BEA_HOME
/weblogic81/integration/upgrade
- Create an
options.properties
file, which sets your domain environment. The preceding directory contains the file options.properties.sample
, which you can use as a template for creating this file.
If you are upgrading from SP2, open the options.properties
file in a text editor and make the following edits:
First, change the line current.version=sp3
to current.version=sp2
.
Second, if you are using PointBase, change the line db_upgrade=true
to db_upgrade=false
.
- Go to the root directory of the domain you are upgrading; for example:
BEA_HOME
/user_projects/domains/
your_domain
- Edit the
workshop.properties
file to change the paths of the wlsHome.path
and jdkHome.path
variables from relative paths to absolute paths.
- Return to the following directory:
BEA_HOME
/weblogic81/integration/upgrade
- Run the
domain_upgrade.xml
script to upgrade the WebLogic Integration resources in your domain, using the following syntax:
ant -f domain_upgrade.xml upgrade -Doptions.properties=
your_options_file
-Dsingle.node=true -Ddb_type=
your_db_vendor
-Ddb_user=
user_name
-Ddb_password=
password
-Ddb_server=
your_server:port
-Ddb_name=
database_name
- If you are using PointBase, complete the following steps:
Go to the following directory:
BEA_HOME
/weblogic81/integration/dbscripts/pointbase
Run one of the following WebLogic Integration database schema upgrade scripts, as appropriate:
For upgrading SP2 to SP4:
upgrade_runtime_sp2_sp4.sql
For upgrading SP3 to SP4:
upgrade_runtime_sp3_sp4.sql
For complete details about each of these steps, see "See "Upgrading WebLogic Integration 8.1 SP2 and SP3 to WebLogic Integration 8.1 SP4" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/upgradetosp4.html
- If you are doing a complete, new installation as part of your upgrade, update the WebLogic Portal scripts as necessary, as explained in "WebLogic Portal Full Installer" in "Upgrading to Service Pack 4" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack3to4.html
- If you are upgrading from SP2 to SP4, complete the following steps to first upgrade the WebLogic Portal database schema in the domain to SP3. Otherwise go to step 7.
- Change to the following directory:
BEA_HOME/weblogic81/portal/upgrade/SP3
- Complete the procedures explained in "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 3" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack2to3.html
- Update the file
db_settings.properties
with your 8.1 database settings. (The instructions at the beginning of db_settings.properties
explain the specific settings that you need to make.)
- Run the WebLogic Portal database schema upgrade script
upgrade_db_schema_to_81SP3.cmd
(for Windows) or upgrade_db_schema_to_81SP3.sh
(for UNIX).
- Upgrade the WebLogic Portal database schema in the domain to SP4. The following procedure summarizes the steps that are required:
- Change to the following directory:
BEA_HOME/weblogic81/portal/upgrade/SP4
- Complete the procedures explained in "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 4" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack3to4.html
- Update the file
db_settings.properties
with your 8.1 database settings. (The instructions at the beginning of db_settings.properties
explain the specific settings that you need to make.)
- Run the WebLogic Portal database schema upgrade script
upgrade_db_schema_to_81SP4.cmd
(for Windows) or upgrade_db_schema_to_81SP4.sh
(for UNIX).
- Upgrade your WebLogic Portal applications in the domain by completing the following steps:
- Start WebLogic Workshop 8.1 SP4. If the server is running, shut it down in Workshop by selecting Tools—> WebLogic Server—> Stop WebLogic Server.
- From WebLogic Workshop, open the portal application you want to update.
- In the Application window, right-click the application directory and choose Install—> Update Portal Libraries. (Upon execution, Workshop prompts you whether you want to overwrite these files with their new SP4 versions. Click OK.)
After the portal application libraries are updated, a dialog box appears that lets you select Web projects in the application to update.
- Select the Web projects whose libraries you want to update, and click OK.
- Redeploy the upgraded applications.
For complete details about upgrading WebLogic Portal resources and applications in an existing domain, see "Upgrading to Service Pack 4" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack3to4.html
Congratulations! You have completed the SP4 domain upgrade procedure.
Note: BEA Liquid Data for WebLogic is not yet available for use with WebLogic Platform 8.1 SP4. For Platform domains that include Liquid Data, BEA recommends that you continue to use WebLogic Platform 8.1 SP3 until Liquid Data for WebLogic is available for use with WebLogic Platform 8.1 SP4.
If You Are Creating a New Domain and Deploying Your Applications to It
If you have chosen to create a new WebLogic Platform domain, perform the following steps to complete the update process:
- Use the Configuration Wizard to create a new domain using the Basic WebLogic Platform Domain template.
- Upgrade the existing WebLogic Integration resources for your new domain. The following procedure summarizes the steps that are required:
- Go to the following directory, where
db_directory
represents the name of the database directory configured for your domain, such as sybase
.
BEA_HOME
/weblogic81/integration/dbscripts/
db_directory
- Run one of the following WebLogic Integration database schema upgrade scripts, as appropriate:
For upgrading SP2 to SP4:
upgrade_runtime_sp2_sp4.sql
For upgrading SP3 to SP4:
upgrade_runtime_sp3_sp4.sql
- From WebLogic Workshop, redeploy your existing WebLogic Integration application into the new domain.
For complete details, see "Upgrading WebLogic Integration 8.1 SP2 and SP3 to WebLogic Integration 8.1 SP4" in the WebLogic Integration Upgrade Guide at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/upgrade/upgradetosp4.html
- If you are doing a complete, new installation as part of your upgrade, update the WebLogic Portal scripts as necessary, as explained in "WebLogic Portal Full Installer" in "Upgrading to Service Pack 4" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack3to4.html
- If you are upgrading from SP2 to SP4, complete the following steps to first upgrade the existing WebLogic Portal database schema to SP3. Otherwise go to step 8.
- Change to the following directory:
BEA_HOME/weblogic81/portal/upgrade/SP3
- Complete the procedures explained in "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 3" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack2to3.html
- Update the file
db_settings.properties
with your 8.1 database settings. (The instructions at the beginning of db_settings.properties
explain the specific settings that you need to make.)
- Run the WebLogic Portal database schema upgrade script
upgrade_db_schema_to_81SP3.cmd
(for Windows) or upgrade_db_schema_to_81SP3.sh
(for UNIX).
- Upgrade the existing WebLogic Portal database schema for your new domain to SP4. The following procedure summarizes the steps that are required:
- Change to the following directory:
BEA_HOME/weblogic81/portal/upgrade/SP4
- Complete the procedures explained in "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 4" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack3to4.html
- Update the file
db_settings.properties
with your 8.1 database settings. (The instructions at the beginning of db_settings.properties
explain the specific settings that you need to make.)
- Run the WebLogic Portal database schema upgrade script,
upgrade_db_schema_to_81SP4.cmd
(for Windows) or upgrade_db_schema_to_81SP4.sh
(for UNIX).
- Upgrade your WebLogic Portal applications in the domain by completing the following steps:
- Start WebLogic Workshop 8.1 SP4. If the server is running, shut it down in Workshop by selecting Tools—> WebLogic Server—> Stop WebLogic Server.
- From WebLogic Workshop, open the portal application you want to update.
- In the Application window, right-click the application directory and choose Install—> Update Portal Libraries. (Upon execution, Workshop prompts you to overwrite these files with their new SP4 versions. Click OK.)
After the portal application libraries are updated, a dialog box appears that lets you select Web projects in the application to update.
- Select the Web projects for which you want libraries updated, and click OK.
- Redeploy the upgraded applications.
For complete details about upgrading WebLogic Portal resources and applications in an existing domain, see "Upgrading to Service Pack 4" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack3to4.html
Congratulations! You have completed the SP4 upgrade procedure.
Roadmap for Upgrading to WebLogic Platform 8.1 SP3
This section includes the following topics about upgrading to SP3:
Summary of Required SP3 Upgrade Procedures for WebLogic Platform 8.1
This section includes the following information:
- A summary of the required procedures for upgrading each category of WebLogic Platform 8.1 applications to SP3
- Links to documents that provide more details
- Important notes about upgrade-related information.
Table 2-7 Upgrading WebLogic Platform 8.1 to SP3
To upgrade applications built using...
|
From version...
|
Do the following...
|
WebLogic Platform
|
8.1 SP2
|
See the following:
http://download.oracle.com/docs/cd/E13196_01/platform/docs81/db_m
gmt/default_JDBC_configs.html
The default JDBC configuration for the prepackaged
WebLogic Platform configuration templates has changed.
Existing silent configuration scripts that use the prepackaged
templates may need to be revised to accommodate the new
default JDBC configuration.
Otherwise, the only upgrade procedures required for
WebLogic Platform applications are at the component level.
|
WebLogic Server
|
8.1 SP2
|
Modify the startWebLogic script in each domain to point to the new 1.4.2 SDK (see SDKs Bundled with WebLogic Platform 8.1). Otherwise, there is no required upgrade procedure for WebLogic Server applications.
|
WebLogic Workshop
|
8.1 SP2
|
|
WebLogic Portal
|
8.1 SP2
|
|
WebLogic Integration
|
8.1 SP2
|
See "Upgrading to WebLogic Integration 8.1 SP3" in the WebLogic Integration Release Notes for version 8.1, Service Pack 3. This document is available in PDF format in a ZIP file. To obtain this document:
1. Locate the "Download PDF Documentation for Previous Releases of WebLogic Integration 8.1" page, available at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/interm/prevreleases.html.
2. Click "All WebLogic Integration 8.1 SP3 Documents."
This downloads a ZIP file containing PDF files for all the WebLogic Integration 8.1 SP3 documentation. Open the file relnotes.pdf .
Note: WebLogic Platform 8.1 SP2 requires you to install the SDK1.4.2/Oracle10gdriver/Database patch if you are using the 1.4.2 SDK or Oracle 10g driver, or the SQL Server, Sybase, or DB2 databases. The SP3 upgrade procedure assumes that you have installed this patch if your domain is configured with that database. For more information about this patch, see Roadmap for Upgrading to WebLogic Platform 8.1 SP2.
|
WebLogic JRockit
|
8.1 SP2
|
N/A. There is no required upgrade procedure.
|
Upgrading WebLogic Platform Applications to SP3
Depending on the upgrade path appropriate for your WebLogic Platform environment—namely, upgrading an existing domain, or creating a new domain and deploying your applications to it—we recommend the basic steps provided in the following subsections to complete the SP3 upgrade process for applications that include WebLogic Integration and WebLogic Portal resources. Such applications typically are deployed in domains that have been created based on the Basic WebLogic Platform Domain template.
These subsections include:
After you finish reading these subsections, we recommend that you see FAQ for Upgrading WebLogic Platform, for more information before beginning the upgrade process.
If You Are Upgrading an Existing WebLogic Platform Domain
If you have chosen to upgrade an existing WebLogic Platform domain, perform the following steps to complete the update process:
- Choose an upgrade installation method. For example, if you are using Smart Update on Windows systems, and upgrade your WebLogic Platform 8.1 software to SP3. See Choosing an Upgrade Installation Method for more information.
- Upgrade the WebLogic Integration resources in the domain. The following procedure summarizes the steps that are required:
- Obtain the WebLogic Integration Release Notes for version 8.1, Service Pack 3. This document is available in PDF format in a ZIP file. To download this document, locate the "Download PDF Documentation for Previous Releases of WebLogic Integration 8.1" page, available at the following URL:
http://download.oracle.com/docs/cd/E13214_01/wli/docs81/interm/prevreleases.html.
Click "All WebLogic Integration 8.1 SP3 Documents." This downloads a ZIP file containing PDF files for all the WebLogic Integration 8.1 SP3 documentation. Open the file relnotes.pdf
. Refer to the section "Upgrading to WebLogic Integration 8.1 SP3" for details on the instructions that follow for upgrading WebLogic Integration.
- If you are using PointBase as your database, follow the procedure described in "Upgrading PointBase" in "Upgrading to WebLogic Integration 8.1 SP3" in the preceding document.
- Change to the following directory:
BEA_HOME
/weblogic81/integration/upgrade
- Create an
options.properties
file, which sets your domain environment. The preceding directory contains the file options.properties.sample
, which you can use as a template for creating this file.
- If you are using PointBase, open the
options.properties
file in a text editor, and change the line db_upgrade=true
to db_upgrade=false
.
- Change to the root directory of the domain you are upgrading; for example:
BEA_HOME
/user_projects/domains/
your_domain
- Edit the
workshop.properties
file to change the paths of the wlsHome.path
and jdkHome.path
variables from relative paths to absolute paths.
- Change back to the following directory:
BEA_HOME
/weblogic81/integration/upgrade
- Run the
domain_upgrade.xml
script to upgrade the WebLogic Integration resources in your domain, using the following syntax:
ant -f domain_upgrade.xml upgrade -Doptions.properties=
your_options_file
-Dsingle.node=true -Ddb_type=
your_db_vendor
-Ddb_user=
user_name
-Ddb_password=
password
-Ddb_server=
your_server:port
-Ddb_name=
database_name
- If you are using PointBase, complete the following steps:
Change to the following directory:
BEA_HOME
/weblogic81/integration/dbscripts/pointbase
Run the following WebLogic Integration database schema upgrade script:
upgrade_runtime_sp2_sp3.sql
- Upgrade the WebLogic Portal resources in the domain. The following procedure summarizes the steps that are required:
- Update scripts if necessary as explained in "WebLogic Portal Full Installer" in "Upgrading to Service Pack 3" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack2to3.html
- Change to the following directory:
BEA_HOME/weblogic81/portal/upgrade/SP3
- Complete the procedures explained in "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 3" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack2to3.html
- Update the file
db_settings.properties
with your 8.1 database settings. (The instructions at the beginning of db_settings.properties
explain the specific settings that you need to make.)
- Run the WebLogic Portal database schema upgrade script,
upgrade_db_schema_to_81SP3.cmd
(for Windows) or upgrade_db_schema_to_81SP3.sh
(for UNIX).
- Start WebLogic Workshop 8.1 SP3. If the server is running, shut it down in Workshop by selecting Tools—> WebLogic Server—> Stop WebLogic Server.
- From WebLogic Workshop, upgrade any existing WebLogic Portal applications. To do this, open the portal application you want to update. Then, in the Application window, right-click the application directory and choose Install—> Update Portal Libraries. (Upon execution, Workshop prompts you whether you want to overwrite these files with their new SP3 versions. Click OK.)
- After the portal application libraries are updated, a dialog box appears that lets you select Web projects in the application to update. Select the Web projects whose libraries you want to update, and click OK.
- Redeploy the upgraded applications.
For complete details about upgrading WebLogic Portal resources and applications in an existing domain, see "Upgrading to Service Pack 3" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack2to3.html
Congratulations! You have completed the SP3 domain upgrade procedure.
Note: To upgrade a platform domain to SP3 that includes BEA Liquid Data for WebLogic, you must first uninstall Liquid Data, upgrade the domain to SP3, then re-install Liquid Data. (Note that platform SP3 domains support only Liquid Data for WebLogic 8.1 SP3.)
If You Are Creating a New Domain and Deploying Your Applications to It
If you have chosen to create a new WebLogic Platform domain, perform the following steps to complete the update process:
- Use the Configuration Wizard to create a new domain using the Basic WebLogic Platform Domain template.
- Upgrade the existing WebLogic Integration resources for your new domain. The following procedure summarizes the steps that are required:
- Obtain the document WebLogic Integration Release Notes for version 8.1, Service Pack 3. This document is available in PDF format in a ZIP file. To download this document, locate the "Download PDF Documentation for Previous Releases of WebLogic Integration 8.1" page, available at the following URL:
http://download.oracle.com/docs/cd/E13214_01/wli/docs81/interm/prevreleases.html.
Click "All WebLogic Integration 8.1 SP3 Documents." This downloads a ZIP file containing PDF files for all the WebLogic Integration 8.1 SP3 documentation. Open the file relnotes.pdf
. Refer to the section "Upgrading to WebLogic Integration 8.1 SP3" for details on the instructions that follow for upgrading WebLogic Integration.
- If you are using PointBase as your database, follow the procedure described in "Upgrading PointBase" in "Upgrading to WebLogic Integration 8.1 SP3" in the preceding document.
- Change to the following directory, where
db_directory
represents the name of your database directory configured for your domain; for example, sybase
.
BEA_HOME
/weblogic81/integration/dbscripts/
db_directory
- Run the WebLogic Integration database schema upgrade script
upgrade_runtime_sp2_sp3.sql
.
- From WebLogic Workshop, redeploy your existing WebLogic Integration application into the new domain.
- Upgrade the existing WebLogic Portal resources for your new domain. The following procedure summarizes the steps that are required:
- Update scripts if necessary as explained in "WebLogic Portal Full Installer" in "Upgrading to Service Pack 3" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack2to3.html
- Change to the following directory:
BEA_HOME
/weblogic81/weblogic81/portal/upgrade/SP3
- Complete the procedures explained in "Step 2: Upgrade Existing Database Schema" in "Upgrading to Service Pack 3" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack2to3.html
- Update the file
db_settings.properties
with your 8.1 database settings. (The instructions at the beginning of db_settings.properties
explain the specific settings that you need to make.)
- Run the WebLogic Portal database schema upgrade script,
upgrade_db_schema_to_81SP3.cmd
(for Windows) or upgrade_db_schema_to_81SP3.sh
(for UNIX).
- Start WebLogic Workshop 8.1 SP3. If the server is running, shut it down in Workshop by selecting Tools—> WebLogic Server—> Stop WebLogic Server.
- From WebLogic Workshop, upgrade any existing WebLogic Portal applications. To do this, open the portal application you want to update. Then, in the Application window, right-click the application directory and choose Install—> Update Portal Libraries. (Upon execution, Workshop prompts you whether you want to overwrite these files with their new SP3 versions. Click OK.)
- After the portal application libraries are updated, a dialog box appears that lets you select Web projects in the application to update. Select the Web projects whose libraries you want to update, and click OK.
- Redeploy the upgraded applications.
For complete details about upgrading WebLogic Portal resources and applications in an existing domain, see "Upgrading to Service Pack 3" in the WebLogic Portal 8.1 Upgrade Guide at the following URL:
http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepack2to3.html
Congratulations! You have completed the SP3 upgrade procedure.
Roadmap for Upgrading to WebLogic Platform 8.1 SP2
The following table provides a roadmap for upgrading WebLogic Platform component-based applications to version 8.1 SP2. When upgrading to SP2, note the following:
- It is recommended that you update your application startup scripts to reference the new SDK or JRockit directory, as described in SDKs Bundled with WebLogic Platform 8.1. However, this type of update is not mandatory because existing Java 2 SDKs are preserved during an upgrade.
- If you are using WebLogic Platform 8.1 SP2 with the Sun Java 2 1.4.2 SDK, the Oracle 10g driver, or SQL Server, Sybase, or DB2 databases, you may need to install the WebLogic Platform 8.1 SP2 SDK1.4.2/Oracle10gdriver/Database patch. This patch, and a description of the specific configurations that require it, are available at the following dev2dev Web site:
http://dev2dev.bea.com/products/wlplatform81/patch/wlplat81sp2_patch.jsp
Table 2-8 Roadmap for Upgrading to WebLogic Platform 8.1 SP2
To upgrade applications built using...
|
From version...
|
See...
|
WebLogic Platform
|
8.1
|
N/A
Note: The only upgrade procedures required for WebLogic Platform applications are at the component level. See the appropriate component-level information elsewhere in this table.
|
WebLogic Server
|
8.1 or 8.1 SP1
|
N/A. There is no required upgrade procedure.
|
WebLogic Workshop
|
8.1
|
N/A. There is no required upgrade procedure.
|
WebLogic Portal
|
8.1
|
"Upgrading 8.1 to Service Pack 2" in the WebLogic Portal 8.1 Upgrade Guide at http://download.oracle.com/docs/cd/E13218_01/wlp/docs81/upgrade/servicepacks.html
|
WebLogic Integration
|
8.1
|
See "Upgrading from WebLogic Integration 8.1 to SP2" in the WebLogic Integration Release Notes for version 8.1, Service Pack 2. This document is available in PDF format in a ZIP file.
To obtain this document:
1. Display the page "Download PDF Documentation for Previous Releases of WebLogic Integration 8.1," available at http://download.oracle.com/docs/cd/E13214_01/wli/docs81/interm/prevreleases.html.
2. Click "All WebLogic Integration 8.1 SP2 Documents."
This downloads a ZIP file containing all the WebLogic Integration 8.1 SP2 documentation. Open the file relnotes.pdf .
|
WebLogic JRockit
|
8.1
|
N/A. There is no required upgrade procedure.
|
Roadmap for Upgrading to WebLogic Platform 8.1
The following table provides a roadmap for upgrading WebLogic Platform component-based applications to version 8.1.