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, or set the FISHEYE_LIBRARY_PATH environment variable before starting FishEye.
Pre-compiled native clients are available for most platforms. The Subversion download page links to platform specific distributions. Ensure you get the binary that includes JavaHL bindings, as well as the standard package. Also ensure that the versions of the JavaHL and standard packages match.
svn-X.Y.Z-setup.exe and the JavaHL installer file is named svn-win32-X.Y.Z_javahl.zip where 'X.Y.Z' refers to the version number (for example, svn-win32-1.4.6_javahl.zip at the time of writing).Subversion for Fedora Linux:
For Linux systems using the yum package manager (such as Fedora Core 3 and above) you can type the following:
yum install subversion-javahl |
at the Linux command line interface to install the JavaHL bindings for Subversion. Note that this will also install the standard Subversion library, which is required.
Subversion for Ubuntu and Debian Linux:
For Linux systems using the apt-get package manager (such as Debian and Ubuntu) you can type the following:
apt-get install libsvn-javahl |
at the Linux command line interface to install the JavaHL bindings for Subversion. Note that this will also install the standard Subversion library, which is required.
There are two ways you can configure the path to your Subversion client: Via the FishEye user interface, or by editing the config.xml configuration file.
You can configure your Subversion client in the FishEye Administration screens, under Admin > Server Settings > Subversion Client.
JAR | The path to the JavaHL |
Dynamic library | The path to the dynamic library, if it is not already on your system's library path. |
An alternative method to using the FishEye user interface is editing the <svn-config> section of your config.xml. If you change these settings, you need to restart FishEye.
Windows Platform Example (change path locations as required)
<svn-config jar="C:\subversion\lib\svn-javahl.jar" jnilib="C:\subversion\lib\libsvnjavahl-1.dll"/> |
Mac OS X Platform Example (change path locations as required)
<svn-config jar="/opt/subversion/lib/svn-javahl/svn-javahl.jar" jnilib="/opt/subversion/lib/libsvnjavahl-1.dylib"/> |
Linux Platform Example (change path locations as required)
<svn-config jar="/usr/share/subversion/lib/svn-javahl.jar" jnilib="/usr/lib/libsvnjavahl-1.so"/> |
In general, using the JavaHL libraries should improve the speed of FishEye's indexing when compared to SVNKit, primarily because of the advantage of native code. However, some customers have experienced more peak memory usage (some more than 2GB) during indexing when using JavaHL implementations due to greedier processing. This is generally not a major concern, but your own performance requirements may vary.
If you need to allocate more than 2gb for the indexing to complete, please run Fisheye with a 64-bit JDK
