Differences

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

--- noresm:svnnorstorehowto [2014-12-16 17:48:21]
ingo.bethke@gmail.com
+++ noresm:svnnorstorehowto [2022-05-31 09:29:32] (current)
@@ Line 1: / Line 1: @@
-====== Subversion on NorStore how-to ======
+====== Subversion how-to for NorStore ======
 ===== How it works =====
-NorStore uses the [[http://svnbook.red-bean.com/en/1.7/svn.serverconfig.choosing.html#svn.serverconfig.choosing.svnserve|svnserve]] server solution to connect local svn repositories to the internet.
+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.
-For every new repository, an svnmerge demon is started on the NorStore node noresg.norstore.uio.no as a background process. The repository has the URL <nowiki>svn://noresg.norstore.uio.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 =====
-To administer svn repositories on NorStore, following prerequisites must be fulfilled:
+To create and manage a repository, you need a user account at NorStore which is member of the ns2345k project.
-  * you must have a user account at NorStore
-  * your NorStore user account must 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 (consisting of a user-name with corresponding password) which in general have no relation to NorStore user accounts.
-  * your NorStore user account must have access to noresg.norstore.uio.no
+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.
-Otherwise, the repository administrators have full flexibility to grant read/write access to the repositories to external users (i.e., the normal use of the repositories does not require a NorStore account).
+===== 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 =====
+Log on to ''norstore.uio.no'' via ssh.
+Change directory to ''/projects/NS2345K/svn''.
+Create a new svn repository with
+  svnadmin create testrepo
+where ''testrepo'' is to be replaced with the repository name.
+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.
+The default is read/write access for authenticated users and no access for anonymous.
+To limited access to read for authenticated users, change
+  # auth-access = write
+to
+  auth-access = read
+To grant anonymous read, change
+  # anon-access = none
+to
+  anon-access = read
+The users of the repository are defined in ''testrepo/conf/passwd'' with user name and password, e.g.
+  [users]
+  harry = harryssecret
+  sally = sallyssecret
+  guestuser = friendly
+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.,
+  [/]
+  harry = rw
+  guestuser = r
+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 =====
+After taking the repository online, the URL of the repository ''testrepo'' is <nowiki> svn://noresg.norstore.no/testrepo </nowiki>
+To checkout the repository, do
+  svn co svn://noresg.norstore.no/testrepo
+Change directory to ''testrepo''
+  cd testrepo
+Create a dummy file and mark it for adding
+  echo test > README
+  svn add README
+Commit the repository
+  svn commit -m "my commit message"