Subversion Turns 1.5

2008-07-04 james 9 comments

Given the number of developers using Subversion, I’m surprised that no one on my blogroll has mentioned the new Subversion clients released in the last few weeks. Subversion, TortoiseSVN, and VisualSVN have all synchronized their version numbers on v1.5. I’ll talk about TortoiseSVN and Subversion changes. VisualSVN has some minor enhancements that basically expose the features introduced by Subversion 1.5. I’ll leave you to investigate them yourself.

TortoiseSVN

Let’s talk TortoiseSVN… You can get the new client from here. N.B. If you’re running 64-bit Windows (XP, Vista, or Server 2003/2008), make sure you grab the 64-bit installer. Shell extensions run directly inside Windows Explorer, which on 64-bit Windows is a 64-bit process. So you don’t get any WoW (Windows-on-Windows) goodness that allows 32-bit executables to run on 64-bit Windows.

New Overlays

The most noticeable change is the new overlay icons.

Unversioned and ignored files now have their own overlays, which I find especially useful. The problem in the past was that Windows only has 12 overlay slots available. These slots could be easily exhausted if you had multiple shell extensions installed, such as TortoiseSVN and TortoiseCVS. Tortoise clients now have a common overlay handler, which somewhat mitigates this problem.

Delete Unversioned Files

Over time, working copies tend to get crufty – at least mine do. I end up having extra unversioned files and directories – from tools, builds, half-implemented refactorings that you think better of – littering your working copy. Every once in awhile, I would just grab a clean working copy and delete the old. I then went to the trouble of creating PowerShell script to clean up my working copy. Now TortoiseSVN 1.5 includes this feature. Simply SHIFT-right click in your working copy and select “Delete unversioned items” from the context menu. N.B. This option only appears if you hold down SHIFT.

Other Improvements

The repository browser has also been completely reworked. It now shows a two pane view similar to Windows Explorer.

The revision graph has also been rewritten and is much easier to use.

Client-side caching has been improved, making TortoiseSVN more responsive. Merging has improved. Changelists have been added. Lots of new features. You can read the release notes for more information.

Subversion

Subversion has made a lot improvements, which can be found in the release notes. If you’re just running TortoiseSVN, you don’t need to install the Subversion binaries. TortoiseSVN includes the SVN libraries. You only need the Subversion client and/or server if:

