migrating oracle service-oriented architectures(soa) suite

White Paper

Migrating Oracle Service-Oriented Architectures(SOA) Suite 10G to 11G

copy2022 Jade Global Inc All rights reserved

Manoj Machiwal Jade Global Inc

Abstract

Executive Summary

Background

High Level Upgrade Steps

Setting up SOA suite 11g Environment

Testing Considerations

Common Deployment Issues

Best Practices

References

1

2

3

5

7

13

15

16

16

Table of Contents

White Paper

Abstract


In This white paper you will learn how to plan and execute a successful SOA 10g to SOA 11g Migration You will also learn commonly faced challenges Risks for such project

and how to overcome and mitigate the risks In the end there will be some tips and tricks will be shared for execution along with a customer case study

1

This whitepaper concentrates on the individuals who are experienced on the development or administrator with Oracle SOA suite 10g and 11g

TARGET AUDIENCE

bull Oracle SOA Architects

bull Oracle SOA Developers

bull Oracle SOA Suite Administrators

White Paper

Executive Summary

copy2022 Jade Global Inc All rights reserved2

There have been significant changes between SOA 10g and 11g Environment In this white paper we will brief the differences between 10g and 11g environments and

highlight the best practices for such migration along with a customer case study In Brief we will explain about the following topics as below

bull SOA Suite 10g and 11g Architecture Comparison

bull High-Level Upgrade Steps

bull Setting Up SOA Suite 11g Environment

bull Oracle BPELESB Projects Migration

bull BPEL Instance migration

bull Oracle BAM Migration

bull Case Study amp Lessons Learnt

bull Common Deployment Issues and Best Practices

White Paper

Background


There has been significant changes happened between

SOA suite 10g and 11g below table summarizes the

diffeences between 10g and 11g environment These

changes should be well studied and considered while

migrating applications from 10g to 11g environments

3

SOA Suite 10g and 11g Architecture Comparison

White Paper


Below diagram shows the pictorial representaion of archictechure difference between soa 10g and 11g environments

White Paper



bull Review Concepts in the Oracle Fusion Middleware Upgrade

Planning Guide

bull Review the Starting Points and Topologies for 11g

bull Prepare a Database for the SOA and WebCenter Schemas

bull Consider a strategy for BPEL Long-Running Processes

bull Install the 11g SOA WebCenter or ADF and create the

Middleware home

bull Use the Upgrade Assistant to Upgrade the SOA Schemas

bull Perform Any WebLogic Server Configuration Tasks to Support

Your Applications

bull Perform Any Manual SOA or WebCenter Configuration Tasks

bull Install and Configure an 11g Web Tier

bull Use the Upgrade Assistant to Upgrade the Web Tier Components

bull Install and Configure Oracle JDeveloper 11g

bull Open and Migrate Your Applications with Oracle JDeveloper

Release 11g

bull Recompile the Application Projects

bull Implement any other code changes required for the application

to run successfully on Oracle Fusion Middleware 11g

bull Redeploy Your Applications on Oracle Fusion Middleware 11g

bull Verify the Redeployed Applications

White Paper


Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration

White Paper



Selecting the Schemas Required for a Oracle SOA Suite Upgrade

Below are some high level steps for setting up SOA suite 11g environment

bull SOA Suite Topology

Before we can begin the upgrade process we need to decide upon a new topology for new fusion middleware 11g environment

bull Upgrade the Repository Database

We have to ensure that database which is hosting SOA suite schemas are supported by SOA suite 11g If not we have to plan to upgrade the database or plan for

a new repository database

bull RCU

We have to use the Repository Creation Utility to install the schemas in the database

Repository Creation Utility is a graphical and command-line tool used to create and manage Oracle Fusion Middleware database schemas in your database

Running the Repository Creation Utility in Preparation for an Oracle SOA Suite Upgrade

To start the Repository Creation Utility (RCU) we run the rcu command which is in the root directory of the Repository Creation Utility CD-ROM or (if we have already

installed the Oracle SOA Suite software on disk) in the bin directory of the Oracle SOA Suite Oracle home

We can use the Repository Creation Utility to install the schemas required for all of the Oracle Fusion Middleware software components that require a schema

However there is no need to install all the schemas unless we plan to install a complete Oracle Fusion Middleware environment and we plan to use the same

database for all the Oracle Fusion Middleware component schemas

White Paper


For a Oracle SOA Suite upgrade we must select the following schemas when you prompted by the Repository Creation Utility (as shown in figure below)

Select the Metadata Services schema in the AS Common Schemas category

This schema supports Oracle Fusion Middleware Metadata Services (MDS) which is required by some Oracle Fusion Middleware components as well as for custom

