1 Preparing for the Oracle Fusion Middleware Infrastructure Upgrade

This chapter provides a summary of the steps you should perform to prepare for an upgrade.

This chapter includes the following sections:

Section 1.1, "Understanding the Starting Points for an Infrastructure Upgrade"
Section 1.2, "Understanding the Standard Upgrade Topologies"
Section 1.3, "Understanding the Additional New Features for Oracle Fusion Middleware 12c"
Section 1.4, "Flow Chart and Task Roadmaps for Upgrading to Oracle Fusion Middleware Infrastructure"
Section 1.5, "About Upgrading Oracle HTTP Server"
Section 1.6, "Upgrading Custom Applications Using Oracle JDeveloper 12c"

1.1 Understanding the Starting Points for an Infrastructure Upgrade

You can upgrade to Oracle Fusion Middleware Infrastructure 12c (12.1.2) from the following supported starting points:

Oracle Fusion Middleware Application Developer 11g (11.1.1.6)
Oracle Fusion Middleware Application Developer 11g (11.1.1.7)

The upgrade procedures in this guide explain how to upgrade an existing Application Server 11g domain and the Oracle Fusion Middleware component configurations in that domain to Oracle Fusion Middleware Infrastructure 12.1.2.

Note:

This guide also provides instructions for upgrading Oracle HTTP Server instances that were installed and configured to be associated with an existing Application Developer 11g domain.

For information about upgrading standalone Oracle HTTP Server 11g, see Oracle Fusion Middleware Upgrading a Standalone Oracle HTTP Server.

For more information, see the following topics:

About the Application Developer 11g Installer
About Oracle Fusion Middleware Infrastructure 12c
Key Differences Between Application Developer 11g and Infrastructure 12c

1.1.1 About the Application Developer 11g Installer

The Oracle Fusion Middleware 11g Application Developer installer provides the software technologies and components to configure a Oracle WebLogic Server domain for the deployment of Oracle ADF applications. These technologies and components are often referred to as Oracle JRF.

To configure such a domain, you do the following:

Use the Oracle WebLogic Server 10.3.5 or 10.3.6 installer to create a new Oracle Fusion Middleware 11g Middleware home.
Install the Application Developer 11g software into that same Middleware home; this creates a new Oracle common directory inside that Middleware home.
You use the Configuration Wizard in that Middleware home to configure an Application Developer domain, consisting of one or more managed servers, which you can use to deploy your Oracle ADF applications.

For more information about the Oracle Fusion Middleware 11g Application Developer installer, see the Oracle Fusion Middleware Installation Guide for Application Developer in the Oracle Fusion Middleware 11g (11.1.1.7) documentation library on the Oracle Technology Network.

1.1.2 About Oracle Fusion Middleware Infrastructure 12c

Oracle Fusion Middleware Infrastructure distribution, which is available as part of the Oracle Fusion Middleware 12c (12.1.2) release, provides a set of technologies and components similar to those provided by the Oracle WebLogic Server and Application Developer installers in 11g.

For more information about Oracle Fusion Middleware Infrastructure, see "About Oracle Application Server Infrastructure 12c (12.1.2)" in Understanding Interoperability and Compatibility.

1.1.3 Key Differences Between Application Developer 11g and Infrastructure 12c

Oracle Fusion Middleware Infrastructure 12c is similar to the 11g Application Developer installation, except for the following differences:

Infrastructure 12c Includes Oracle WebLogic Server
Infrastructure 12c Requires Specific Database Schemas
Infrastructure 12c Domains Can Include Oracle HTTP Server

1.1.3.1 Infrastructure 12c Includes Oracle WebLogic Server

The Application Developer 11g installation required two separate installations (Oracle WebLogic Server and then Application Developer to add the Oracle JRF libraries and components). In Oracle Fusion Middleware 12c, a fresh installation requires only the Oracle Fusion Middleware Infrastructure distribution, which contains both Oracle WebLogic Server and the required Java Required Files technologies.

Note that the upgrade procedure does not require the configuration of a new Oracle Fusion Middleware 12c domain. Instead, you use the Reconfiguration Wizard to upgrade the domain. For more information, see "Understanding and Obtaining the Upgrade and Configuration Tools" in Planning an Upgrade of Oracle Fusion Middleware.

