Upgrading from version 2 to 3.0.1 and changing the database software

You can migrate from IBM Rational Team Concert™ version 2 to version 3.0.1, and change the database software.

About this task

If you are migrating from version 2 to version 3.0.1 and want to change to different database software (for example, from Derby to IBM DB2®), you must use the -import and -export repotools commands instead of -addTables.
Note: The following procedure describes how to manually upgrade your product. To use the upgrade script that eliminates some of the manual steps, see Upgrading from version 2 to 3.0.1 using the upgrade script.

Procedure

  1. Run the pre-migration steps. See the "Before you begin" section of Upgrading manually from version 2 to 3.0.1.
  2. Back up your Rational Team Concert version 2 database.
  3. Update the database properties. See Verifying the configuration files during upgrade.
    Important: Open a new command line window to run the following v2.x repotools command. This is necessary to ensure that there are no conflicts between the environments variable used by the v2.x and v3.0.1 commands.
  4. Export the contents of the v2 database. Go to the <RTC2.x_install_dir>/jazz/server directory and run the following command:
    repotools -clean -export toFile=rtcData.tar
  5. Import the contents into a v3.0.1 database. Go to the <RTC3.0.1_install_dir>/server directory and run the following command:
    repotools-jazz -import fromFile=<RTC2.x_install_dir>/jazz/server/rtcData.tar
  6. Export user information from the Rational Team Concert database:
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar 
  7. Import user information into the Jazz™ Team Server database:
    Note: Do not specify the createTables parameter if Jazz Team Server already exists. This parameter must be specified only for new Jazz Team Server.
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables 
  8. Import the team server user information into the Rational Team Concert database:
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt 
  9. Run Configuring the server and Verifying the upgrade.

Feedback