Exporting and importing data by using the ClearCase Version Importer
To migrate Rational®
ClearCase®
versions, you must run the export command to extract data from Rational
ClearCase and
store it to intermediate files in the specified data folder. You must ensure that the data folder
has sufficient free disk space to store the extracted data. The export command accesses Rational
ClearCase but not
IBM® Engineering Workflow
Management
(EWM ). To migrate Rational
ClearCase
versions, you must run the import command to import intermediate data files to EWM source
control, which are created by the export command. The import command accesses EWM but not
Rational
ClearCase .
Exporting multiple configurations
You can specify a list of IBM Engineering Workflow Management (EWM ) views to be imported as EWM baselines with either the --viewTags or --viewTagsFile option.
Migrating data in increments
For large migrations, you can plan ahead to migrate the data in small increments. Use the --prevDirs
and --prevDirsFile
options of the export command.
Exporting data and specifying the change-set comment format
The Rational ClearCase versions are imported as individual change sets in IBM Engineering Workflow Management (EWM ) source control. Before you import data, you must export it to intermediate data files. When you export data, you can also customize the comment field of the source control change sets when they are migrated.
Updating character encoding of text files
The text files in Rational ClearCase are imported as IBM Engineering Workflow Management (EWM ) source control text files with the system's default character encoding. You can change the character encoding of the files after the export and before you import the files into EWM source control.
Excluding file elements from the exported data files
Errors or warnings can occur on files during export. You can exclude specific files from the exported data files and resolve the issues later.
Specifying the user accounts mapping
The export command creates the structural framework of the credential mapping. Before you run the import, you can manually specify the mapping between the user accounts that access Rational ClearCase and the user accounts that access IBM Engineering Workflow Management (EWM ). The import command reads the credential mapping, and the mapped account is set to the owner of the EWM source control change set.
Importing data into EWM source control
To migrate Rational ClearCase versions, you must run the import command to import intermediate data files into IBM Engineering Workflow Management (EWM ) source control, which are created by the export command. The import command accesses EWM but not Rational ClearCase .
Importing change-set links from the Rational ClearQuest and Rational ClearCase integration
You can migrate change-set links from the Rational ClearQuest® and Rational ClearCase UCM integration to IBM Engineering Workflow Management (EWM ).
Verifying the imported history of a stream or component
After you import data into IBM Engineering Workflow Management (EWM ) source control, you can view the imported history from the ClearCase Synchronized Stream view.
Verifying the imported Rational ClearCase configurations and version histories
After you run the ClearCase Version Importer to migrate source control data to IBM Engineering Workflow Management (EWM ), you can run the ccc compare command at the end of the migration to verify that the imported content is identical to the content in Rational ClearCase .