1.1.3.2 Infrastructure 12c Requires Specific Database Schemas

Unlike the Application Developer 11g installation, the Infrastructure 12c installation requires that you create a set of required schemas in a supported database. In particular, you must use the 12c Repository Creation Utility (RCU) to create at least one required database schema before you can configure the Oracle Fusion Middleware Infrastructure 12c (12.1.2) software.

Depending upon your requirements, you must install one or more of the following database schemas before you can upgrade to Oracle Fusion Middleware Infrastructure 12c (12.1.2):

The Service Table (STB) schema, which is a new schema required for all Oracle Fusion Middleware Infrastructure 12c installations. This schema enables a new Oracle Fusion Middleware 12c feature called Cross-Component Wiring. For more information, see "Cross-Component Wiring" in Administering Oracle Fusion Middleware. You must install this schema before upgrading to 12c (12.1.2).

The OPSS schema, which provides a database-based security store for Oracle Platform Security Services.

You might be required to create the OPSS 12c (12.1.2) schema, depending upon whether or not you are using a security store in 11g and the type of security you are using. For more information, see Table 1-1.

Table 1-1 Overview of Upgrading the Oracle Fusion Middleware 11g Security Store

If you are using...	Then perform the following action:	More Information
File- based security store in 11g	Before upgrade: Use the 11g Repository Creation Utility to create the 11g OPSS Reassociate the file-based security store with the database security store. During upgrade, use the Oracle Fusion Middleware 12c Upgrade Assistant to upgrade the OPSS schema to 12c (12.1.2).	Section 2.3, "Reassociating a File-Based Security Store Before Upgrade"
Oracle Internet Directory (OID)-based security store in 11g	During the upgrade, use the 12c Repository Creation Utility to create the new 12c OPSS schema. In the Upgrade Assistant, select the OPSS schema; the Upgrade Assistant upgrades the OID-based security store. Note that the 12c OPSS database schema is required only so you can reference the 12c schema during the reconfiguration of the domain. Your domain will continue to use the OID-based security store after the upgrade.	Section 2.8, "Creating the Required 12.1.2 Schemas Before You Upgrade" Section 2.9, "Upgrading 11g Schemas Using the Upgrade Assistant" Section 2.10, "Reconfiguring the Domain Using the Reconfiguration Wizard"
Database-based security store and the OPSS schema	Use the Upgrade Assistant to upgrade the existing 11g OPSS schema, and then reference the upgraded 11g schema during the domain reconfiguration.	Section 2.9, "Upgrading 11g Schemas Using the Upgrade Assistant" Section 2.10, "Reconfiguring the Domain Using the Reconfiguration Wizard"

If you are using...

Then perform the following action:

More Information

File- based security store in 11g

Before upgrade:

Use the 11g Repository Creation Utility to create the 11g OPSS
Reassociate the file-based security store with the database security store.

During upgrade, use the Oracle Fusion Middleware 12c Upgrade Assistant to upgrade the OPSS schema to 12c (12.1.2).

Section 2.3, "Reassociating a File-Based Security Store Before Upgrade"

Oracle Internet Directory (OID)-based security store in 11g

During the upgrade, use the 12c Repository Creation Utility to create the new 12c OPSS schema.
In the Upgrade Assistant, select the OPSS schema; the Upgrade Assistant upgrades the OID-based security store.
Note that the 12c OPSS database schema is required only so you can reference the 12c schema during the reconfiguration of the domain. Your domain will continue to use the OID-based security store after the upgrade.

Database-based security store and the OPSS schema

Use the Upgrade Assistant to upgrade the existing 11g OPSS schema, and then reference the upgraded 11g schema during the domain reconfiguration.

The IAU schema, which is used for the OPSS auditing capabilities.

You might be required to create the IAU 12c (12.1.2) schema, depending up whether or not you are using an Audit Data Store in 11g and the type of Audit Data Store you are using. For more information, see Table 1-2.

Table 1-2 Overview of Upgrading the Oracle Fusion Middleware 11g Audit Store

