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
copy2022 Jade Global Inc All rights reserved
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
copy2022 Jade Global Inc All rights reserved
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
copy2022 Jade Global Inc All rights reserved4
Below diagram shows the pictorial representaion of archictechure difference between soa 10g and 11g environments
White Paper
copy2022 Jade Global Inc All rights reserved5
High Level Upgrade Steps
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
copy2022 Jade Global Inc All rights reserved6
Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
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
copy2022 Jade Global Inc All rights reserved
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
copy2022 Jade Global Inc All rights reserved
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
copy2022 Jade Global Inc All rights reserved4
Below diagram shows the pictorial representaion of archictechure difference between soa 10g and 11g environments
White Paper
copy2022 Jade Global Inc All rights reserved5
High Level Upgrade Steps
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
copy2022 Jade Global Inc All rights reserved6
Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
Abstract
copy2022 Jade Global Inc All rights reserved
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
copy2022 Jade Global Inc All rights reserved
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
copy2022 Jade Global Inc All rights reserved4
Below diagram shows the pictorial representaion of archictechure difference between soa 10g and 11g environments
White Paper
copy2022 Jade Global Inc All rights reserved5
High Level Upgrade Steps
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
copy2022 Jade Global Inc All rights reserved6
Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
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
copy2022 Jade Global Inc All rights reserved
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
copy2022 Jade Global Inc All rights reserved4
Below diagram shows the pictorial representaion of archictechure difference between soa 10g and 11g environments
White Paper
copy2022 Jade Global Inc All rights reserved5
High Level Upgrade Steps
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
copy2022 Jade Global Inc All rights reserved6
Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
Background
copy2022 Jade Global Inc All rights reserved
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
copy2022 Jade Global Inc All rights reserved4
Below diagram shows the pictorial representaion of archictechure difference between soa 10g and 11g environments
White Paper
copy2022 Jade Global Inc All rights reserved5
High Level Upgrade Steps
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
copy2022 Jade Global Inc All rights reserved6
Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved4
Below diagram shows the pictorial representaion of archictechure difference between soa 10g and 11g environments
White Paper
copy2022 Jade Global Inc All rights reserved5
High Level Upgrade Steps
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
copy2022 Jade Global Inc All rights reserved6
Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved5
High Level Upgrade Steps
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
copy2022 Jade Global Inc All rights reserved6
Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved6
Below is a ow diagram which represents the high level upgrade steps for SOA 10g to 11g Migration
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved7
Setting up SOA suite 11g Environment
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
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved8
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
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved9
Below is the diagram which reflects at high level for setting up an SOA suite 11g environment
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved10
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
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved11
ndash Grace period cutover
bull 10g system has long-running process in retired state
bull After a grace period all long-running processes in 10g are killed
bull 10g system is decommissioned
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
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved12
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
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved13
Testing Considerations
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
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
White Paper
copy2022 Jade Global Inc All rights reserved14
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
Common Deployment Issues
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
copy2022 Jade Global Inc All rights reserved15
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
copy2022 Jade Global Inc All rights reserved16
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
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
copy2022 Jade Global Inc All rights reserved16
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
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