2 Installing the Oracle Java CAPS Migration Tool

This chapter describes how to install the Oracle Java CAPS Migration Tool and associated JAR files, and how to configure the Oracle Java CAPS environment for migration.

This chapter includes the following topics:

Section 2.1, "About the Installation"
Section 2.2, "Installing the Migration Tool"

2.1 About the Installation

The migration tool is provided in a ZIP file, and installing the tool involves simply downloading and extracting the file. The installation includes the following files:

MigrationTool.jar: This utility converts an Oracle Java CAPS project to an Oracle SOA Suite project. It can also be used to convert OTD format to XSD, and XSD format to JAXB objects.
logging.properties: This file sets the logging levels for the migration process.
oracle.migrationtool.jcaps.libraries: This folder contains all the required libraries for the migration tool.

Before you can use the migration tool, you need to install additional JAR files and configure the Oracle Java CAPS IDE. Both processes are described in this chapter.

2.1.1 Prerequisites

In order to run the migration tool, you must have the following installed and accessible from the location of the migration tool:

Oracle Fusion Middleware (specifically, the oracle_common directory)
Oracle SOA Suite

Additionally, you need to have access to Oracle Java CAPS 6.x or 5.x because certain projects need to be rebuilt and redeployed prior to migration.

2.2 Installing the Migration Tool

Installing the migration tool includes extracting the tool to a location on your computer, installing additional JAR files, and configuring the Oracle Java CAPS environment.

To install the migration tool

Download the MigrationTool.zip to a folder on your computer where you want to store the tool.
Extract the ZIP file.

To install third-party JAR files

Download the following three files to the oracle.migrationtool.jcaps.libraries/lib folder in the migration tool installation:
- Swing Application Framework: http://download.java.net/maven/2/org/jdesktop/appframework/1.0.3/appframework-1.0.3.jar
- Swing Worker API: http://download.java.net/maven/2/org/jdesktop/swing-worker/1.1/swing-worker-1.1.jar
- Java Parser: https://docs.google.com/uc?id=0B6K9IqkgGbcgZTg3ZWMzMzYtNDQ4Zi00NzBmLWI1OTUtOTM2MTViMjYyMmEw&export=download&hl=en_US
  
  Note:
  This link requires a login to a Google account.

To set up the Oracle Java CAPS environment

Adding a new flag to the Oracle Java CAPS IDE preserves the Java code from any JCDs in the generated EAR files, which is required for the migration to complete successfully.

If you are migrating Oracle Java CAPS 6.x Repository projects that contain Java Collaboration Definitions (JCDs), do the following:
1. In your Oracle Java CAPS home directory, navigate to /netbeans/etc.
2. Open netbeans.conf in a text editor.
3. Append the following flag to the end of the netbeans_default_options property before the closing double quote:
```
-J-Drun.mode=debug
```
4. Save and close the file.
If you are migrating Oracle Java CAPS 5.x projects, do the following:
1. In your Oracle Java CAPS home directory, navigate to /edesigner/bin.
2. Open runed.bat in a text editor.
  
  Do not double-click the file to open it; double-clicking the file launches Enterprise Designer.
3. Append the following flag to the end of the netbeans_default_options property before the closing double quote:
```
"-J-Drun.mode=debug"
```
4. Save and close the file.