Repository tools command to evaluate the online migration process

Edit online

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® Engineering Workflow Management is the only IBM Engineering Lifecycle Management application 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, the onlineMigrateEstimate 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/ccm/teamserver.properties
logFile	The path to the log file.	No	repotools-ccm_onlineMigrateEstimate.log

Example

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-ccm_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-ccm_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.

Note: The onlineMigrateEstimate repotools command result does not display the number of items states when you upgrade from version 7.0.1 to 7.0.2.

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.