Subversion client setup

FishEye can communicate with any server running Subversion 1.1 or later, but it needs to use a Subversion client to do so. You must configure FishEye to use one of the two clients specified below, either the Native or the JavaSVN client.

Note

Using the file:// protocol to access your Subversion repository can be much faster than the other network protocols. For that reason, we recommend using a native Subversion client if possible.

Native client

FishEye can use a native Subversion client installed on your system, but your client needs to be version 1.2 or later, and must include the JavaHL bindings. FishEye can use all of the protocols supported by your native client.

The JavaHL bindings include a Java .jar file (typically named javasvnhl.jar) and a dynamic library (such as libsvnjavah-1.so or libsvnjavahl-1.dll). FishEye must be configured so it can find both the .jar and dynamic library.

If the JavaHL dynamic library is in your "library path" (such as %PATH% on Windows), then FishEye will automatically find it. Otherwise you can tell FishEye where it is (with one caveat, see below), or set the FISHEYE_LIBRARY_PATH environment variable before starting FishEye.

Pre-compiled native clients are available from the Subversion site.

Native client configuration

You can configure your Subversion client in the Server Settings section of the FishEye admin screens, or by editing the <svn-config> section of your config.xml. If you change these settings, you need to restart FishEye.

JAR	The path to the JavaHL .jar.
Dynamic library	The path to the dynamic library, if it is not already on your system's library path. Note: due to a bug in earlier versions of the JavaHL bindings, setting this value is ineffective unless you are using a Subversion client 1.2.3 or later.

JavaSVN client

If you have difficulty acquiring a native Subversion client which contains the JavaHL bindings, you can try to use JavaSVN (which is a 100% Java Subversion library).

Note: there are known problems in JavaSVN 1.0.0 and earlier. Please use a later release. (At the time of writing, JavaSvn 1.0.1 has not yet been released, but it should address these issues.)

To use JavaSVN:

Disable the native client, by clearing the "JAR" and "Dynamic Library" fields described below (or remove the <svn-config> element from your config.xml file).
Download JavaSVN from the above url.
Unzip the JavaSVN download, and copy all the .jar files to FISHEYE_HOME/lib

Note

JavaSVN does not support the file:// protocol. If you want to use the file:// protocol then you must use a native client.