-
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 have a common coding style across multiple versions of Eclipse import the eclipse-rtccli-format-settings.xml as your first
step. Then unpack a SCM Tools as downloaded into the Eclipse workspace directory. As soon you have done this step you are able to import the actual
rtc2git.cli.extension project. When you got compile errors, make sure to
select rtc2git as your default Target Platform.
In order to enhance the the migration tool or fix a bug that you may encounter here are the steps to set up a development environment
-
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 -
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
For more details visit our wiki
Feel free to report and/or fix issues or create new pull requests