6 Upgrading Oracle Service Bus Without Oracle SOA

This chapter describes the upgrade-specific tasks for upgrading Oracle Service Bus without Oracle SOA Suite and Business Process Management.

When upgrading Oracle Service Bus 11g (11.1.1.6 or 11.1.1.7) to Release 12c (12.1.3), you must perform the pre- and post-upgrade tasks described in this chapter. Failure to do so may result in a non-functioning post-upgrade environment.

• Section 6.1, "Understanding the Oracle Service Bus Upgrade to 12c"

• Section 6.2, "Upgrading Multiple Components that use UMS in a Single OSB Domain (Not Supported)"

• Section 6.3, "Performing Pre-Upgrade Tasks for Oracle Service Bus (OSB)"

• Section 6.4, "Migrating Resources from Previous Releases"

• Section 6.5, "Installing the Oracle Service Bus"

• Section 6.6, "Upgrading an OSB Domain (Without SOA)"

• Section 6.7, "Reconfiguring an OSB Domain"

• Section 6.8, "Upgrading the WebLogic Component Configurations"

• Section 6.9, "Performing Post-Upgrade Tasks for Oracle Service Bus"

6.1 Understanding the Oracle Service Bus Upgrade to 12c

Oracle Service Bus (OSB) can be upgraded to 12c (12.1.3) with or without Oracle SOA Suite and Business Process Management. The upgrade steps in this chapter describe how to upgrade Oracle Service Bus without SOA.

If OSB is part of your SOA 11g domain, and you will be upgrading OSB as part of your SOA Suite upgrade to 12c (12.1.3), follow the standard upgrade process described in Chapter 3, "Upgrading to SOA Suite and Business Process Management 12c (12.1.3)".

If you are upgrading Oracle Service Bus without SOA, use the upgrade procedures documented in this chapter. Note that even though your domain does not include SOA, you will still have to upgrade the _SOAINFRA schema to upgrade OSB data. OSB does not have a separate schema. See Creating Schemas for Oracle Service Bus.

Note:

Be sure to review all of the OSB-specific pre- and post-upgrade steps. All OSB upgrades (with and without SOA) require these additional steps when upgrading to 12c (12.1.3).

Description of the illustration fupss_upgrade_flowchart_osb.png

Step	Description	More Information
Perform all pre-upgrade tasks.	Perform the standard 12c pre-upgrade tasks as well as any OSB-specific tasks that apply to your deployment.	Section 2.1, "Performing General Pre-Upgrade Tasks" Section 6.3, "Performing Pre-Upgrade Tasks for Oracle Service Bus (OSB)"
Make sure that your Policy Store is database-based	This important pre-upgrade tasks must be completed before you upgrade Oracle Service Bus to 12c.	Section 2.1.14, "Reassociating a File-Based Policy Store Before Upgrade"
Upgrade the WebLogic server and JRF that will host your OSB domain.	You must install the 12c infrastructure and then upgrade the infrastructure domain before upgrading Oracle Service Bus.	Section 2.3, "Installing the 12c (12.1.3) Infrastructure Distributions Before Upgrade"
Install Oracle Service Bus.	Obtain the OSB distribution and install the content to a new Oracle Home.	Section 6.5, "Installing the Oracle Service Bus"
Upgrade Oracle Service Bus.	Follow the steps in this chapter to upgrade your existing Oracle Service Bus domain.	Section 6.6, "Upgrading an OSB Domain (Without SOA)"
Perform all post-upgrade tasks.	Perform the standard 12c post-upgrade tasks as well as any post-upgrade OSB-specific tasks that apply to your deployment.	Section 8.1, "Performing Post-Upgrade Tasks" Section 6.9, "Performing Post-Upgrade Tasks for Oracle Service Bus" Section A.7, "Troubleshooting Oracle Service Bus"

6.2 Upgrading Multiple Components that use UMS in a Single OSB Domain (Not Supported)

If your OSB 11g topology is configured with more than one component within a single domain, then you will not be able to upgrade to 12c (12.1.3).

Certain Fusion Middleware components such as Oracle SOA, OSB and Business Activity Monitoring (BAM) have a dependency on User Messaging Service (UMS) in 12c. If you configure more than one of these components within a single 12.1.3 domain, then each of these components must run within its own cluster — even if there is only one server that runs that component.

In order to upgrade these components, you must create a separate cluster for each component during the domain reconfiguration as described in "Clusters" in Creating WebLogic Domains Using the Configuration Wizard.

The supported upgrade topology for these components is described in Section 4.3, "Upgrading a Clustered Topology".

6.3 Performing Pre-Upgrade Tasks for Oracle Service Bus (OSB)

If you are upgrading Oracle Service Bus, you must perform the following tasks before you begin the upgrade. Review your own use case scenarios and existing deployment to determine if the following tasks apply to your environment.

1. Creating Schemas for Oracle Service Bus

