-
SCM Tools from IBM. To avoid an account creation on jazz.net site, you could use bugmenot (see also wiki page (configure RTC CLI)
-
Eclipse configured with scm tools as target platform (see wiki configure scm tools target platform)
-
create an source RTC workspace with flow target and components as wanted →
SOURCE_WORKSPACE -
create an target RTC workspace with
SOURCE_WORKPSACEas flow target →TARGET_WORKSPACE -
check comments at configure rtc workspaces
-
open shell or cmd
-
step into the target directory
-
load the initial target workspace:
scm load -r <uri> -u <username> -P <password> <TARGET_WORKSPACE>
Execute the actual migration:
scm migrate-to-git -r <uri> -u <username> -P <password> -m <migration.properties> <SOURCE_WORKSPACE> <TARGET_WORKSPACE>
-
It initalizes an empty git repository and clones it
-
In this repository, it loads
TARGET_WORKSPACERTC workspace -
Every change set is accepted
-
If there is a baseline on the change set, a tag is created on git
-
The change set is committed to git
In order to enhance the the migration tool, fix a bug that you may encounter or simply want to run it from your eclipse, here are the steps to set up a development environment:
-
Import Code Style (Window→Preferences→Java→Code Style→Formatter)
eclipse-rtccli-format-settings.xmlin order to have a common coding style (you can skip this step if you only want to run it) -
Configure SCMTools Target Platform described here in the wiki. Point to the folder where your
scm.exe/lscm.batis (If you use eclipse classic aka non javaee eclipse, install the Eclipse Plugin Development Tools as described here) -
Clone this repo and import it in eclipse as maven project
-
Open
pom.xmland follow the hint to install the missing maven connector -
Update maven project using [ALT]+[F5]
-
By this point the project shouldnt contain any errors (make sure you have still your created target platform in window preference selected)
-
You should have an launch-configuration named rtc2git → start it
-
In your console window you should see "Help for: scm migrate-to-git"
-
Open the launch-config and edit the command in arguments/program arguments
In case you use RTC Version 6+ (and have the error Problem running 'help', unknown Subcommand…), please follow the instructions of this issue-comment in order to run rtc2gitcli.
For more details visit our wiki
Feel free to report and/or fix issues or create new pull requests