ServiceSvn - IT

All about IT at IAC
IT

Tools

General Info

About IT Web

You are here: IT » ServiceSvn
---+!! How to use Subversion
%TOC%

---++ Get a repository

The Subversion repositories are stored and accessible on *https://svn.iac.ethz.ch*. You can ask for a *user repository* which will be only accessible by you. Or you can ask for a *project repository* which can be accessible by other users too. If your repository should be accessible without authentication (anonymous read access) ask for a *public repository*. Send a mail to urs.beyerle@env.ethz.ch to ask for a new repository.

For a *project and public repository* the following information is needed:
   * (Folder) name of the repository.
   * Usernames of the users that have access to the repository. You may want to distinguish between read and write access.
   * For external users (not ETH members), please provide their name, email address and a possible username.

It's possible to enable *email notification* for repositories. If enabled, the users will get an email in case something was changed in the repository (file added, file modified, etc).


---++ Location of repositories

   * Repositories can be found under *https://svn.iac.ethz.ch/repos/*
   * The repositories are located in following folders
      * *users*: Repositories related to a IAC user (only the owner will have access to his repository)
         * ==https://svn.iac.ethz.ch/repos/users/username== - this is the standard repository for a user 
      * *projects*: Repositories related to a project (several users may have access to these repositories)
         * ==https://svn.iac.ethz.ch/repos/projects/projectname== - each project has its own repository 
      * *pub*: Public repositories which can be read by everybody (anonymous user)
         * ==https://svn.iac.ethz.ch/repos/pub/projectname== - each project has its own repository 


---++ Browse the repositories

You can browse the repositories with a normal web browser. Two different views are available:

   * View with [[http://www.websvn.info/][WebSVN]], which offers diff view, colorization of file listings, blame view, log message searching, RSS feed support and more.
      * https://svn.iac.ethz.ch/websvn/repos/ (restricted IAC repositories, need authentication to view)
      * https://svn.iac.ethz.ch/websvn/pub/ (public IAC repositories, no authentication needed)

   * Classic view of repositories
      * https://svn.iac.ethz.ch/repos/


---++ Subversion clients

   * __Linux__: *svn* command line tool. 
   * __Windows__: !TortoiseSVN download at [[http://tortoisesvn.tigris.org/][tigris.org]] 
   * __Mac__: [[http://www.lachoseinteractive.net/en/community/subversion/svnx/features/][SvnX]]



---++ Access the repositories with !WebDAV

With !WebDAV you can access the repository like a normal file system. If you remove, add or modify a file, a new revision of your repository is automatically created. 

   * *Linux*: Use konqueror and point it to =webdavs://iacsvn.ethz.ch/repos/path_to_your_repo=
   * *Windows*: Use Internet Explorer

---++ Email notification

   * It's possible to setup email notification for a repository. In case you would like to enable email notification contact iac-it@env.ethz.ch


---++ Working with Repositories using svn command

   * To *checkout (co)* your repository into a folder (my_repo), type  
 <verbatim>
svn co https://svn.iac.ethz.ch/repos/users/beyerleu my_repo 
</verbatim> 
 Now you have a so called *working copy* of your personal repository in the folder =my_repo=

   * You can also checkout only one folder of your repository, for example
 <verbatim>
svn co https://svn.iac.ethz.ch/repos/users/beyerleu/matlab matlab
</verbatim> 

   * You may want to check out your project repository into a local folder having the same name as the repository
 <verbatim>
svn co https://svn.iac.ethz.ch/repos/projects/projectname projectname
</verbatim>

   * The above commands will checkout the latest revision. In case you want to checkout an older revision, use the option --revision. To checkout revision 14 type
 <verbatim>
svn co --revision 14 https://svn.iac.ethz.ch/repos/projects/projectname projectname-r14
</verbatim>

   * Now change to your working copy folder
 <verbatim>
cd my_repo 
# or
cd projectname
</verbatim>

   * To show *information* about your checked out repository
 <verbatim>
svn info
</verbatim>

   * To *add* a file to your working copy
 <verbatim>
touch testfile 
svn add testfile 
</verbatim>

   * View the *status* of your working copy
 <verbatim>
svn status
svn st
</verbatim>

   * It's *highly recommended* to use instead of the Linux file commands (rm, mv, cp) the svn commands to delete, rename ore copy files!

   * *Delete* a file 
 <verbatim>
svn delete testfile 
</verbatim>

   * *Copy* a file
 <verbatim>
svn cp file copy_of_the_file
</verbatim>

   * *Rename* a file
 <verbatim>
svn mv oldfile newfile
</verbatim>

   * *Commit / check-in (ci)* your changes to the repository on the server
 <verbatim>
svn ci -m "testfile created"  
</verbatim>
  If you don't define a comment with the option *-m*, your default editor will be open to let you write a comment. 
  You can define your default editor by setting the =$EDITOR= environment variable.

   * Everything you do a check-in the revision number of your repository is increasing by one.
 
   * *View changes* between your working copy and the repository on the server
 <verbatim>
svn diff
svn diff <file>
</verbatim>
 Comparing current folder content with content of an older revision (-r 100) or from 2010-01-15
 <verbatim>
svn diff -r 100
svn diff -r {2010-01-15}
</verbatim>

   * *Update* your local copy against the repository on the server
 <verbatim>
svn update
svn up
</verbatim>

   * You may want to see first what will be updated (use svn status with -u option)
 <verbatim>
svn st -u
</verbatim>

   * *Restore* ==&lt;file&gt;== to version stored in the repo (un-do local edits in your working copy) 
 <verbatim>
svn revert <file>
</verbatim>

   * *Restore* ==&lt;file&gt;== to an older revision, for example revision 100: 
 <verbatim>
svn up -r 100 <file>
</verbatim>

   * *Go back* to an older revision, for example revision 80: 
 <verbatim>
svn up -r 80
</verbatim>
 or to the status of a specific date, for example 2010-01-15
 <verbatim>
svn -r {2010-01-15} up
</verbatim>

   * In order to start from scratch, you can check out also an older revision of your repository
 <verbatim>
svn co -r {2009-10-01} https://beyerleu@svn.iac.ethz.ch/repos/users/beyerleu my_repo.2009-10-01
</verbatim>

   * Make a file *executable* that was not executable before. Note, there is no "svn chmod" commando, use instead
 <verbatim>
svn propset svn:executable ON <file>
</verbatim>

   * List the *Logs* 
 <verbatim>
svn log
</verbatim>
 Only list logs for a specific file
 <verbatim>
svn log <file>
</verbatim>

   * Get *help*
 <verbatim>
svn help
svn help <subcommands>
svn help cp
</verbatim>


For more info about common tasks see http://svnbook.red-bean.com/en/1.4/svn.tour.cycle.html



---++ Important note about security

Per default the Linux svn client is caching your password. This can be quite useful, since you don't have to type in your password every time you check out or commit a change. However, the password is stored in *cleartext*. Per default the folder storing the password =~/.subversion/auth= is only readable by you. You should definitely not change this. 

Nevertheless, I would recommend to *disable the password caching of the svn command completely* by uncomment the following line in your =~/.subversion/config= file.
 <verbatim>
store-passwords = no
</verbatim>

Afterwards, remove all stored svn passwords with
 <verbatim>
rm ~/.subversion/auth/svn.simple/*
</verbatim>


<!--
   * Set DENYTOPICVIEW =
-->
View
Changed by UrsBeyerle on 12 Jun 2014 - 11:58 - r23
Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Wiki? Send feedback
Syndicate this site RSS ATOM