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® 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
Open a command prompt and enter this command:
cd C:\Program Files\IBM\JazzTeamServer\server\ repotools-ccm.bat -onlineMigrateEstimate logFile=repo tools-ccm_onlineMigrateEstimate.log teamserver.properties=C:\Program Files\IBM\OLD_JazzTeamServer\server\conf\ccm\teamserver.properties
Open a command line and enter this command:
cd /opt/IBM/JazzTeamServer/server/ ./repotools-ccm.sh -onlineMigrateEstimate logFile=repo tools-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.