If you are using...	Then perform the following action:	More Information
File- based audit store in 11g	During the upgrade, create a new 12c IAU schema. After the upgrade, configure the Oracle Platform Security Services Audit service to use the database-based Audit Data Store.	Section 2.8, "Creating the Required 12.1.2 Schemas Before You Upgrade" Section 3.4, "Configuring an Oracle Fusion Middleware 12c Audit Data Store"
Database-based audit store and the IAU 11g schema	Use the Upgrade Assistant to upgrade the existing 11g IAU schema, and then reference the upgraded 11g schema during the domain reconfiguration.	Section 2.9, "Upgrading 11g Schemas Using the Upgrade Assistant" Section 2.10, "Reconfiguring the Domain Using the Reconfiguration Wizard"

1.1.3.3 Infrastructure 12c Domains Can Include Oracle HTTP Server

In Oracle Fusion Middleware 11g, Oracle HTTP Server instances are typically configured in a separate Oracle instance directory outside the 11g Middleware home. Oracle HTTP Server 11g instances are managed using the Oracle Process Manager and Notification Server (OPMN) management software. Optionally, the Oracle HTTP Server 11g instances can be "associated with" the WebLogic domain.

In Oracle Fusion Middleware 12c, Oracle HTTP Server instances can be configured a part of an Oracle WebLogic Server domain, using the Oracle Fusion Middleware Configuration Wizard. When configured as part of an Oracle Fusion Middleware Infrastructure domain, Oracle HTTP Server instances can be managed using Oracle Enterprise Manager Fusion Middleware Control and the Oracle Weblogic Scripting Tool (WLST). In Oracle Fusion Middleware 12c, the Node Manager agent is responsible for delegating and executing management requests to OHS instances"

For more information about the changes to the ways system components, such as Oracle HTTP Server, are configured and managed in Oracle Fusion Middleware 12c, as well as other key changes for Oracle Fusion Middleware 12c, see Section 1.3.

1.2 Understanding the Standard Upgrade Topologies

Using the Oracle Fusion Middleware Application Developer 11g software, you can create a variety of production topologies to suit the needs of your applications, your organization, and your application users.

As a result, it is difficult to provide exact upgrade instructions for every possible Application Developer 11g installation. To solve this problem, this upgrade documentation provides detailed instructions for upgrading two typical Application Developer configurations. These typical topologies are referred to as the Oracle Fusion Middleware 12c standard upgrade topologies.

Specifically, for the purposes of this guide, it is assumed that you have used Oracle WebLogic Server and the Application Developer 11g software to configure a domain that contains a cluster of two managed servers, both of which are configured to support Oracle JRF and the deployment of Oracle ADF applications.

Your actual topology may vary, but the topologies described here provide an example that can be used as a guide to upgrade other similar Application Developer topologies.

This guide explains step-by-step how to upgrade two specific upgrade topologies:

Fusion Middleware Infrastructure Standard Upgrade Topology
Fusion Middleware Infrastructure Standard Upgrade Topology with Oracle HTTP Server

1.2.1 Fusion Middleware Infrastructure Standard Upgrade Topology

Figure 1-1 shows the Oracle Fusion Middleware 11g Application Developer standard upgrade topology and the resulting Oracle Fusion Middleware 12c Infrastructure topology as it appears after you complete the upgrade procedures in this guide.

Figure 1-1 Infrastructure Upgrade Topology

Description of "Figure 1-1 Infrastructure Upgrade Topology"

All elements in this topology illustration are described in Table 1-3.

Table 1-3 Description of the Elements in the Infrastructure Standard Upgrade Topology

