Import to GitHub in POSIX-compatible OS

1. Configure GitHub

   • login to GitHub and create new repository:

   

2. Configure local Git server (the machine where Git repository will reside)

   • install Java Runtime environment:

     • for MacOS X download an appropriate JavaRE pack from the web site:

       https://java.com/en/download

       double click on the *.dmg file, once mounted open the application and follow installation wizard.

     • for RedHat family Linux:

       $ sudo yum install java

     • for Debian-based Linux:

       $ sudo apt-get install default-jre

     install SubGit binary:

     • On non-Debian Linux and MacOS X download universal subgit-3.2.4.zip binary:

       https://subgit.com/download/subgit-3.2.4.zip and unzip it:

       • for Linux:

         $ unzip subgit-3.2.4.zip

       • on MacOS X it should be unpacked automatically (if downloaded with Safari), but if it isn't - double-click on the subgit-3.2.4.zip.

       on Debian family Linux (Debian/Ubuntu/Mint): download Debian package:

       https://subgit.com/download/subgit3.2.4all.deb

       fetch missing dependencies and install:

       $ sudo dpkg -i subgit3.2.4all.deb $ sudo apt-get install -f

1. Configure local repository

   • Run this command on behalf of the same user you use to serve Git repository:

     $ subgit-3.2.4/bin/subgit configure --layout auto --trunk trunk SVNURL GITREPO > To be added into pop-up cloud (when hovering on SVNURL and GITREPO): > > SVN_URL - URL to the SVN project. > > GIT_REPO - path to new Git repository where data from the SVN project will be imported to. see command example --> (to be placed in drop-down block): $ subgit-3.2.4/bin/subgit configure --layout auto --trunk trunk http://example.com/svn/repository/project ./repo.git

     SubGit version 3.2.4 ('Bobique') build #3670

     Configuring writable Git mirror of remote Subversion repository: Subversion repository URL : http://example.com/svn/repository/project Git repository location : ./repo.git

     Detecting peg location... Authentication realm: http://example.com:80 Subversion Repository Username [user]: user Password [user]: Peg location detected: r10248 project/trunk Fetching SVN history... Done. Growing trees... Done. Project origin detected: r1 project/trunk Building branches layouts... Done. Combing beards... Done. Generating SVN to Git mapping... Done.

     CONFIGURATION SUCCESSFUL

     To complete SubGit installation do the following:

     1) Adjust Subversion to Git branches mapping if necessary: /home/user/repo.git/subgit/config 2) Define at least one Subversion credentials in default SubGit passwd file at: /home/user/repo.git/subgit/passwd OR configure SSH or SSL credentials in the [auth] section of: /home/user/repo.git/subgit/config 3) Optionally, add custom authors mapping to the authors.txt file(s) at: /home/user/repo.git/subgit/authors.txt 4) Run SubGit 'install' command: subgit install ./repo.git For complete subgit configure reference see Import book

   • Specify authors mapping

     Update GIT_REPOS/subgit/authors.txt file or change core.authors option to point to global authors mapping

     Find more details about authors mapping in Import book

2. Perform import into local Git repository

   • Import repository by the command:

     $ /tmp/subgit-3.2.4/bin/subgit import GIT_REPO

     see command example --> (to be placed in drop-down block):

     $ /tmp/subgit-3.2.4/bin/subgit import ./project.git

     SubGit version 3.2.4 ('Bobique') build #3670

     Authentication realm: http://svn.example.com:80 Subversion Repository Username [git]: user Password for 'user':

     Translating Subversion revisions to Git commits...

     Subversion revisions translated: 10248. Total time: 2 hours 15 minutes 38 seconds.

     IMPORT SUCCESSFUL

3. Sync local Git repostiory with GitHub

   • step into newly created local Git repository $ cd GIT_REPO

   • add remote to local Git repository $ git remote add github https://github.com/user/project

   • push local repository content into GitHub repository $ git push github --all --follow-tags

   • When the command completed, all the files are on GitHub, so you can clone your GitHub repository and start to work with it:

     $ git clone GITHUBREPO WORKTREE

     where

     WORK_TREE - path to your working copy.

     GITHUB_REPO - GitHub project URL see command example --> (to be placed in drop-down block):

     $ git clone https://github.com/user/project.git ./project.git Cloning into './project.git'... Password for 'http://user@example.com': remote: Counting objects: 99, done. remote: Compressing objects: 100% (39/39), done. remote: Total 99 (delta 50), reused 99 (delta 50) Unpacking objects: 100% (99/99), done.

Note: no license key required for import!

Would you have any assistance, don't hesitate to contact us at support@subgit.com