applications that support MDS For more information see Understanding the MDS Repository in the Oracle Fusion Middleware Administrators Guide

Select the entire SOA Infrastructure category of schemas

These schemas are required for the Oracle SOA Suite components

Install and Configure SOA Suite 11g Middle Tiers

This step will have following high level tasks

1 Install Oracle WebLogic Server and create the Middleware

home

2 Install the Oracle SOA Suite software and create the Oracle

SOA Suite Oracle home

3 Configure the Oracle SOA Suite domain

4 Start the Oracle WebLogic Server domain

5 Verify the installation

bull

bull

bull

White Paper


Below is the diagram which reflects at high level for setting up an SOA suite 11g environment

White Paper


Oracle BPELESB Projects Migration Approaches

BPEL Instance Migration

There are many different approach can be used for migrating BPEL and ESB Projects from SOA suite 10g to 11g

Upgrade in JDeveloper

o Itrsquos a good approach if we are just migrating one project however we need to analyze the warnings in log files generated during upgrade process

Command Line Upgrade

o Can not upgrade whole application

o Usually upgraded directory is different than the source directory

o It does not upgrade jpr files

o HTTP WSDL references to project must be accessible during upgrade

Upgrade using ant

o We have to make sure all environment variables are correctly set

o Upgrade an 10g ESB service to an 11g composite application with mediator component

o Merge several 10g BPEL processes to an 11g Composite application

Upgrade approaches do not support BPEL Instances and audit trail migration

Two choices for cutting over long-running BPEL processes to 11g

ndash Side by side upgrade

bull 10g and 11g systems run side by side

bull 10g system has long-running process in retired state

bull Clients are switched over to 11g

bull 10g system continues running until all callbacks arrive to complete the long running

processes

bull 10g system is decommissioned

White Paper


ndash Grace period cutover


bull After a grace period all long-running processes in 10g are killed


bull 11g system is brought up in production

To upgrade the BAM schema

1 Stop the administration server and the managed servers in the

Oracle WebLogic Server domain that hosts the BAM application

2 Start the Upgrade Assistant

3 Select BAM Schema on the Specify Operation screen ( as in

diagram besides)

Oracle BAM Migration

White Paper


4 Refer to table below description of the Upgrade Assistant screens that require input from you during a Oracle BAM schema upgrade and the options on each screen

5 After the Specify Schema Name screen the Upgrade Assistant performs the following tasks and provides the progress on each task

o Examines the components and schemas to be upgraded and verifies that they can be upgraded successfully

o Provides a summary of the components to be upgraded so you can verify that Upgrade Assistant is upgrading the components and schemas you expect

o Provides a progress screen so you can see the status of the upgrade as it proceeds

o Alerts you of any errors or problems that occur during the upgrade

See Also

Troubleshooting Your Upgrade in the Oracle Fusion Middleware Upgrade Planning Guide for specific instructions for troubleshooting problems that occur

while running the Upgrade Assistant

o Displays the End of Upgrade screen which confirms that the upgrade was complete

Upgrade Assistant Screens That Require Input during a BAM Schema Upgrade

Upgrade Assistant Screen Description

Specify Source Database

Specify Target Database Details

Specify Schema Name

Examining Components This page shows the status of examination phase where the upgrade assistant verifies the source and target schema

Use this screen to enter the database connection details for the database that contains the Oracle BAM 10g schema

Use this screen to select the Oracle BAM 11g schema and enter the password for the BAM schema This is the Oracle

BAM schema password that you set in the Repository Creation Utility when you installed the schema in the database

Use this screen to enter the database connection details for the database that contains the Oracle BAM 11g schema that you

created with the Oracle Fusion Middleware Repository Creation Utility

White Paper



Case Study

bull Application flow testing

bull Business and Application team availability

bull Preparing Testing data

bull External Integrations

ndash Identify inbound and Outbound touch points

ndash Identify the teams ( application networking etc)

bull Connection Pools testing

bull File Transfer testing

bull Security Considerations

The Client

bull A leading provider of optical products and test and measurement solutions for the communications industry

bull Revenue ~2 Billion Dollar

Technologies

bull Oracle EBS 115102

bull SOA 11g

bull OnDemand Siebel CRM

bull Salesforcecom

bull External Integrations ndash B2B Vendors

White Paper


bull Precision provided Web Service had Http binding with Complex input amp output SOA 11g does not support Complex data type for Http Binding Web Service

bull Custom JAVA Client was developed in 10g using Flexera provided Web Service 10g Client could not be used directly in 11g

bull AIA version was not certified for latest SOA release

Key Requirements

bull Oracle EBS and Precision Integration for Shipment (createvoid shipment amp shipment confirmation)

bull Oracle EBS and Flexera (3rd party System ndash On Demand) Integration for Sales Orders(for license entitlements only)