Element	Description and Links to Additional Documentation
11g Application Developer Topology	This is the label for the left side of Figure 1-1. It shows a typical single-host topology created using the Oracle Fusion Middleware 11g Application Developer installer. It consists of a single domain that contains a cluster of two managed servers and the Administration Server. It also has an optional file-based store or database with schemas. This document describes, step-by-step, how to upgrade this topology to an equivalent topology created using the Oracle Fusion Middleware 12c Infrastructure distribution.
12c Infrastructure Standard Installation Topology	This is the label for the right side of the figure. It shows a typical single-host topology created using the Oracle Fusion Middleware 12c Infrastructure distribution. Like the Application Developer 11g topology, it also consists of a single domain that contains a cluster of two managed servers and the Administration Server.
APPHOST	Standard term used in Oracle documentation referring to the machine that is hosting the application tier.
DBHOST	Standard term used in Oracle documentation referring to the machine that is hosting the database. Note that for Application Developer 11g, a database was optional; for Oracle Fusion Middleware Infrastructure 12c, a database is required. For more information, see Section 1.1.3.2.
File-Based Store	An XML, file-based security store. In 11g, you could use a file-base security store or a database-based security store. However, in 12c, the file-based store is deprecated, and you must use the Oracle Platform Security Services (OPSS) schema in a supported database.
Database with Schemas	Represents a supported database, where the Oracle Fusion Middleware schemas have been created using the Repository Creation Utility.
WebLogic Domain	A logically related group of Java components (in this case, the administration Server, Managed Servers, and other related software components). For more information, see "What is an Oracle WebLogic Server Domain" in Understanding Oracle Fusion Middleware.
Administration Server	The central control entity of a domain which maintains the domain's configuration objects and distributes configuration changes to Managed Servers. For more information, see "What is the Administration Server" in Understanding Oracle Fusion Middleware.
Enterprise Manager	Oracle Enterprise Manager Fusion Middleware Control. This is the main tool that can be used to manage your domain. For more information, see "Oracle Enterprise Manager Fusion Middleware Control" in Understanding Oracle Fusion Middleware.
Cluster	A collection of multiple WebLogic Server instances running simultaneously and working together. For more information, see "Understanding Managed Servers and Managed Server Clusters" in Understanding Oracle Fusion Middleware.
Machine	Logical representation of the computer that hosts one or more WebLogic Server instances (servers). Machines are also the logical glue between WebLogic Managed Servers and the Node Manager; in order to start or stop a Managed Server with Node Manager, the Managed Server must be associated with a machine.
Managed Server	Host for your applications, application components, Web services, and their associated resources. For more information, see "Understanding Managed Servers and Managed Server Clusters" in Understanding Oracle Fusion Middleware.
Oracle JRF	Oracle JRF (Java Required Files) consists of those components not included in the Oracle WebLogic Server installation and that provide common functionality for Oracle business applications and application frameworks. JRF consists of several independently developed libraries and applications that are deployed into a common location. The components that are considered part of Java Required Files include Oracle Application Development Framework shared libraries and ODL logging handlers.
Infrastructure	Oracle Fusion Middleware 12c term (similar to Oracle JRF) that refers to the collection of services that include the following: Metadata repository (MDS) This contains metadata for Oracle Fusion Middleware components, such as the Oracle Application Developer Framework. For more information, see "What is the Metadata Repository" in Understanding Oracle Fusion Middleware. Oracle Application Developer Framework (ADF) Oracle Web Services Manager (OWSM)

The Application Developer 11g topology is similar to the Oracle Fusion Middleware Infrastructure 12c topology, except for the differences described in Section 1.1.3, "Key Differences Between Application Developer 11g and Infrastructure 12c".

1.2.2 Fusion Middleware Infrastructure Standard Upgrade Topology with Oracle HTTP Server

Figure 1-2 shows the Oracle Fusion Middleware 11g Application Developer standard upgrade topology with Oracle HTTP Server and the resulting Oracle Fusion Middleware 12c Infrastructure topology as it appears after you complete the upgrade procedures in this guide.

Figure 1-2 Infrastructure Standard Upgrade Topology with Oracle HTTP Server

Description of "Figure 1-2 Infrastructure Standard Upgrade Topology with Oracle HTTP Server"

Most of the elements in this topology illustration are described in Table 1-3.

Additional elements and those different from Figure 1-1 are described in Table 1-4.

Table 1-4 Description of the Elements in the Infrastructure Standard Upgrade Topology with Oracle HTTP Server