2. Deploying Oracle Web Services Manager Policy Manager in Your 11g Environment

3. Exporting Services, Projects and Resources when Upgrading Oracle Service Bus

4. Deleting All Services, Projects and Resources

6.3.1 Creating Schemas for Oracle Service Bus

Oracle Service Bus does not have its own schema as all database schema data for Oracle Service Bus is incorporated in the SOAINFRA schema. So, while its possible to run Oracle Service Bus without running Oracle SOA, you must create the _SOAINFRA, _UMS and _STB schemas before you begin the upgrade.

For more information, see "Creating the Required Schemas with the Repository Creation Utility”.

6.3.2 Deploying Oracle Web Services Manager Policy Manager in Your 11g Environment

If Oracle Web Services Manager (OWSM) Policy Manager is not already deployed in your Oracle Service Bus 11g environment, then you must manually deploy it before you upgrade to 12c.

In 11g, both WebLogic security policies and OWSM policies were supported on Oracle Service Bus. As of 11g (11.1.1.7), WebLogic Security policies were deprecated, and are not supported in 12c (12.1.3). Because WebLogic security policies were available in 11g, deployment of the OWSM Policy Manager and use of the OWSM policies was optional. Since only OWSM policies are supported in 12c, OWSM Policy Manager deployment is mandatory.

For information on manually deploying the OWSM Policy Manager in your 11g environment, see "Installing OWSM with WebLogic Server" in Securing Web Services and Managing Policies with Oracle Web Services Manager.

6.3.3 Exporting Services, Projects and Resources when Upgrading Oracle Service Bus

You must export services, projects and resources into a configuration JAR file before you can upgrade to Oracle Service Bus 12.1.3. After the upgrade, you will import the JAR file to the new 12c environment.

Note that you can manually export resources and services from older, supported releases. See Migrating Resources from Previous Releases.

For more information, see "Importing and Exporting Resources and Configurations" in Developing Services with Oracle Service Bus.

6.3.4 Deleting All Services, Projects and Resources

After the export, you must delete all user-created services, projects and resources before the upgrade.

For information on using the Oracle Service Bus Console to delete resources, see ”How to Delete Projects, Folders, and Resources” in Developing Services with Oracle Service Bus.

For information on using JDeveloper to delete resources, see ”How to Delete a Project or Resource" in Developing Services with Oracle Service Bus.

6.4 Migrating Resources from Previous Releases

You can manually export resources and services from the following releases and use them with Oracle Service Bus 12c (12.1.3):

• Oracle Service Bus 11g Releases: 11.1.1.6.0, 1.1.1.5.0, 11.1.1.4.0, 11.1.1.1.3

• Oracle Service Bus 10.3 Releases: 10.3.1 and 10.3.0

• AquaLogic® Service Bus Releases 3.0 and later

For more information, see "Importing and Exporting Resources and Configurations" in Developing Services with Oracle Service Bus.

6.5 Installing the Oracle Service Bus

To install Oracle Service Bus, refer to Installing and Configuring Oracle Service Bus.

You can install and upgrade Oracle Service Bus without Oracle SOA Suite and Business Process Management, but you must still install the Oracle Fusion Middleware Infrastructure 12c (12.1.3) before upgrading Oracle Service Bus. For more information, see Installing and Configuring the Oracle Fusion Middleware Infrastructure.

Note:

If you want to use Oracle Web Services Manager policies with Oracle Service Bus, you must select the Oracle Web Services Manager extension template after selecting one of the Oracle Service Bus domain templates when configuring the Oracle WebLogic domain.

6.6 Upgrading an OSB Domain (Without SOA)

To upgrade Oracle Service Bus, you will follow the basic procedures described in Table 6-1.

Table 6-1 Upgrade Assistant Screens: Upgrading Schemas

Screen	Description and Action Required
Welcome	This screen provides an overview of the Upgrade Assistant and some information about important pre-upgrade tasks.
Schemas	Select Schemas. NOTE: There is no OSB schema. All database schema data for Oracle Service Bus is incorporated in the SOAINFRA schema.
Available Components	This screen provides a list of installed Oracle Fusion Middleware components that have schemas that can be upgraded. When you select a component, the schemas and any dependencies are automatically selected. When upgrading OSB, select Metadata Services, Audit Services and Oracle Platform Security Services. Description of the illustration 1213_ua_avail_comp_osb_crop.png
Domain Directory	This screen appears if you selected Oracle Platform Security Services or Oracle Audit Services on the Available Components screen. Enter the absolute path to the existing WebLogic domain directory, or click Browse to navigate to and select the 11g domain directory you are upgrading.
Prerequisites	Check that the prerequisites for schema upgrade are met. You must select each prerequisite before you click Next. CAUTION: Upgrade Assistant will NOT verify that these prerequisites have been met.
Schema Credentials	Use this screen to enter database connection details for each of the schemas you are upgrading.
Examine	Review the status of the Upgrade Assistant as it examines each component, verifying that the component is ready for upgrade. Verify that the Source Version displayed for each schema is listing the correct version number for the schema to be upgraded.
Upgrade Summary	Review the summary of the options that you have selected for schema upgrade. Verify that the correct Source and Target versions are listed for each schema you intend to upgrade. Click Upgrade to upgrade the schemas, or click Back if you wish to change the configurations.
Upgrade Progress	Review the status of the current upgrade process. NOTE: The progress bar on this screen displays the progress of the current upgrade procedure. It does not indicate the time remaining for the upgrade. Click Next when the upgrade is complete.
Upgrade Success	Click Close if the Upgrade was successful. If the upgrade failed or if you canceled the upgrade before it completed successfully, you should review the log files, restore the backed up environment, and restart the Upgrade Assistant.

