http://download.oracle.com/docs/cd/E13196_01/platform/docs81/upgrade/index.html

Domains Running In Production Mode Without PointBase

For WebLogic Integration 8.1 domains running in production mode without the PointBase database, the nopointbase option must be passed to startWebLogic.cmd or startWebLogic.sh. Otherwise, the server will not start correctly; WebLogic Integration 8.1 enables PointBase even when it is not used by the configuration.

Upgrading an Application That Uses an Application Integration Control

For an application using an Application Integration control that was originally deployed using the WebLogic Workshop auto-deploy feature, you must first undeploy the application and then redeploy it using the WebLogic Integration Administration Console or the command line deployer.

Upgrading an Existing WebLogic Integration 8.1 SP4 or SP5 Domain to WebLogic Integration 8.1 SP6

This section provides the steps for upgrading either an existing single node or clustered domain generated for WebLogic Integration 8.1 SP5 to WebLogic Integration 8.1 SP6. Another way to update to a WebLogic Integration 8.1 SP5 domain is to create a new WebLogic Integration 8.1 SP6 domain and move your existing WebLogic Integration 8.1 SP5 applications to the new domain. To learn more see "Creating a New Domain and Deploying Applications Into It" in Roadmap for Upgrading WebLogic Platform available at the following URL:

http://download.oracle.com/docs/cd/E13196_01/platform/docs81/upgrade/roadmap.html

To upgrade a domain generated for WebLogic Integration 8.1 SP5 to WebLogic Integration 8.1 SP6, complete the following steps:

Set the correct environment and paths:
Go to BEA_HOME_816/weblogic81/common/bin directory.

In the preceding line, BEA_HOME_816 represents the directory where WebLogic Platform 8.1 SP6 is installed.

Execute the environment script by entering the following:

UNIX using sh or ksh: . ./commEnv.sh

Windows: commEnv.cmd

Shut down any instances of WebLogic Server^® running on the domain being upgraded.
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: set ANT_OPTS=-Xmx256m

UNIX: setenv ANT_OPTS -Xmx256m

If you are using PointBase as your database, follow the procedure in Upgrading PointBase, then continue with the next step.
Locate the options.properties.sample file in the following directory:

BEA_HOME_816/weblogic81/integration/upgrade

In the preceding line, BEA_HOME_816 represents the directory where WebLogic Platform 8.1 SP6 is installed.

Using the options.properties.sample file as a template, create a file named options.properties, and specify the following values in it:

Note: Use "/" as a file separator.

Table 2-1 Values for the options.properties file

Command	Description
current.version=sp5	The version of WebLogic Platform from which you want to upgrade. For example, sp5.
domain.path=path	The absolute path of the domain to upgrade. For example: c:/bea/user_projects/domains/myDomain
beahome.path=path	The absolute path to the WebLogic Integration 8.1 SP5 installation. For example: c:/bea
beahome.latest.path=path	Absolute path to the WebLogic Integration 8.1 SP6 installation. For example: c:/bea
os=both	Specify the platform on which the software is being upgraded, ideally use the default value both. Note: Note: If you specify the property os=unix, substitutions may be skipped when executing the upgrade Ant script target as described in step 10. in Upgrading an Existing WebLogic Integration 8.1 SP4 or SP5 Domain to WebLogic Integration 8.1 SP6 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 WebLogic Integration SP5 is installed. Default value is weblogic81.
weblogic.latest=weblogic81	Name of the directory in which WebLogic Integration SP6 is installed. Default value is weblogic81.
platform.hp=false	Ideally use the default value false, which indicates the platform is not HP-UX. Set the value to true if the platform is HP-UX.
db_upgrade=true	Set the value as true for any supported database except PointBase. If the domain is configured to use PointBase, set the value to false. See step 8. in Upgrading an Existing WebLogic Integration 8.1 SP4 or SP5 Domain to WebLogic Integration 8.1 SP6 for more information on the database upgrade process.


 

Note: If you have upgraded to WebLogic Integration 8.1 SP6 using Smart Update, beahome.path and beahome.latest.path should specify the same directory path. For example, on Windows if you installed WebLogic Integration 8.1 SP5 in the c:/bea directory and then used the Smart Update to upgrade that installation to WebLogic Integration 8.1 SP6, both beahome.path and beahome.latest.path should point to the c:/bea directory.

Note: BEA recommends that you use the option backup=true. Setting this option to true in your options.properties file means that the domain specified in the domain.path is backed up to domain.path_BK_timestamp.

Locate the upgrade scripts in the following directory:

BEA_HOME_816/weblogic81/integration/upgrade

In the preceding line, BEA_HOME_816 represents the directory where WebLogic Platform 8.1 SP6 is installed.

Determine if you need or want to manually upgrade the database or use the upgrade script.

Upgrading the database structure is implicit in the upgrade process. If you are using PointBase or prefer to do this as a separate step, you must invoke the upgrade script with the database flag set to false as follows: -Ddb_upgrade=false and then upgrade the database manually.

