A tool made for migrating code from an existing RTC SCM repository into a Git repository It uses the CLI of RTC to gather the required information.
- RTC Server with Version 5.0+ (was tested using 5.0.1)
- SCM Tools from IBM.
To avoid an account creation on the jazz.net site, you could use bugmenot.
Please make sure that your SCM Tools run in English (because we need to parse their output sometimes).
There is a wiki page on how to configure RTC CLI) - Python 3.4+ (does not work with previous versions or with Python 2)
- Create a config file called
config.ini
and fill out the needed information, use the suppliedconfig.ini.sample
orconfig.ini.minimum.sample
as reference - Execute
migration.py
- It initalizes an empty git repository and clones it
- In this repository, it loads a newly created (which will be set to the oldest baseline possible) or existing rtc workspace
- The baseline of each component of a given stream is determined
- For each baseline a compare command will be executed
- The result of the compare will be parsed to get to the necessary commit-information (such as author, comment, date)
- The change will be accepted in the workspace
- The corresponding git command will be executed to do the same change in the git-repository
We welcome any feedback! :)
Feel free to report and/or fix issues or create new pull requests
For more details visit our wiki