1. Summary
  2. Files
  3. Support
  4. Report Spam
  5. Create account
  6. Log in

Changes between Version 18 and Version 19 of Subversion import instructions

Show
Ignore:
Timestamp:
06/04/13 14:53:51 (11 months ago)
Author:
ctsai (IP: 172.29.29.65)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Subversion import instructions

    v18 v19  
    11[[PageOutline]] 
    22 
    3 '''''Note:''''' This documentation is written for the Classic !SourceForge system. It's for instructions in importing to a New !SourceForge SVN repository see [http://sourceforge.net/p/forge/community-docs/Subversion this page]. General documentation for SVN on the New !SourceForge system is available [http://sourceforge.net/p/forge/documentation/svn/ here]. 
     3'''''Note:''''' The documentation previously found here is written for the Classic !SourceForge system, which is no longer in wide usage on our site. For instructions in importing to a New !SourceForge SVN repository see [http://sourceforge.net/p/forge/community-docs/Subversion this page]. General documentation for SVN on the New !SourceForge system is available [http://sourceforge.net/p/forge/documentation/svn/ here]. 
    44 
    5 Not sure if you have a Classic or Beta project? See [http://sourceforge.net/p/forge/documentation/Classic%20vs%20Beta%20projects/ this guide]. 
     5Not sure if you have a Classic or New SourceForge project? See [http://sourceforge.net/p/forge/documentation/Classic%20vs%20Beta%20projects/ this guide]. 
    66 
    7 = Importing Data into Subversion = 
    8  
    9 [wiki:"What is SourceForge.net?" SourceForge.net] permits the import of data into a [wiki:"Subversion"] repository from a user-supplied Subversion dump file.  This Subversion dump file can be compressed (via .gz, .bz2, .zip, but not tarred) or uncompressed. '''As the import process is largely automated on our side, it is imperative that these instructions be followed closely and in their entirety to ensure a successful import.''' 
    10  
    11 = Creating a Subversion dump file = 
    12  
    13 You can create a Subversion dump file in a variety of ways, such as dumping an existing Subversion repository, or using a repository conversion tool, such as cvs2svn. 
    14  
    15 If you have backed-up your subversion repository using rsync, you can use "`svnadmin dump DIRECTORY >FILE`" to create a dump file of that content.  There are tools available that can filter the resulting dump file, allowing you to make changes before importing it (as described below). 
    16  
    17 It is a good idea to compress the resulting dump file, to save space. We support zip, bzip2, and gzip compression. 
    18  
    19 = Using cvs2svn to create a Subversion dump file from CVS content = 
    20  
    21 If you have an existing CVS repository that you would like to convert to Subversion, follow these instructions: 
    22  
    23  1. Download and install a copy of [http://cvs2svn.tigris.org/ cvs2svn].  You can use your own server, or use an [wiki:"Shell service" interactive shell] to do the work. 
    24  1. Get a copy of the RCS files for the CVS repository.  For !SourceForge.net-hosted CVS repositories, this can be [wiki:"CVS#Backups" done via rsync].  For projects hosted elsewhere, you may need to contact the repository administrator for a copy of the files. 
    25  1. Clean up any data in the copy of the CVS repository. Ensure that any data that shouldn't be imported isn't present in the RCS files.  Newer versions of cvs2svn require that the CVSROOT module be present, so you may want to use [http://svnbook.red-bean.com/en/1.5/svn.reposadmin.maint.html#svn.reposadmin.maint.tk.svndumpfilter svndumpfilter] after creation of the dump file to remove that directory from the import.  Data cannot be readily removed from a Subversion repository after being imported, unless you do another, filtered import in the future. 
    26  1. Convert the repository to a Subversion dump file using cvs2svn: 
    27    * Go to the directory at the root of the CVS repository 
    28    * Run the command: "`cvs2svn --dumpfile=svndump .`" 
    29  1. If the conversion generates an error message, follow the prompts that indicate what the problem is, and attempt to resolve them using one of the various options for cvs2svn (--trunk-only will drop all branches and tags, which will usually make the process painless if all you need is the trunk). 
    30  1. Compress the resulting SVN dump file (svndump), if you so desire, using zip, gzip or bzip2 (but do not tar it). 
    31  1. Follow the instructions for importing a Subversion dump file to finish the import. 
    32  
    33 = Importing a Subversion dump file = 
    34  
    35  1. [wiki:"Using rsync for backups" Backup your your current Subversion repository] if it has content. 
    36  1. Make sure that the name of the dump file only contains alphanumeric characters and a period (Example: svndump.gz is good, but projectname-svndump.gz is bad due to the dash). 
    37  1. Connect to our [wiki:"Shell service"] and run the sf-help command.  This will provide you with the information necessary to upload your dump file. 
    38  1. Upload the dump file to the [wiki:"Shell service#Accessingyourshellwithothertools" interactive shell]. 
    39  1. `adminrepo --checkout svn` will copy your repository to /svnroot/PROJECT so you can work with it from there. 
    40    * Use `adminrepo --help` for further information. 
    41  1. Decompress your dump file (e.g. gzip -d svndump.gz) 
    42  1. Use svnadmin load /svnroot/PROJECT < svndump to replace your current repository with your dump file.  This is roughly equivalent to deleting your current repository, and replacing it with the contents of your dump file. 
    43  1. Save your changes using `adminrepo --save`. 
    44  
    45  
    46  
     7If you need to access the old instructions, you can check [wiki:"Subversion import instructions?version=18" a previous revision of this page] 
    478 
    489= Getting Help =