1. European Organization for Nuclear Research Source Control Management Service (Subversion) Brice Copy, Michel Bornand EN-ICE 13 May 2009

2. European Organization for Nuclear Research 2 Overview What is source control management (SCM) ? Subversion (SVN) at CERN SVN for EN-ICE SVN for Concurrent Versioning System (CVS) Developers Installation Procedure Recommended Project Structure What you need to do next

3. European Organization for Nuclear Research 3 What is Source Control Management ? A.k.a. Version Tracking Revision Control Code Management It’s about CHANGE

4. European Organization for Nuclear Research 4 What is Source Control Management ? When a new version is released, it answers questions like : What has changed ? Since when has it been this way ? Who (on earth) changed this ? Why (in good heavens) did they do it ? (What can we do to bring it back the way it was ?)

5. European Organization for Nuclear Research 5 What is Source Control Management ?

6. European Organization for Nuclear Research 6 Subversion (SVN) at CERN The SVN service is a source control management system, available for all CERN projects SVN is run at CERN by the IT Department …As a replacement for CVS (retired end 2009) IT manages and supports SVN servers … But no support for clients

7. European Organization for Nuclear Research 7 SVN for EN-ICE Support for clients Recommended, cross platform client RapidSVN Help with other clients (TortoiseSVN, Subclipse …) Group-wide repository (en-ice-svn) For non confidential projects (e.g. no passwords) Only accessible from the CERN network SCM guidelines … for tagging / branching … for a standard project layout

8. European Organization for Nuclear Research 8 EN-ICE-SVN repository Accessible at https://svn.cern.ch/en-ice-svn Organised in three areas Applications (e.g. GCS) Tools (e.g. JCOP framework) Utilities (e.g. PVSS deployment scripts) Adopts a standard project layout To ease maintenance, help newcomers To ease recursive file searches

9. European Organization for Nuclear Research 9 SVN for CVS Developers - Concepts Similarities Same operations (checkout, update, commit, merge) Supports tags and branches Improvements Supports refactoring (move, rename, delete) Supports transactions (all or nothing) Access over HTTPS (easier setup, firewall friendly) Understands symbolic links on your file system

10. European Organization for Nuclear Research 10 SVN for CVS Developers - Guidelines Tagging and Branching Replaced by a single operation “copy” For “en-ice-svn”, please place your tags under “/tags” and your branches under “/branches” Each commit generates a new “revision number” All files part of this commit are marked with this number Files do not have individual revision numbers like in CVS, they receive the “revision number” from the last commit Do not be afraid of refactoring anymore

11. European Organization for Nuclear Research 11 RapidSVN Installation

12. European Organization for Nuclear Research 12 www.rapidsvn.org

13. European Organization for Nuclear Research 13 RapidSVN Use at CERN

14. European Organization for Nuclear Research 14 Repository - Checkout

15. European Organization for Nuclear Research 15 https://svn.cern.ch/... C:\...

16. European Organization for Nuclear Research 16

17. European Organization for Nuclear Research 17 Your NICE credentials

18. European Organization for Nuclear Research 18

19. European Organization for Nuclear Research 19 Recommended Project Structure Standardize the location of : – Source files (support for multiple programming languages) – Resources (images, binaries), Configuration files – Sub-projects (modules) Caters for : – C++ / Java projects – PVSS projects – PLC projects Ease collaboration between sections

20. European Organization for Nuclear Research 20 Getting started with SVN : New project Email en-dep-ice-svn-admins@cern.ch to request access, specifying the project you want to adden-dep-ice-svn-admins@cern.ch Install recommended SVN client Checkout https://svn.cern.ch/en-ice-svn/ https://svn.cern.ch/en-ice-svn/ Perform changes, commit Create branches at – /branches/ /

21. European Organization for Nuclear Research 21 Getting started with SVN : Existing CVS project Email en-dep-ice-svn-admins@cern.ch to request access, specifying the project you want to migrateen-dep-ice-svn-admins@cern.ch SVN Admins will contact you to discuss migration requirements – Full history or CVS HEAD only – Clean up and reorganisation – Which tags / branches need to be carried forward You can then work the same way as new SVN projects

22. European Organization for Nuclear Research 22 Links EN-ICE support page: http://en-dep.web.cern.ch/en-dep/Groups/ICE/Subversion CERN Subversion central service: http://cern.ch/svn