6 Upgrading WebLogic Server 9.x or 10.x Application Environments to 12.1.1

The following sections describe the procedures for upgrading application environments from WebLogic Server 9.x or 10.x to the WebLogic Server 12.1.1 release:

Creating a New Domain

This option is useful if the process of creating and customizing a domain has been automated. To create a new domain:

  1. Install WebLogic Server 12.1.1 software.

  2. To create your domain in 12.1.1, use a default domain template provided in 12.1.1. Alternatively, if you used a custom 9.x template to create your domain in 9.x, use the same to create a new 12.1.1 domain.

    This step can be accomplished using the Configuration Wizard or using automated scripts, built using WebLogic scripting tools such as WLST. The Configuration Wizard is described in Creating Domains Using the Configuration Wizard, and WLST is described in Oracle WebLogic Scripting Tool.

    It might be necessary for you to update your automated scripts, for example, to reference the 12.1.1 domain template or to implement new features provided in the 12.1.1 release.

    For example, starting in WebLogic 9.1, the default security providers are XACML-based, as described in "Understanding WebLogic Server Security" in Understanding Oracle WebLogic Server. You may choose to add support for the security providers prior to WebLogic 9.1 or make the appropriate changes to use the new XACML-based security providers.

  3. Deploy existing WebLogic Server 9.x applications to the new 12.1.1 domain.


    If you used a custom 9.x template in step 2, the 9.x applications may already be deployed.

Updating an Existing Domain

Updating an existing domain is useful for maintaining customizations within your test domain if generation of the domain has not been automated. There are two options for upgrading an existing domain, as follows:

  • Option One: Manual Update

    1. Install WebLogic Server 12.1.1 software.

    2. Back up the existing application environment, including the domain directory, application and application data that is external to the domain, and log files (if necessary).

    3. Update the script files in the domain to point to the installation of WebLogic Server 12.1.1. For example, set MW_HOME, MW_HOME, BEA_HOME, BEA_JAVA_HOME, JAVA_HOME, and WL_HOME to the appropriate values.

    4. Update the CLASSPATH to remove path information that is no longer required, such as patch file information that applies to a pre-12.1.1 release.

  • Option two: Automated Update

    Use the Domain Upgrade Wizard, as described in Chapter 5, "Upgrading a WebLogic Domain."

Upgrading Beehive Applications

If you developed Beehive applications in 9.0, 9.1 or 9.2, you must upgrade the applications as described in "Upgrade Paths" in Beehive Integration in BEA WebLogic Server, available at http://download.oracle.com/docs/cd/E13222_01/wls/docs100/beehive/introduction.html#upgrade.


Use of Apache Beehive as the WebLogic Platform application framework is deprecated in this release. Oracle recommends that you use ADF, which offers a rich application framework and is the Oracle standard.