Differences

This shows you the differences between two versions of the page.

--- noresm:svnnorstorehowto [2014-12-19 12:33:12]
ingo.bethke@gmail.com
+++ noresm:svnnorstorehowto [2022-05-31 09:29:32] (current)
@@ Line 5: / Line 5: @@
 NorStore uses the [[http://svnbook.red-bean.com/en/1.7/svn.serverconfig.choosing.html#svn.serverconfig.choosing.svnserve|svnserve]] server solution to take local svn repositories online.
-On the NorStore node ''noresg.norstore.no'', a svnmerge demon is running as a background process. The demon serves repositories that are stored in NorStore's project work space in ''/projects/NS2345K/svn''. The svn repositories receive each a URL  <nowiki>svn://noresg.norstore.no/<repository name></nowiki>.
+On the NorStore node ''noresg.norstore.no'', a svnmerge demon is running as a background process. The demon serves repositories that are stored in NorStore's project work space in ''/projects/NS2345K/svn''. The svn repositories each receive an URL of form <nowiki>svn://noresg.norstore.no/<repository name></nowiki>
-===== Prerequisites for creating and managing repositories =====
+===== Prerequisites =====
-To create and manage a repository, you must
+To create and manage a repository, you need a user account at NorStore which is member of the ns2345k project.
-  * have a user account at NorStore
-  * be member in the ns2345k group
-The creator of a repository has the full flexibility to grant remote read/write access to external users. Once the repository is create, the use of the repository does not require a NorStore account. The repository creator can define svn users (an svn user consists of a user-name with corresponding password) that in general have no relation to NorStore user accounts.
+The creator of a repository has the full flexibility to grant remote read/write access to external users. Once the repository is create, the use of the repository does not require a NorStore account. The repository creator can define svn users (consisting of a user-name with corresponding password) which in general have no relation to NorStore user accounts.
 To start and stop the svn server, your NorStore user must in addition have access to noresg.norstore.no. Currently, this group contains following people: Alf Grini, Ingo Bethke, Thierry Toutain and Martin King.
+===== Start/stop server  =====
+Log on to ''noresg.norstore.no'' via ssh.
+To take all svn repositories online, do
+  svnserve -d -r /projects/NS2345K/svn --log-file /projects/NS2345K/svn/svnserve.log --pid-file /projects/NS2345K/svn/svnserve.pid
+An svnserve demon has now been started as a background process on noresg.norstore.no. The process id is logged in ''/projects/NS2345K/svn/svnserve.pid''.
+To take all repositories offline again, do
+  kill `cat /projects/NS2345K/svn/svnserve.pid`
 ===== Creating a new repository =====
@@ Line 25: / Line 35: @@
 Create a new svn repository with
   svnadmin create testrepo
-where ''testrepo'' is to be replaced with a name of your choice.
+where ''testrepo'' is to be replaced with the repository name.
-The new repository is now set up in ''/projects/NS2345K/svn/testrepo''.
+The new repository is now set up in ''/projects/NS2345K/svn/testrepo''
 ===== Customizing access rights =====
-Edit ''testrepo/conf/svnserve.conf'' for general customisation of access rights. IMPORTANT: Make sure to remove all leading blanks when activating an option.
+Edit ''testrepo/conf/svnserve.conf'' for general customisation of access rights. Important: Make sure to remove all leading blanks when activating an option.
 The default is read/write access for authenticated users and no access for anonymous.
@@ Line 50: / Line 60: @@
   sally = sallyssecret
   guestuser = friendly
-To activate the customisation, edit ''svnserve.conf'' and uncomment the line
+The user customisation is activated in ''svnserve.conf'' by uncommenting
   # password-db = passwd
 to
   password-db = passwd
 Further fine tuning of access rights can be done in ''testrepo/conf/authz''. E.g.,
-  [/projects/NS2345K/svn/testrepo]
+  [/]
+  harry = rw
   guestuser = r
-limits the access of the user ''guest-user'' to read-only access. The ''authz'' customisation is activated in ''svnserve.conf'' by uncommenting
+gives ''harry'' read/write access but limits the access of ''guestuser'' to read-only. The ''authz'' customisation is activated in ''svnserve.conf'' by uncommenting
   # authz-db = authz
 to
   authz-db = authz
+===== Remote access =====
-===== Taking a repository online/offline =====
+After taking the repository online, the URL of the repository ''testrepo'' is <nowiki> svn://noresg.norstore.no/testrepo </nowiki>
-Log on to ''noresg.norstore.uio.no'' via ssh.
-To take a repository with name ''testrepo'' online, do
-  svnserve -d -r /projects/NS2345K/svn/testrepo --log-file /projects/NS2345K/svn/testrepo/svnserve.log --pid-file /projects/NS2345K/svn/testrepo/svnserve.pid
-An svnserve demon has now been started as a background process on noresg.norstore.uio.no. The process id is logged in ''/projects/NS2345K/svn/testrepo/svnserve.pid''.
-To take the repository offline again, do
-  kill `cat /projects/NS2345K/svn/testrepo/svnserve.pid`
-===== Remote access to repository =====
-After taking the repository online, the URL of the repository ''testrepo'' is <nowiki> svn://noresg.norstore.uio.no/testrepo </nowiki>
 To checkout the repository, do
-  svn co svn://noresg.norstore.uio.no/testrepo
+  svn co svn://noresg.norstore.no/testrepo
-Change directory to ''testrepo'' with
+Change directory to ''testrepo''
   cd testrepo
-Create a dummy file with
+Create a dummy file and mark it for adding
   echo test > README
+  svn add README
-Commit the repository with
+Commit the repository
   svn commit -m "my commit message"