bull EBS and CRM OnDemand Integration using AIA Framework

The Solution

Lessons Learnt

bull Use HttpClient (in JAVA Embed) for invoking Http Web Service with Complex data type

bull Regenerate Web Service Client in 11g amp depending on customization

bull Customize Custom JAVA Client in 11g OR

bull Migration can be as simple as importing 10g resources in 11g JDeveloper customizing

existing SOA artifacts to fresh SOA artifacts development

bull Limitations of SOA can be overcome with JAVA

bull Estimations should be provided based on number of integration points

binding accessibility better to postpone estimating efforts after initial

analysis of integration touch points

bull Every migration is new and unique in its own

bull Develop new SOA Artifacts in 11g based on External web service only

bull Migrate to latest certified AIA version and retrofit customizations


BPEL compilation might fail if we have used comcollaxacommonutilBase64DecoderBase64Encoder classes in 10gThe import of comcollaxacommonutilBase64De-

coderBase64Encoder class should be changed to oraclesoacommonutilBase64DecoderBase64Encoder

The deployment of the migrated composite might fail if the composite invokes the partner WSDL that is having the duplicate import of same WSDL with the following error

ldquoWSDL contains recursive import looprdquo


Base64 encodingdecoding class issue

Recursive Import issue

The httpxxxxxxxxxorabpelxmllibRuntimeFaultwsdl and httpxxxxxxxxxorabpelxmllibws-addressingxsd could not be found after migration In 11g these files are

moved to MDS change the location manually to the following MDS location in the code oramdssoasharedbpelRuntimeFaultwsdl and oramdssoasharedcommon

ws-addressingxsd

RuntimeFaultwsdl and ws-addressingxsd cannot found

Best Practices

bull Ensure that 10g projects are up and running on latest SOA 10g release

bull Install Jdeveloper using SOA extensions

bull Recompile the migrated projects

bull Think about rearranging artifacts to corresponding folders also only change the reference as needed


Before Migration

During and After Migration

Oraclereg Fusion Middleware Upgrade Guide for Oracle SOA Suite WebCenter Portal and ADF 11g Release 1 (111160)

REFERENCES

White Paper

About Jade Global

12 | copy2022 Jade Global Inc All rights reserved

Jade Global is a Cloud-focused IT services partner specialized in enterprise business application implementations integrations software product engineering

consulting technology advisory testing and managed services Jade is an Oracle Platinum Cloud Select Partner Salesforce Silver Partner Dell Boomi Select

Implementation Partner and Service Now Silver Partner Our additional global alliances with NetSuite Microsoft and Zuora allow us to design robust solutions for

a variety of industries and needs We are headquartered in San Jose California with East Coast headquarters in Philadelphia Jade has been recognized as one

of the fastest-growing companies in North America by Inc 5000 for 9 consecutive years For more information please visit wwwjadeglobalcom

wwwjadeglobalcom infojadeglobalcom

Abstract

Executive Summary

Background





Best Practices

References

1

2

3

5

7

13

15

16

16

Table of Contents

White Paper

Abstract




1


TARGET AUDIENCE




White Paper

Executive Summary












White Paper

Background







3


White Paper



White Paper




Planning Guide





Middleware home



Your Applications






Release 11g






White Paper



White Paper










bull RCU









White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper

Abstract




1


TARGET AUDIENCE




White Paper

Executive Summary












White Paper

Background







3


White Paper



White Paper




Planning Guide





Middleware home



Your Applications






Release 11g






White Paper



White Paper










bull RCU









White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper

Executive Summary












White Paper

Background







3


White Paper



White Paper




Planning Guide





Middleware home



Your Applications






Release 11g






White Paper



White Paper










bull RCU









White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper

Background







3


White Paper



White Paper




Planning Guide





Middleware home



Your Applications






Release 11g






White Paper



White Paper










bull RCU









White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper



White Paper




Planning Guide





Middleware home



Your Applications






Release 11g






White Paper



White Paper










bull RCU









White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper




Planning Guide





Middleware home



Your Applications






Release 11g






White Paper



White Paper










bull RCU









White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper



White Paper










bull RCU









White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper










bull RCU









White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper











home






bull

bull

bull

White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper



White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper












Upgrade using ant











processes


White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper












diagram besides)


White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper








See Also








Specify Schema Name







White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper



Case Study










The Client



Technologies


bull SOA 11g


bull Salesforcecom


White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper





Key Requirements




The Solution

Lessons Learnt























ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global


















ws-addressingxsd


Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








Best Practices






Before Migration



REFERENCES

White Paper

About Jade Global








White Paper

About Jade Global








migrating oracle service-oriented architectures(soa) suite

Documents