Adding a repository
Adding a repository to FishEye is a simple matter. Further configuration options are available once a repository is added.
FishEye needs to build an index and cache of your repository. This begins when you first enable a repository, and may take some time to complete.
FishEye currently supports the following SCM systems:
Common fields
| Name | A name for this repository. The name may contain alphanumeric, underscore, "-" or "." characters. Use "cvs" or "svn" if you can't think of a better name. |
| Description | A short description of this repository. |
| Enable immediately | Controls whether FishEye will immediately enable this repository, which starts the inital scan. If you wish to do some further configuration before this scan starts, then select "No". You can enable a repository later from the repository list. |
CVS
| CVS dir | The path to the CVS repository. This is often /usr/local/cvsroot. This is a path in the server's filesystem. |
| Charset | The character set used to interpret and display text files. |
Subversion
| SVN URL | The Subversion URL to your repository, such has svn://svn.foo.com/ or file:///var/svn |
| Path | The sub-tree within your repository FishEye should display. If this value is . (or empty), then the whole repository will be shown. |
| Block Size | Controls how many revisions FishEye will pull down from the repository in one batch. Larger values can reduce the time it takes for FishEye to scan your repository for changes, but use more memory. Smaller values can reduce the amount of memory FishEye uses during scans. The default is 400. |
| Svn Operation Timeout | Sets the timeout value that FishEye imposes on Subversion operations. Operations which exceed this value are terminated. The default for most operations is 1 hour. It can be changed to a different interval, for example to: 2 days, 10 hours, 20 minutes |
| Throttle connections-per-sec | If set, this allows FishEye to throttle how many connections it makes per-second to the SVN server. Many systems use inetd/xinetd to service the svnserve protocol. xinetd has, by default, an incoming connection limit which can cause FishEye to disrupt other svnserve-based connections. The default is blank (do not throttle). |
| Charset | The character set used to interpret and display text files. |
| Access Code | The Access Code for the fisheye.access property on the server. See also Subversion fisheye.access. |
| MD5 Access Code | The MD5 sum of the above Access Code. See also Subversion fisheye.access. (This only appears if Access Code is set.) |
| Set Access Property Command | The Subversion command to set the fisheye.access property to grant FishEye access if nescessary. See also Subversion fisheye.access. (This only appears if Access Code is set.) |
| Start Revision | If set, the revision number from which FishEye will start indexing the repository. The default is to start scanning from the first revision in the repository. |
| Initial Import |
When a Start Revision is set, this setting controls how FishEye establishes the initial state of the repository. Selecting "Do not import" means that FishEye will only process the revisions from the start revision onwards. The repository state prior to this revision is ignored. If you select "Import without tag information", FishEye will import the repository content as it existed one revision prior to the start revision. FishEye will create a single synthetic revision to hold the initial state. The comment associated with this revision will be "Created by FishEye for initial repository import". Tags created prior to the start revision are ignored. |
| Username/Password | The credentials to use if your repository requires authentication. |
| trunk/branch/tag structure | Determines how FishEye attempts to understand the tag and branch structure of your Subversion repository. For more information read this. |
Perforce
| Perforce Host | The name of the server which provides the Perforce repository |
| Port | The port the server is listening on. This field is optional and FishEye will default to the standard Perforce port (1666) if you do not specify a value here |
| Path | The path within the Perforce depot that you wish to have FishEye index. You would normally put the depot path here, e.g. //depot/ but you may also use a more specific path to restrict FishEye to a subset of the depot. |
| Perforce Host | The name of the server which provides the Perforce repository |
| Block Size | Controls how many changelists FishEye will fetch from the depot in one batch. Larger values can reduce the time it takes for FishEye to scan your repository for changes, but use more memory. The default is 400. |
| Filelog limit | FishEye uses the p4 filelog command to gather information about the files in changesets. The list of files generated can be very large. Setting a limit here will cause FishEye to batch up filelog operations into groups. This is useful with some versions of the Perforce client which may have trouble with large output. In general you should only set this field if you have a 2005 client or earlier. Lower values will degrade scanning performance. |
| P4 Operation timeout | Sets the timeout value that FishEye imposes on P4 operations. Operations which exceed this value are terminated. The default for most operations is 10 minutes. |
| Throttle connections-per-sec | If set, this allows FishEye to throttle how many connections it makes per-second to the Perforce server. The default is blank (do not throttle). You may enter fractional values such as, e.g. 2.5 |
| Charset | The character set used by the server. |
| Unicode Server | This field indicates whether the Perforce Server is running in internationalized mode. |
| Case Sensitive | This field indicates whether the Perforce Server metadata is case sensitive. You should set this to false for servers running on Windows platforms. |
| Username/Password | The credentials to use if your repository requires authentication. |