How to use Subversion and FitNesse together

Firstly, see my blog entry for the reasons behind doing this, etc. This page is really just to host the files...

Building and installing

• If you haven't already got Subversion installed, do so now. You'll need to run svnserve or the Apache module, as JavaSVN doesn't currently support file:/// URLs.
• If you haven't already got Ant installed, do so now.
• Download fitnesse_src20050731.zip and unpack it.
• Download an appropriate release of JavaSVN. I've only used 1.02 for testing, and 1.03 had just come out when I started writing this page (Feb 14th 2006), but I'd expect the API to be stable anyway. The standalone version is all you need.
• Download the new/modified source files.
• Unpack both distributions, and copy javasvn.jar, javasvn-javahl.jar and ganymede.jar into the lib directory of the FitNesse code tree.
• Unpack the new/modifed files from the FitNesse root directory and the files should simply drop into the appropriate place.
• Build FitNesse (run ant jar from the FitNesse root directory).
• You now have a new copy of fitnesse.jar in the dist directory. At this stage, I find it easiest to download the "ready-to-go" distribution of FitNesse and unpack it.
• Copy the new fitnesse.jar along with the JavaSVN jar files (the ones you copied earlier) to the new FitNesse distribution root, and get a command line (or terminal window) in that directory.
• Create a plugins.properties file such as the following:

  VersionController=fitnesse.wiki.SvnVersionController SvnUrl=svn://localhost/fitnesse SvnUser=user SvnPassword=password

  (Hopefully it's obvious which bits you need to change.)
• Edit run.bat or run.sh (depending on whether you're running on Windows or Unix) to include the JavaSVN jar files in the classpath.
• Now for the slightly ugly part - getting FitNesseRoot under source control. There may well be a better way of doing this, but I'm a relative novice at Subversion. The following is for Windows - make the obvious changes for Unix:

  svn import -N FitNesseRoot svn://localhost/fitnesse/FitNesseRoot -m "Adding FitNesseRoot" delete FitNesseRoot\content.txt delete FitNesseRoot\properties.xml delete FitNesseRoot\properties svn co -N svn://localhost/fitnesse

• Start up FitNesse with run.bat or run.sh (specifying the port if necessary). Try editing a file, and then look in the Subversion repository logs, and you should find the appropriate information. If you use authentication in FitNesse, the author of the revision should appear as the log message. You should find there are no zip files in the FitNesse working directories. Note that the files directory is not currently versioned.