6.7 Reconfiguring an OSB Domain

After the schema upgrade, you must reconfigure the 11g OSB domain using the Oracle Reconfiguration Wizard. This process is identical to the SOA domain reconfiguration procedures described in Reconfiguring the Domain Using the Reconfiguration Wizard.

6.8 Upgrading the WebLogic Component Configurations

You will run the Upgrade Assistant a second time, after the domain reconfiguration, to upgrade any component configurations in the 11g OSB domain.

This process is described in Upgrading the Domain Component Configurations Using the Upgrade Assistant.

6.9 Performing Post-Upgrade Tasks for Oracle Service Bus

After a successful upgrade, you may need to perform one or more of the following tasks. Review your own use case scenarios and existing deployment to determine if the following tasks apply to your environment.

Note:

If you upgraded a clustered OSB topology, you must complete the post-upgrade tasks described in Section 4.5, "Performing Post-Upgrade Tasks for Clusters".

• Configuring Oracle HTTP Server for the WLS_OSB Managed Servers

• Importing Domain Configuration Data

• Importing Security Configurations

• Upgrading Your XQuery Resources

• Managing Oracle Service Bus Console Users in Enterprise Manager

• Understanding 12c Split-Joins

Note:

If you experience any post-upgrade issues with Oracle Service Bus, refer to Section A.7, "Troubleshooting Oracle Service Bus" for a list of common solutions.

6.9.1 Configuring Oracle HTTP Server for the WLS_OSB Managed Servers

To enable Oracle HTTP Server to route to Oracle Service Bus console and Oracle Service Bus service, set the WebLogicCluster parameter to the list of nodes in the cluster.

For more information, see "Configuring Oracle HTTP Server for the Oracle Service Bus" in the Enterprise Deployment Guide for Oracle SOA Suite.

6.9.2 Importing Domain Configuration Data

After the upgrade you will need to import the domain configuration data that you exported in "Exporting Services, Projects and Resources when Upgrading Oracle Service Bus".

For more information, see "How to Import Resources from a Configuration JAR File in the Console" in Developing Services with Oracle Service Bus and ”Executing a Configuration File” in Administering Oracle Service Bus.

6.9.3 Importing Security Configurations

Use the Oracle WebLogic Administration Console to import the security data that you exported pre-upgrade into the new Oracle Service Bus domain.

For more information, see the "Import data into a security provider" section of the Oracle WebLogic Server Administration Console Online Help.

Note:

You must import the security information for each security provider separately.

6.9.4 Upgrading Your XQuery Resources

Oracle Service Bus supports XQuery 1.0. The older XQuery 2004 is also supported. Any new XQuery resource created in Service Bus uses the XQuery 1.0 version, by default.

If you have upgraded from a pre-12c Service Bus project, all XQuery resources in the project are configured to use the XQuery 2004 version.

For more information on upgrading XQuery Resources, see "How to Upgrade Your XQuery Resources to use XQuery 1.0" in Developing Services with Oracle Service Bus.

6.9.5 Managing Oracle Service Bus Console Users in Enterprise Manager

In Oracle Service Bus 11g, Oracle Service Bus Console user roles were managed only through the WebLogic Console. In 12c, there are Oracle Service Bus Console application roles that must be managed through Oracle Enterprise Manager Console.

To add users/groups to the roles in the Enterprise Manager console:

1. Right click the domain in Enterprise Manager and select Application Roles

2. Select the OSB Console application and click the arrow icon to get the list of roles.

3. Add Users / Groups to the roles as appropriate.

6.9.6 Understanding 12c Split-Joins

The 11g split-join business service will no longer exist in 12c because in 12c there is a direct way to invoke a split-join component from a pipeline or a proxy service. The upgrade process will automatically change all statically configured invoke references to a split-join business service as follows:

• The flow business service is removed. This means the Timeout property configured for the Flow business service is also removed.

• If the business service is located in the same project as the proxy service that invokes it, then the pipeline associated with that proxy service invokes the split-join directly.

• If the business service is located in a different project from the proxy service that invokes it, then a local proxy service is created to invoke the split-join. The local proxy service is invoked by the original proxy service.