Element	Description and Links to Additional Documentation
11g Application Developer Topology with Oracle HTTP Server	This is the label for the left side of Figure 1-2. It shows a typical single-host topology created using the Oracle Fusion Middleware 11g Application Developer installer. It consists of a single domain that contains a cluster of two managed servers and the Administration Server. It also has an optional file-based store or database with schemas. Figure 1-2 also shows an Oracle HTTP Server instance as part of the 11g domain. This document describes, step-by-step, how to upgrade this topology to an equivalent topology created using the Oracle Fusion Middleware 12c Infrastructure distribution.
12c Infrastructure Standard Installation Topology with Oracle HTTP Server	This is the label for the right side of the figure. It shows a typical single-host topology created using the Oracle Fusion Middleware 12c Infrastructure distribution. Like the Application Developer 11g topology, it also consists of a single domain that contains a cluster of two managed servers and the Administration Server. Figure 1-2 also shows an Oracle HTTP Server instance as part of the 12c domain.
Oracle HTTP Server "associated with the domain"	An Oracle HTTP Server 11g instance that has been configured to be "associated with" the Oracle WebLogic Server domain. In Oracle Fusion Middleware 11g, system component instance, such as Oracle HTTP Server, are configured with an Oracle Universal Installer-based configuration wizard and are managed using Oracle Process Manager and Notification Server.
Oracle HTTP Server	Unlike the Oracle HTTP Server 11g instance in the left side of the diagram, the Oracle HTTP Server 12c instance shown in the 12c topology is configured as part of the domain using the Oracle Fusion Middleware Configuration Wizard. It is managed using Oracle Enterprise Manager Fusion Middleware Control, the Oracle Weblogic Scripting Tool (WLST), and the Oracle WebLogic Server Node Manager software.

Note that there are changes to way Oracle HTTP Server instances are created and managed in an Oracle Fusion Middleware 12c Oracle WebLogic Server domain. For more information, see Section 1.1.3.3, "Infrastructure 12c Domains Can Include Oracle HTTP Server".

1.3 Understanding the Additional New Features for Oracle Fusion Middleware 12c

Before you begin the upgrade to Oracle Fusion Middleware Infrastructure 12c, review the new features and changes available in Oracle Fusion Middleware 12c. In particular, refer to the following sections in Understanding Oracle Fusion Middleware:

1.4 Flow Chart and Task Roadmaps for Upgrading to Oracle Fusion Middleware Infrastructure

The following sections describe the high-level steps for upgrading the Oracle Fusion Middleware standard upgrade topology:

Flow Chart for Upgrading the Infrastructure Standard Upgrade Topologies
Task Roadmap for Upgrading the Infrastructure Standard Upgrade Topologies

1.4.1 Flow Chart for Upgrading the Infrastructure Standard Upgrade Topologies

Figure 1-3 shows the high level procedures associated with the standard Infrastructure upgrade.

Figure 1-3 Flow Chart of the Infrastructure Upgrade Steps

Description of "Figure 1-3 Flow Chart of the Infrastructure Upgrade Steps"

1.4.2 Task Roadmap for Upgrading the Infrastructure Standard Upgrade Topologies

Table 1-5 describes the tasks that must be completed to upgrade to Infrastructure 12.1.2.

Table 1-5 Oracle Fusion Middleware Infrastructure Upgrade Roadmap

