구차니의 잡동사니 모음

5) Configure permissions for the repository

• Open with notepad the repository configuration C:\SVNREPOSITORY\conf\svnserve.conf
  and paste just the following lines (remove everything else):
  [general]
  anon-access = none
  auth-access = write
  password-db = passwd.conf
  authz-db = authz.conf
  #realm = My First Repository
  
  Please note that I renamed "passwd" to "passwd.conf" and "authz" to "authz.conf" both
  in the config file here, and in the filesystem too, so I can just associate the conf extension with notepad and make my life easier.
  
  Note also that when a realm is not specified, it will be assumed to be the repository guid (created when you created repository). Realms should be unique among different repositories, unless you want to share the same permissions among them.
• Rename authz to authz.conf
• Rename passwd to passwd.conf
• Open passwd.conf with notepad and put some users/passwords by pasting the following lines (remove everything else):
  [users]
  admin = qwerty147
  ricardo = pwd123
  marcelo = pwd456
  joao = pwd789
• Now open authz.conf with notepad and paste just the following lines (remove everything else):
  # guests will have read permission in all repository
  # writers must include all non-admin users who must have write
  #    permission on some folder (read permission on root is needed for that)
  [groups]
  admins = admin, ricardo
  writers = marcelo
  guests = joao
  project1 = marcelo
  
  [/]
  @admins = rw
  @writers = r
  @guests = r
  * =
  
  # please note that permissons (ex: admins group) don't propagate from root to subprojects
  [/Project1]
  @project1 = rw
  @admins = rw
  * =
  
• Now you can try again mkdir:
  C:\>svn mkdir svn://localhost/Products
  Authentication realm: e9852c7c-f11f-1946-b4a8-49fa8b53a267
  Password for 'Ricardo': ******
  
  
  Please note that it will by default assume your username is the same as your windows login. If it is not, just put any password, and it will ask you for your correct username.
  
• If everything went ok you will get a message like "Committed revision 1"
  
  Congratulations! You have made your first change to the repository.
  
  Now let's create another folder: C:\> svn mkdir svn://localhost/Projects
  The password won't be asked this time, because it's cached for your user (Documents and settings\username\Application Data\Subversion\auth\)

Running svnserve

Now that svnserve is installed, you need it running on your server. The simplest approach is to run the following from a DOS shell or create a windows shortcut:

svnserve.exe --daemon

svnserve will now start waiting for incoming requests on port 3690. The --daemon switch tells svnserve to run as a daemon process, so it will always exist until it is manually terminated.

If you have not yet created a repository, follow the instructions given with the Apache server setup the section called “Configuration”.

To test that svnserve is working, use TortoiseSVN → Repo-Browser to view a repository.

Assuming your repository is located in c:\repos\TestRepo, and your server is called localhost, enter:

svn://localhost/repos/TestRepo

when prompted by the repo browser.

You can also increase security and save time entering URLs with svnserve by using the --root switch to set the root location and restrict access to a specified directory on the server:

svnserve.exe --daemon --root drive:\path\to\repository\root

Using the previous test as a guide, svnserve would now run as:

svnserve.exe --daemon --root c:\repos

And in TortoiseSVN our repo-browser URL is now shortened to:

svn://localhost/TestRepo

Note that the --root switch is also needed if your repository is located on a different partition or drive than the location of svnserve on your server.

Svnserve will service any number of repositories. Just locate them somewhere below the root folder you just defined, and access them using a URL relative to that root.

Run svnserve as a Service

Running svnserve as a user is usually not the best way. It means always having a user logged in on your server, and remembering to restart it after a reboot. A better way is to run svnserve as a windows service. Starting with Subversion 1.4, svnserve can be installed as a native windows service.

To install svnserve as a native windows service, execute the following command all on one line to create a service which is automatically started when windows starts.

sc create svnserve binpath= "c:\svnserve\svnserve.exe --service 

    --root c:\repos" displayname= "Subversion" depend= tcpip 

    start= auto

If any of the paths include spaces, you have to use (escaped) quotes around the path, like this:

sc create svnserve binpath= "

    \"C:\Program Files\Subversion\bin\svnserve.exe\"

    --service --root c:\repos" displayname= "Subversion" 

    depend= tcpip start= auto

You can also add a description after creating the service. This will show up in the Windows Services Manager.

sc description svnserve "Subversion server (svnserve)"

Note the rather unusual command line format used by sc. In the key= value pairs there must be no space between the key and the = but there must be a space before the value.