Page History

SubGit IMPORT in Windows

1. Install binaries:

   • download an appropriate Java Runtime Environment pack from the web site:

     https://java.com/en/download

     double click on the file and follow installation wizard.

   • Download subgit-3.2.4.zip archive and unzip it:

     https://subgit.com/download/subgit-3.2.4.zip

     right-click on the subgit-3.2.4.zip and choose 'Extract all' in the menu.

2. Configure Install SubGit tool according to the Installation guide.
   
   
3. Configure a new Git repository
   
   

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

     No Format
     > subgit

     -3

     .

     2.4binsubgit.

     bat configure --layout auto --trunk trunk SVN_URL GIT

     REPO > To be added into pop-up cloud (when hovering on SVNURL and GITREPO): > >

     _REPO

     where

     • SVN_URL
     - URL to the SVN project. > >
     •    – SVN project URL.
     • GIT_REPO
     -
     •  – a 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.4bin> subgit.bat configure --layout auto --trunk trunk
     • .
     • TRUNK       –  a path, relative to SVN_URL, that leads to an SVN directory that plays a role of the main line of development.
        

     Expand
     title See subgit configure example…
     Code Block language text theme FadeToGrey title subgit configure > subgit.bat configure --layout auto --trunk trunk http://example.com/svn/repository/project C:\repo.git SubGit version 3.2.4 ('Bobique') build

     #3670Configuring writable Git mirror of remote Subversion repository: Subversion repository URL :

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

     Detecting peg

     Detecting peg location... Authentication realm:

     http

     <http://example.com:

     80

     80> Subversion Repository Username [user]: user Password for '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: C:repo.gitsubgitconfig 2) Define at least one Subversion credentials in default SubGit passwd file at: C:repo.gitsubgitpasswd OR configure SSH or SSL credentials in the [auth] section of: C:repo.gitsubgitconfig 3) Optionally, add custom authors mapping to the authors.txt file(s) at: C:repo.gitsubgitauthors.txt 4) Run SubGit 'install' command: subgit install "C:repo.git"

For complete `subgit configure` reference see [Import book](https://subgit.com/import-book.html#16)

    - 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](https://subgit.com/import-book.html#20)

1. Perform import and start using new Git repository:

   • Import repository by the command:

     subgit-3.2.4bin> subgit import GIT_REPO see command example --> (to be placed in drop-down block):

     C:subgit-3.2.4bin> subgit import c:repo.git SubGit version 3.2.4 ('Bobique') build #3670

     Translating Subversion revisions to Git commits...

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

     IMPORT

     CONFIGURATION SUCCESSFUL To complete SubGit installation do the following: 1) Adjust Subversion to Git branches mapping if necessary: C:\repo.git\subgit\config 2) Define at least one Subversion credentials in default SubGit passwd file at: C:\repo.git\subgit\passwd OR configure SSH or SSL credentials in the [auth] section of: C:\repo.git\subgit\config 3) Optionally, add custom authors mapping to the authors.txt file(s) at: C:\repo.git\subgit\authors.txt 4) Run SubGit 'install' command: subgit install "C:\repo.git"

   • Specify authors mapping

     Configure authors mapping in default authors mapping file:

     No Format
     GIT_REPOS/subgit/authors.txt

     Or change core.authors option so that it points to the global authors mapping file.

     Find more details about authors mapping in Authors mapping article.
      

2. Import data into the Git repository by the command:
   
   

   No Format
   > subgit import GIT_REPO

   where 

       GIT_REPO – a path to the Git repository.
    

   Expand
   title See subgit import example…
   Code Block language text theme FadeToGrey title subgit import > subgit import c:\repo.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: 3 hours 08 minutes 32 seconds. IMPORT SUCCESSFUL

3. When the command completes, you can clone your new Git repository and start to work with it:

   No Format
   > git clone GIT_REPO WORK_TREE

   where where 

       WORK_TREE -  – a path to your working copy. see command example --> (to be placed in drop-down block): C:> git clone
   
   

   Expand
   title See git clone example…
   Code Block language text theme FadeToGrey title git clone example C:\> git clone file:///c/repo.git c:\repo_working_copy Cloning into 'C:\repo_working_copy'... remote: Counting objects: 99, done. remote: Compressing objects: 100% (89/89), done. remote: Total 99 (delta 44), reused 0 (delta 0) Receiving objects: 100% (99/99), 8.98 KiB | 0 bytes/s, done. Resolving deltas: 100% (44/44), done.

   Warning
   title Emty working tree case
   If Git warns you that you are cloning an empty repository and you don't see your files in the working tree, most probably automatic branches and tags mapping didn't work correctly. In this case, mapping has to be set manually, see details on mapping in Branches and tags mapping.

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