Task	Description	More Information
Review the new 12c concepts and perform common upgrade tasks.	Before planning your upgrade, you must review the 12c concepts, and common upgrade tasks.	Planning an Upgrade of Oracle Fusion Middleware Section 1.1, "Understanding the Starting Points for an Infrastructure Upgrade" Section 1.2, "Understanding the Standard Upgrade Topologies".
Execute a compete backup of your existing 11g environment.	The backup is important because the upgrade process will reconfigure your existing domain directories.	Section 2.1, "Backing Up Your Existing Oracle Fusion Middleware 11g Environment"
File-based security store?	If you are using a file-based security or audit store in your existing 11g environment, then you must perform an important-pre-upgrade task.	Section 2.3, "Reassociating a File-Based Security Store Before Upgrade".
Run the 11g Repository Creation Utility to Create 11g OPSS and IAU Schemas	This step is required only if you are using a file-based security store in your 11g Application Developer environment.	Section 2.3, "Reassociating a File-Based Security Store Before Upgrade".
Reassociate the 11g file-based security store with the 11g Database-based repository	This step is required only if you are using a file-based security store or audit store in your 11g Application Developer environment.	Section 2.3, "Reassociating a File-Based Security Store Before Upgrade".
Install Infrastructure 12.1.2 in a new Oracle Home.	Install Oracle Fusion Middleware Infrastructure 12c in a new Oracle Home on the host where you installed Oracle Fusion Middleware Application Developer 11g. If the 11g environment includes Oracle HTTP Server instances that are associated with the domain, then Install Oracle HTTP Server 12c in the same Oracle home as the Infrastructure.	Section 2.4, "Installing Oracle Fusion Middleware Infrastructure 12.1.2 on APPHOST". Section 2.5, "Installing Oracle HTTP Server 12.1.2 on APPHOST".
Shut down the 11g environment.	Stop the Administration Server and all the Managed Servers.	Section 2.6, "Stopping Servers and Processes".
Run Repository Creation Utility to create the 12c schemas.	Unlike Oracle Fusion Middleware 11g, you cannot configure an Oracle Fusion Middleware 12c domain without installing the required schemas in a supported database.	Section 2.8, "Creating the Required 12.1.2 Schemas Before You Upgrade".
Run the Upgrade Assistant to upgrade the database schemas.	Run the Upgrade Assistant to upgrade your existing 11g schemas to 12c.	Section 2.9, "Upgrading 11g Schemas Using the Upgrade Assistant".
Run the Reconfiguration Wizard to reconfigure the 11g domain.	After upgrading the 11g schemas, you must run the Reconfiguration Wizard to reconfigure your existing 11g domain.	Section 2.10, "Reconfiguring the Domain Using the Reconfiguration Wizard".
Start the Administration Server.	After you reconfigure the 11g domain, you must start the Administration Server.	Section 2.11, "Starting the Administration Server".
Run the Upgrade Assistant to upgrade domain configurations.	Use the Upgrade Assistant to upgrade any WebLogic component configurations.	Section 2.12, "Upgrading the Domain Component Configurations Using the Upgrade Assistant".
Restart Administration Server.	Restart the Administration Server.	Section 3.2, "Restarting the Administration Server".
Configure and start the Node Manager.	Configure the Node Manager, and start it.	Section 3.1, "Configuring and Starting the Node Manager".
Perform the required post-upgrade tasks.	Perform the required post-upgrade tasks like verifying the upgrade and deployed applications.	Section 3.3, "Applying JRF Template to Managed Servers" Section 3.6.2.3, "About Migrating Asynchronous Web Services with Oracle JDeveloper 12c".
Verify the upgrade was successful.	Verify that the upgrade was successful by logging in to the Administration console and Fusion Middleware Control, and verifying the upgraded version number.	See Section 2.14, "Verifying the Domain Component Configurations Upgrade"

1.5 About Upgrading Oracle HTTP Server

This guide explains how to upgrade Oracle HTTP Server 11g instances that have been configured so they are "associated with" an Oracle WebLogic Server domain. The upgrade is performed as you are upgrading the domain to which the Oracle HTTP Server has been associated.

To upgrade a standalone Oracle HTTP Server instance (one that is not associated with an 11g domain) refer to Upgrading a Standalone Oracle HTTP Server.

1.6 Upgrading Custom Applications Using Oracle JDeveloper 12c

If you have deployed custom applications to an Oracle Fusion Middleware Application Developer 11g domain, then the application deployments should function as they did in Oracle Fusion Middleware 11g after the upgrade procedure is complete.

However, if you want to take advantage of new Oracle Application Development Framework (Oracle ADF) 12c (12.1.2) features, download and install Oracle JDeveloper 12c (12.1.2). For more information, see Installing Oracle JDeveloper.

To test your 11g applications in preparation for an upgrade to Oracle Fusion Middleware Infrastructure 12c, open your existing Oracle JDeveloper 11g projects in Oracle JDeveloper 12c (12.1.2). Oracle JDeveloper migrates the projects to 12c (12.1.2). You can then test your applications with the embedded application server that is available from within Oracle JDeveloper. After you have reviewed and optionally modified your applications in Oracle JDeveloper 12c (12.1.2), upgrade the Application Developer 11g domain to Oracle Fusion Middleware Infrastructure 12c (12.1.2) and redeploy the applications.

For more information about migrating your applications, see "Migrating From a Previous Version to Oracle JDeveloper 12.1.2" in Installing Oracle JDeveloper.