Using the Oracle SOA Suite Command-Line Upgrade Tool with Oracle JDeveloper 11g

Considerations When Upgrading All Oracle SOA Applications 9-11 When you run the Oracle SOA Suite Command-Line Upgrade Tool, note the following: ■ If the sourceDir and the targetDir directories are the same directory, then the command-line upgrade tool will automatically create a backup of the directory before migration; if you must re-run the upgrade, you can restore the source files using the backup directory. You can identify the backup directory by the .backup suffix in its name. If the sourceDir and targetDir directories are different, a backup directory is not created and is not necessary, because the files in the sourceDir are not modified during the migration. ■ After upgrade, the logs can be found in the following output directory: ORACLE_HOME upgradelogs 9.3.7.5 Combining Multiple BPEL Projects Into a Single Composite with the Oracle SOA Suite Command-Line Upgrade Tool Using the Oracle SOA Suite Command-Line Upgrade Tool, you can merge BPEL projects together and create a single composite. This is not possible when you use the Migration Wizard in Oracle JDeveloper. To combine multiple BPEL projects into a single composite, provide multiple source directories as part of the -Dsource property on the command line. Path separators can be a colon : or a semicolon ;. Ant will convert the separator to platforms local conventions. As a guideline, also use double quotes to identity the Table 9–2 Summary of the Oracle SOA Suite Command-Line Upgrade Tool Arguments Command-Line Argument Description -Dsource The fully-qualified name and path for the directory where the Oracle SOA Suite 10g project files reside. For Oracle BPEL Process Manager projects, this can be the bpel folder, the parent directory that hosts the bpel folder. For Oracle Enterprise Service Bus projects, this can be the Oracle Enterprise Service Bus project folder. -Dtarget The fully-qualified name and path for the directory that will contain the upgraded project files. The Oracle SOA Suite Command-Line Upgrade Tool upgrades your Oracle BPEL Process Manager project files, and generates new, upgraded files in a subdirectory of the target directory specified in this argument. -DappName The Oracle SOA Suite Command-Line Upgrade Tool uses this value to create an application subdirectory inside the target directory. The tool then copies the upgraded project files to application subdirectory. bpel_or_mediator_identifier Can be one of two values: ■ bpel, to identify a Oracle BPEL Process Manager project that you want to upgrade to Oracle BPEL Process Manager 11g ■ mediator, to identify an Oracle Enterprise Service Bus project that you want to upgrade to Oracle Mediator 11g. If you do not specify a value, then the command-line tool assumes you are upgrading an Oracle BPEL Process Manager project. 9-12 Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF multiple source directories to prevent Ant from parsing the input in an unexpected manner. The first source directory specified will be considered as the root of the 11g project and will determine the composite name. For example: ant -f ORACLE_HOMEbinant-sca-upgrade.xml -Dsource sourceDir1:sourceDir2 -Dtarget targetDir -DappName app_name The first project in the source list is considered the root project and only those services are exposed as Composite Services. Anytime you use the merge feature, it is recommended that the projects be related. Merging of projects is supported for BPEL projects only. ESB projects cannot be merged with other BPEL or other ESB projects. 9.3.7.6 Upgrading Oracle Enterprise Service Bus ESB Projects with the Oracle SOA Suite Command-Line Upgrade Tool The Oracle SOA Suite Command-Line Upgrade Tool can also be used to upgrade ESB projects to Oracle Mediator 11g. To upgrade an ESB project, use the instructions in Section 9.3.7.4, Upgrading BPEL or ESB Projects with the Oracle SOA Suite Command-Line Upgrade Tool , but be sure to use the mediator argument, as follows: ant -f ORACLE_HOMEbinant-sca-upgrade.xml -Dsource sourceDir -Dtarget targetDir -DappName app_name mediator

9.3.7.7 Upgrading Domain Value Maps DVMs and Cross References XREFs in the ESB Repository

If you use domain value maps DVMs or Cross References in your Oracle BPEL Process Manager 10g or Oracle Enterprise Service Bus 10g projects, then note the following: ■ The xPath functions you use to access the domain value maps or cross references are upgraded automatically to Oracle BPEL Process Manager and Oracle Mediator 10g when you open and upgrade your applications in Oracle JDeveloper 11g. ■ However, you must perform a manual upgrade task to upgrade the domain value maps and cross references that are saved in the Oracle Enterprise Service Bus repository. The upgrade process moves the domain value maps from the ESB repository to the Oracle Fusion Middleware 11g Metadata Services MDS repository. For more information, see Managing the MDS Repository in the Oracle Fusion Middleware Administrators Guide. To upgrade your 10g domain value maps in the ESB repository perform the following tasks. Task 1 Export the domain value map metadata to a ZIP file 1. Change directory to the Oracle Enterprise Service Bus Oracle home.