To learn more about upgrading the database manually, see Upgrading PointBase or Manually Upgrading WebLogic Integration 8.1 SP4 or SP5 Databases to WebLogic Integration 8.1 SP6.

Note: The databases must be upgraded before you start the WebLogic Integration 8.1 SP6 server in the upgraded domain.

Run the following ant target to upgrade the JDK version reference:

ant -f domain_upgrade.xml update_paths

Run the upgrade script for the domain that you have created:

ant -f domain_upgrade.xml upgrade 
   -Doptions.properties=[<your options file>]    -Dcurrent.version=[sp3|sp4]
   -Dsingle.node=[true|false]
   -Ddb_type=[oracle|sybase|mssql|db2|pointbase]
   -Ddb_user=[<user_name>]
   -Ddb_password=[<password>] -Ddb_server=[<server>:<port>]
   -Ddb_name=[<database_name>]

The your_options_file is usually called the options.properties. The user_name and password are the valid username and password for the database. For help on the ant syntax, type ant on the command line.

Note: If you are upgrading your database using the script, the data source must be connected to an active database.

Warning: Do not upgrade your domain more than once. If you do, the domain upgrade process will fail with an error.

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:

c:\bea\user_projects\domains\mydomain\examplesServer\.wlnotdelete

Removing the .wlnotdelete subdirectory ensures that all domain upgrade changes become effective when the server is restarted.

Note: Note: To see the available Ant targets and a description of each, enter the following command from the WL_HOME/integration/upgrade directory:

ant -f domain_upgrade.xml usage

If you are upgrading a clustered domain, delete the staging directories for the administration and managed servers in the upgraded domain.

This ensures that all the servers get the upgraded WebLogic Integration applications from the WebLogic Integration 8.1 SP6 installation rather than the local staging directories, which may be outdated.

For example, if your domain contains an administration server named cgServer and two managed servers named new_managedServer_1 and new_managedServer_2, go to the directory that contains the domain and delete the directories (including the contents) named cgServer, new_managedServer_1, and new_managedServer_2.

Note: To learn more about domains, see "System Administration" in the WebLogic Server documentation at the following URL:

http://download.oracle.com/docs/cd/E13222_01/wls/docs81/admin.html

Manually Upgrading WebLogic Integration 8.1 SP4 or SP5 Databases to WebLogic Integration 8.1 SP6

If you suppressed the automatic upgrading of the databases when you upgraded the domain, you must upgrade the database manually before you can start the WebLogic Server 8.1 SP6 server. If you did not suppress the database upgrade during the domain upgrade process, you can skip this section.

The database schemas in WebLogic Integration 8.1 SP6 have changed from WebLogic Integration 8.1 SP5. To update your databases manually, you need to run the script for the databases that you use. Scripts are provided for Oracle^®, PointBase^®, Sybase^®, DB2^® and Microsoft^® SQL Server^TM databases.

To manually upgrade databases from WebLogic Integration 8.1 SP5 to WebLogic Integration 8.1 SP6, complete the following steps:

Note: If you are using the PointBase database, see Upgrading PointBase.

Locate the database upgrade scripts in the following directory:

On Windows:

BEA_HOME_816\weblogic81\integration\dbscripts\db_directory

On UNIX:

BEA_HOME_816/weblogic81/integration/dbscripts/db_directory

In the previous paragraphs, BEA_HOME_816 represents the directory in which you installed WebLogic Platform 8.1 SP5, and db_directory represents oracle, pointbase, sybase, db2, or mssql.

Execute the following database upgrade command and depending on values in the options.properties file, the respective upgrade scripts will be executed.

ant -f domain_upgrade.xml upgrade_dbs 

Note: Ensure the db_upgrade property is set to true in order to successfully execute the command.

Start the WebLogic Integration 8.1 SP6 server from the upgraded domain.

Upgrading PointBase

If you are using the PointBase database, you must upgrade it manually.

To manually upgrade the PointBase database from WebLogic Integration 8.1 SP4 or SP5 to WebLogic Integration 8.1 SP6, complete the following steps:

Start the PointBase server:
Open either a UNIX shell or a Windows command prompt window and navigate to the domain root for the domain you just upgraded.
Run the setdomainenv script.
Start the PointBase server:

On Windows:

WL_HOME\common\bin\startPointBase.cmd -port=9093 -debug=0 -console=false -background=true -ini=DOMAIN_HOME\pointbase.ini > DOMAIN_HOME/pointbase.log 2>&1

On UNIX:

WL_HOME/common/bin/startPointBase.sh -port=9093 -debug=0 -console=false -background=true -ini=DOMAIN_HOME\pointbase.ini > DOMAIN_HOME/pointbase.log 2>&1

In the preceding line, WL_HOME is the weblogic81 directory of the WebLogic Platform 8.1 SP6.

Note: This is a generic PointBase startup command. You may need to customize this command if you are not using the default directories.

To upgrade the database, execute the following command:

ant -f domain_upgrade.xml upgrade_dbs 

Note: Ensure the db_upgrade property is set to false in order to successfully execute the command.