VoluteTransfer20150730 < IVOA

---+ Volute transfer

Options for transferring [[https://volute.googlecode.com][Volute]] from [[https://code.google.com/][GoogleCode]] to [[https://github.com/][GitHub]].

---++ Headline figures, based on disc usage

---+++ volute-complete - 825M

Svn checkout of everything in the repository.

<verbatim>
    svn checkout https://volute.googlecode.com/svn/trunk/ volute-complete
    du -h volute-complete > complete-original.txt
</verbatim>

---+++ volute-noextern - 764M

Svn checkout, without resolving the extern references.

<verbatim>
    svn checkout --ignore-externals https://volute.googlecode.com/svn/trunk/ volute-noextern
    du -h volute-noextern > noextern-original.txt
</verbatim>

---+++ volute-export - 391M

Svn export, snapshot of now with no history.

<verbatim>
    svn export --ignore-externals https://volute.googlecode.com/svn/trunk/ volute-export
    du -h volute-export > export-original.txt
</verbatim>

Of the 391M in the exported snapshot, the top 8 projects are :

   * theory 220M
   * dm 126M
   * registry 26M
   * grid 6M
   * vocabularies 3M
   * samp 3M
   * votable 2M
   * ivoapub 2M

---++ Maximal transfer

If we just press the 'export to GitHub' button, then everything will get
transferred, including the commit history.

I have seen this work on a *small* project, and everything just worked.
On a large project like ours the process will probably take a while.

With a total size of 825M we are close to the GitHub 1Gbyte per repository
limit, which may cause problems later on.

The only unusual thing to watch for is that the email telling you the
process has completed will be sent to the email address linked to your
GitHub account, not to your Google account.

---++ Snapshot transfer

If we skip the svn history and just take a snapshot of where we are now,
then we have less than 400M to transfer.

We would have to do the transfer manually, exporting a local copy from svn,
and then importing it into a new GitHub repository.

<verbatim>
    git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY local-repo
    svn export --ignore-externals https://volute.googlecode.com/svn/trunk/ local-repo
    pushd local-repo
        git add .
        git commit -m 'Initial import from svn'
        git push
    popd
</verbatim>

---++ Link to IVOA organization

If you want the GitHub repository to be owned by the
[[https://github.com/ivoa][IVOA organization]] in GitHub, do the transfer
to your private account, and then transfer the repository afterwards.

[[https://code.google.com/p/support-tools/wiki/GitHubExporterFAQ#Can_I_migrate_a_Google_Code_repository_to_a_GitHub_Organization?][source]]

---++ References

   * [[http://google-opensource.blogspot.co.uk/2015/03/farewell-to-google-code.html][Farewell to google code]]
   * [[https://code.google.com/export-to-github/][GitHubExporter]]
   * [[https://code.google.com/p/support-tools/wiki/GitHubExporterFAQ][GitHubExporter FAQ]]
   * [[https://code.google.com/p/support/wiki/ReadOnlyTransition][ReadOnly transition]]

---+ Detailed breakdown

   * projects/dal
      * size : 576k
      * projects/dal/ADQL
         * size   : 152k
         * type   : IVOA standard
         * title  : Astronomical Data Query Language
         * format : =ivoatex=
         * files  : =make, tex=
      * projects/dal/ADQL2Err1
         * size   : 16k
         * type   : IVOA errata
         * title  : ADQL 2.0 Erratum 1
         * format : =ivoatex=
         * files  : =make, tex=
      * projects/dal/TAP
         * size   : 124k
         * type   : IVOA standard
         * title  : Table Access Protocol
         * format : =ivoatex=
         * files  : =make, tex=
      * projects/dal/TAP1Err1
         * size   : 24k
         * type   : IVOA errata
         * title  : TAP-1.0 Errata
         * format : =ivoatex=
         * files  : =make, tex=
      * projects/dal/TAPNotes
         * size   : 224k
         * type   : IVOA note
         * title  : TAP Implementation Notes
         * format : =ivoadoc=
         * files  : =make, html, xsl, bbl=
This topic: IVOA > TWikiUsers > DaveMorris > VoluteTransfer20150730
Topic revision: r2 - 2015-07-30 - DaveMorris