You want to use Subversion from the command line via svn.exe and/or svnadmin.exe either directly or in scripts.
You are running a server using svnserve (svn://) or Apache (http:// or https://).

You can download the Windows client and/or server from a few different places, each with advantages and disadvantages:

CollabNet – On the positive side, the MSI installer is quick to get you up and running. It adds svn.exe to your path and, if you install the server, you can select between svnserve.exe (svn://) and Apache (http:// or https://) easily. On the downside, you have to register on the CollabNet site and the downloaded binaries do not include support for Berkley DB, only FSFS. FSFS is the default for new repositories, but if you’ve got some older repositories around, they’re probably BDB. The CollabNet binaries complain bitterly about BDB repositories: “svnadmin: Failed to load module for FS type ‘bdb'”. Honestly I would recommend staying away from this package.
Tigris – Scroll down to svn-win32-1.5.0.zip and grab that. It includes both FSFS and BDB support, but you’re on your own configuring svnserve.exe. It’s not that hard and I document the steps here. This package is great if you just want to run svnserve.exe to access your repositories via svn://. If you want to run Apache to enable access your repositories over http:// and https://, you’re on your own to download and configure Apache. If you want to do that, then I recommend…
VisualSVN Server – Although VisualSVN (the Visual Studio add-in) is a commercial product, VisualSVN Server is completely free. This is the easiest way to get a Subversion server up and running with Apache. You can go from a clean Windows box to a working Subversion server in under 10 minutes. As an added bonus, it includes a MMC management console.

Upgrading the Repository Format (optional)

Although Subversion 1.5 can work with older repository formats, some of the new features, such as merge tracking, require you to upgrade your repository to the latest format. (See “Compatbility Concerns” in the release notes for full information regarding required client, server, and repository versions for various features.) Subversion will not upgrade your repository automatically. If you want to use the new features requiring a repository upgrade, you must run the following command:

svnadmin upgrade <PATH_TO_REPO>

where <PATH_TO_REPO> is the physical path and not a URL.

If you need to upgrade a lot of repositories and you’ve got PowerShell installed, you can do the following (assuming your repository root is c:\SrcRepos):

cd \SrcRepos
dir -name | foreach { svnadmin upgrade $_ }

Cyrus SASL and NTLM

TortoiseSVN and svnserve now include Cyrus SASL (Simple Authentication and Security Layer) support, which allows you to use a variety of authentication/encryption mechanisms, most importantly for Windows users – NTLM and Kerberos. Subversion clients and servers prior to 1.5 only support ANONYMOUS and CRAM-MD5. You’ll need to be running v1.5 on both sides of the wire to use the other protocols. The ZIP package from Tigris includes NTLM, but not Kerberos. If you want to use Kerberos, you’ll have to download saslGSSAPI.dll and add it to your sasl-plugins directory.

WARNING: I spent the better part of an afternoon trying to get svnserve.exe authenticating against the local Security Account Metabase (SAM) without success. (i.e. Using local Windows accounts to authenticate Subversion users.) The documentation is sparse to non-existent. I was able to get SASL to read its configuration and load the NTLM plug-in, but I could never successfully authenticate. Even with the correct username/password, it just prompted me again. It could be a problem with SASL defaulting to NTLMv1, which Vista disables by default for security reasons. If I figure out how to make this work, I’ll post a solution…

.NET Tools none

#1 | Written by Ivan Zhakov about 16 years ago. Reply

Please note that VisualSVN Server supports Windows authentication and authorization (!).
#2 | Written by Mark Phippard about 16 years ago. Reply

The CollabNet binaries are aimed at our CollabNet Subversion customer and include the components that we feel provide the most reliable version of Subversion and the version we can maintain our SLA’s with. BerkeleyDB is very reliable, IF you know what you are doing. You do not have to troll the Subversion users@ mailing list and other forums for long to see all of the problems people have with BDB repositories. So we made the decision not to include it in our binaries.

You also do not mention in your blurb that the CollabNet Subversion package will automatically setup svnserve or Apache to run as a service, and also includes ViewVC which it will also automatically configure for you.
#3 | Written by James Kovacs about 16 years ago. Reply

@Ivan – That’s excellent that Windows auth just works! Yet another reason to give VisualSVN Server a try. I’ve used it before and like the fact that it’s a drop-in solution. Although Ivan didn’t mention it because he’s probably too modest, VisualSVN is an absolute must-have if you’re using Subversion and Visual Studio. I can’t recommend it enough.

@Mark – I did like the fact that the CollabNet Subversion package set up svnserve and/or Apache for me as it used to be a lot more complicated. I was ready to write a glowing review of the package when I noticed that quite a few of my repositories were no longer accessible with "svnadmin: Failed to load module for FS type ‘bdb’". I expected CollabNet’s package to be a drop-in replacement and it wasn’t. I can fully understand your position in wanting to provide an excellent, headache-free experience for your customers, though I respectfully disagree with CollabNet’s strategy. Yes, BerkeleyDB is more complicated. I’ve had problems with it in the past, though I solved them. FSFS just works. So I completely agree with the decision to make FSFS the default for new repositories. My problem with the CollabNet Subversion binaries is that you will have many customers with some older BerkeleyDB-based repositories. (e.g. Me! Though this will be true of any long-term user of Subversion as BDB was the default for a long time.) The package breaks backward compatibility badly without so much as a warning on the download page. IMHO you either need to provide a clear warning on the download page that BDB isn’t supported or add it back in for backward compatibility.
#4 | Written by Robz about 16 years ago. Reply

I am guessing I am not in your blogroll… 🙁

http://ferventcoder.com/archive/2008/06/23/subversion-1.5.0-released.aspx
#5 | Written by James Kovacs about 16 years ago. Reply

@Robz – Contrary to popular belief, I don’t subscribe to everyone’s blog. I’ve added yours to my reader. You’ve got a month to keep me interested… :^P
#6 | Written by Denver about 16 years ago. Reply

Have you found out more on the topic of setting up Kerberos/NTLM?
#7 | Written by James Kovacs about 16 years ago. Reply

@Denver – No, I haven’t investigated more.
#8 | Written by MIke about 16 years ago. Reply

Why is it that the graphics of open source projects suck so bad? The new overlay icons ore horrible. Sheesh.
#9 | Written by James Kovacs about 16 years ago. Reply

@Denver – Come to think of it, one of the developers of VisualSVN Server informed me that they support Windows auth out-of-the-box. I haven’t investigated, but I’m going to be using it for a client project coming up. Plus VisualSVN Server is free. (VisualSVN itself costs money, but is honestly worth every penny I paid for it.)

@Mike – Maybe developers have bad taste. Personally I like the new icon set.