Benefits of Using the Oracle SOA Suite Command-Line Upgrade Tool

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.