Background

Subversion is a version control system. It can run as either it’s own server (svnserve), or as an Apache module (mod_dav_svn.so).

When using the mod_dav_svn module for Apache, and doing an svn copy operation on the repository itself can fail if the VirtualHost configuration for subversion is not correct. Put simply, if Apache itself and mod_dav_svn are serving content from the same path, then conflicts can occur. Apache can get confused if it attempts to serve a physical file instead of routing the request through mod_dav_svn.

“svn copy …” operations will fail, while “svn update …”, “svn commit …”, and “svn checkout …” operations work fine.

Detail of the problem, diagnosing the problem, and the fix are below.

Problem

Repository checkouts (svn co …) and commits (svn ci …) work fine and throw no errors, but svn trunk copying operations fail “svn copy …/trunk …/tags/x.x” with “svn: Repository moved permanently to ‘…’; please relocate”.


$ svn co https://svn.test.com/myproject/trunk myproject
... (checkout progress)
Checked out revision [x].
$ svn ci myproject
Committed revision [x].
$ svn cp https://svn.test.com/myproject/trunk https://svn.test.com/myproject/tags/x.x
svn: Repository moved permanently to 'https://svn.test.com/myproject/'; please relocate


Diagnostics

To diagnose the problem, first make sure the local checkout urls are correct.


$ svn info myproject
...
URL: https://svn.test.com/myproject/trunk
Repository Root: https://svn.test.com/myproject


The Repository Root should match the root url of the project repository that you are working with because the svn commit above worked. However, if they don’t match, then use svn switch to move the url that your local checkout is linked to:


$ svn switch --relocate [OLD URL] [NEW URL] myproject
$ svn cp https://svn.test.com/myproject/trunk https://svn.test.com/myproject/tags/x.x


If relocating the base url of the checkout (svn switch –relocate …) does not fix the problem, but checkouts and commits work fine, the next step is to look at the virtual host configuration in Apache for the subversion module. This is where I found my problem.

The Cause

The file path of the subversion repository was within public_html, so it had a physical path that was identitical to it’s url path.


$ ls public_html
repos
$ cat /etc/httpd/conf.d/subversion.conf
<VirtualHost 127.0.0.1:443> #YOUR IP ADDRESS:PORT
DocumentRoot /home/svn/public_html #YOUR WEBROOT PATH
...
<Location /repos>
DAV svn
SVNParentPath /home/svn/public_html/repos #YOUR REPOSITORY PATH
...
</Location>
</VirtualHost>


The problem is that the Location is an actual physical filepath, not an alias. So, Apache isn’t sure whether to attempt to serve the physical file itself, or to pass the request through to mod_dav_svn. Most of the time mod_dav_svn wins and Apache forward the request through. However, “svn copy” must work slighly differently, and Apache attempts to serve the request itself, rather than pass it through mod_dav_svn. The request then fails and svn errors out with the “svn: Repository moved permanently to ‘…’; please relocate” message.

A reader of this blog also pointed out that this can also happen if you have an overlap between a URL path alias and the repos folder itself:


#Alias /repos “/srv/svn/repos” #Commenting this line out fixed the problem


Fix

The fix is to 1) change the Apache configuration, and 2) change the physical path to the repository so that it does not match the url. This way, Apache will never attempt to serve a physical file itself, and will instead forward the requests to mod_dav_svn.

Edit /etc/httpd/conf.d/subversion.conf


<VirtualHost svn.test.com:443>
DocumentRoot /home/svn/public_html
...
<Location /repos>
DAV svn
SVNParentPath /home/svn/repos #NOTE THAT repos IS NOW OUT OF THE PHYSICAL WEBROOT PATH
...


Move the repository directory out of the physical webroot path and restart Apache.


[svn /home/svn]$ mv public_html/repos .
[svn /home/svn]$ sudo service httpd restart


All your “svn copy” operations should work now.

Technorati Tags: apache, repository moved permanently, subversion, svn copy