Subversion Client

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 SVNKit client.

If you do not have all the necessary components (see below) of the native client installed, you may find it easier to use the SVNKit client.

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 the 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 warning - 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 Administration screens, or by editing the <svn-config> section of your config.xml. If you change these settings, you need to restart FishEye.

SVNKit Client

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

Note: Prior to SVNKit version 1.1.0, SVNKit was called JavaSVN. We recommend using the 1.1.0 version or later, as it is much improved over earlier releases.

To use SVNKit:

• Disable the native client, by clearing the 'JAR' and 'Dynamic Library' fields described above (or remove the <svn-config> element from your config.xml file).
• Download SVNKit from the above URL.
• Unzip the SVNKit download, and copy all the .jar files to $FISHEYE_INST/lib.

SVNKit sometimes has problems working with Subversion servers which are running older versions, such as 1.1.x. If you see exceptions such as those below in FishEye's log, you will need to either swap to native JavaHL layer or upgrade your subversion server to 1.3 or later.

Example exceptions:

• SEVERE: assert #B
• Checksum mismatchwhile reading representation: