Repository tools command to evaluate the online migration process

Use the onlineMigrateEstimate command to retrieve the number of item states that the online migration command, onlineMigrate, will process. The results of the onlineMigrateEstimate command do not alter the database schema.
Important: IBM® Rational® Team Concert® is the only Rational solution for Collaborative Lifecycle Management applications that supports online migration.

Purpose

The onlineMigrateEstimate command provides data that can help you evaluate whether your repository warrants an online or offline migration.

Parameters

Attribute Description Required Default
teamserver.properties The path to the teamserver.properties file of the server that is running. This server is the original server database that contains the data that is going to be migrated.
Tip: Starting in version 5.0 of Rational Team Concert, theonlineMigrateEstimate command is available and runs from a new installation of each product. You must specify an absolute path to the teamserver.properties file of the old server. Otherwise, if you keep the path relative, such as conf\ccm\teamserver.properties, this command points to the teamserver.properties file in the new server installation instead of the old server. For an example of an absolute path, see the "Example" section.
No conf/application/teamserver.properties

where application is jts

logFile The path to the log file. No repotools_onlineMigrateEstimate.log

Example

  • This example is for Rational Team Concert.

    For Windows operating system Open a command prompt and enter this command:

    cd C:\Program Files\IBM\JazzTeamServer\server\
    repotools-ccm.bat -onlineMigrateEstimate logFile=repotools_onlineMigrateEstimate.log teamserver.properties=C:\Program Files\IBM\OLD_JazzTeamServer\server\conf\ccm\teamserver.properties

    For Unix operating systems Open a command line and enter this command:

    cd /opt/IBM/JazzTeamServer/server/
    ./repotools-ccm.sh -onlineMigrateEstimate logFile=repotools_onlineMigrateEstimate.log teamserver.properties=/opt/IBM/OLD_JazzTeamServer/server/conf/ccm/teamserver.properties

Output

The output of repotools -onlineMigrateEstimate command contains a list of old item types to be processed and the number of states for each type. This example shows the command output. Note that The component model of "com.ibm.team.repository.tests.omtest" was updated from "1" to "2" line in the estimation mode, does not mean that your database is actually updated.
CRJAZ1442I The component model of "com.ibm.team.repository.tests.omtest" was updated from "1" to "2".
CRJAZ1440I A new type "AuditableNewType0" was added.
CRJAZ1440I A new type "SimpleNewType0" was added.
CRJAZ1440I A new type "ExtractedContent" was added.
The user "ADMIN" has logged in to the database "repositoryDB".
CRJAZ9999I New type handler "OnlineMigrationAuditableItemHandler" found for item type "AuditableOldType0".  Item DB ID = 21.
CRJAZ9999I New type handler "OnlineMigrationSimpleItemHandler" found for item type "SimpleOldType0".  Item DB ID = 22.
CRJAZ9999I Finding number of item states in database that need processing.
Type "AuditableOldType0 (21)":  1,200 states.
Type "SimpleOldType0 (22)":  500 states.
For general guidelines on the number of states that warrant an online migration, see the Rational Team Concert application migration matrix topics on the Deployment wiki.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki