Code Monkey home page Code Monkey logo

rtc2gitcli's Introduction

Tool to migrate from IBM RTC to Git

A tool made for migrating code from an existing IBM RTC into a Git repository. Inspired by rtc2git, but written in Java and hopefully faster. It is implemented as scm cli plugin.

Prerequirements

Usage

  • create an source RTC workspace with flow target and components as wanted → SOURCE_WORKSPACE

  • create an target RTC workspace with SOURCE_WORKPSACE as 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>

How does it work?

  1. It initalizes an empty git repository and clones it

  2. In this repository, it loads TARGET_WORKSPACE RTC workspace

  3. Every change set is accepted

  4. If there is a baseline on the change set, a tag is created on git

  5. The change set is committed to git

Eclipse requirements

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.

Setup Eclipse development environment

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.bat is (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.xml and 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

Wiki

For more details visit our wiki

Contribute & Feedback

Feel free to report and/or fix issues or create new pull requests

rtc2gitcli's People

Contributors

fbuehlmann avatar reinhapa avatar zbindenp avatar ohumbel avatar akoptelov avatar wtfjoke avatar

Watchers

James Cloos avatar Piotr Godowski avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.