This page last changed on Jun 29, 2009 by pkamal.
On this page:
Java Environment and Operating System
Java Runtime |
A JDK or JRE version 1.5 or greater. (Solaris requires 1.5.0_15 as a minimum) 
There is a known issue with FishEye 1.6.x and the JDK/JRE versions 1.6.0 through 1.6.0u3(update 3). FishEye requires version 2.1 of a component called JAXB, but these versions of the JDK/JRE include JAXB2.0. To avoid this issue, upgrade your JDK/JRE to version 1.6.u4(update 4) or later. |
 | We strongly recommend the use of a 32-bit JDK/JRE rather than a 64-bit JDK/JRE. 64-bit JDK/JREs will consume the available RAM more rapidly, and this may result in poor performance. |
You can download a Java Runtime for Windows/Linux/Solaris.
On Mac OS X, the JDK is bundled with the operating system.
Once you have installed the JDK, you need to set the JAVA_HOME environment variable.
Note: There appeared to be a problem with some releases of the JRockit JVM that causes corrupted caches in FishEye. If you use JRockit, we recommend you use the latest JRockit 6 JVM. This problem has been confirmed on
- JRockit 5.0 JVM (R25.0.0-75)
- JRockit 5.0 JVM (R27.3.0) |
Operating System |
FishEye is a pure Java application and should run on any platform provided the above requirements are satisfied. |
Platform Hardware Requirements
FishEye should ideally run on a standalone dedicated server. The most important aspect for a large-repository deployment will be I/O speed. You definitely want a fast local HDD for FishEye's cache (not NFS or SAN).
Component |
Specifications |
CPU |
1.8GHz or higher, a single core is sufficient. More cores or higher GHz will result in better load-handling ability. |
RAM |
1GB minimum, 2GB will provide performance "headroom". Your Java heap should be sized at 512MB with the FISHEYE_OPTS environment variable, adjustable up to 1024MB depending on performance. |
Disk space |
In the worst case scenario, your budget for free disk space should meet or exceed three times the size of your repository data. For example, with 80GB of repository data, you would ideally have 3 x 80GB, hence 240GB of free disk space dedicated to FishEye. However this will not usually be necessary, especially if you have a number of sizeable binary files inside your repository (which increase its size but have a relatively small impact on the index).
 | Fisheye 1.6.* requires far more disk space. Please refer to FE-1094 |
|
I/O |
FishEye's input/output is an important element of its overall performance. If FishEye accesses your repository remotely, make sure that the throughput is maximum and the latency minimum (ideally the servers are located in the same LAN, running at 100Mbps or faster). |
 | While some of our customers run FishEye on SPARC-based hardware, Atlassian only officially supports FishEye running on x86 hardware and 64-bit derivatives of x86 hardware. |
Version Control System
At this time, FishEye supports the following source code management (SCM) systems:
Subversion (server) |
FishEye can communicate with any repository running Subversion 1.1 or later. |
Subversion (client) |
FishEye now bundles the SNVkit client, which becomes the default Subversion interface. An alternative is to use the native subversion client, using JavaHL bindings. Please see Subversion Client Setup for more information. |
Perforce (client) |
FishEye needs access to the p4 client executable. Due to some problems with earlier versions of the client, we recommend version 2007.3 or later. |
CVS |
If you are using CVS, FishEye needs read-access to your CVS repository via the file system. It does not support protocols such as pserver at the moment. |
Support for other version control systems (such as ClearCase) is planned for future releases. Let us know what SCM system you would like to see supported by logging and/or voting for a JIRA issue.
Web Browser
Fisheye has been tested with Firefox 3, Internet Explorer 7, and Safari 4.
IE6 is NOT supported. Fisheye should work with most modern browsers.
 | Font size (Especially for Linux users.) For best results you may want to tweak your default monospace font and font-size. The default browser font is usually Courier New which can be hard to read in some browsers. We recommend choosing the same font you use in your IDE and selecting a font size approximately 2 points larger than your variable width font. Firefox 3, Internet Explorer 7 and Safari all have excellent font rendering. It is worth taking some time to tweak your fonts for the best experience. |
Deployment
FishEye/Crucible is currently a standalone Java program. It cannot be deployed to web application servers such as WebSphere, Weblogic or Tomcat.
Single Sign On with Atlassian Crowd
FishEye is bundled with the Crowd 1.3 client library, and therefore is intended to operate with Crowd 1.3 or later.
|