Skip to end of metadata
Go to start of metadata

When adding or managing a SVN (Subversion) repository, you can:

There are also the following SVN-specific actions:

On this page:

Requirements

Icon

It is particularly important that you set up the correct branch and tag structure for your Subversion repositories. If FishEye does not know which files are tags and branches, it will treat all files as trunk files. This can significantly increase the effective size of your repository. This will increase initial scan time and impact runtime performance. Please refer to the instructions on tag and branch configuration.
In the majority of cases, indexing a small repository shouldn't take hours, and certainly not days. However, if you have a giant repository, have a slow remote host, you're using HTTP or HTTPS protocols, or if there is a problem with the symbolic setup of your repository, it could potentially take hours or even days. If in doubt, schedule the indexing to run over a weekend or extended maintenance period.

Icon

Using the 'file://' protocol to access your Subversion repository can be much faster than the other network protocols if your repository is on a local disk on the same server as FishEye.

Knowledge Base

Icon

You may find useful information in either the FishEye Subversion FAQ or the Subversion integration section of the FishEye Knowledge Base.

SVN repository setup

  1. Click the 'cog' menu in the FishEye header, and choose Administration (you'll need to be logged in as an administrator to see this link).
  2. Click Repositories (under 'Repository Settings').
  3. Click Add repository.
  4. Complete the wizard:

Screenshots: Adding a SVN repository

 

Setting

Description

Repository Type

Choose Subversion.

Name

A name for this repository. The name may contain alphanumeric, underscore, '-' or '.' characters. Use 'svn' if you can't think of a better name.

Description

A short description of this repository.

SVN URL

The Subversion Repository Root URL to your repository, such as svn://svn.foo.com or file:///var/svn. If you are not sure what your repository root is, check the section below "Finding your Repository Root".
(Please note that file protocol performs the fastest followed by svn and lastly by http/s. Therefore where possible please use the file protocol.)

Path

The sub-tree within your repository that FishEye should display. If this value is '.' (or empty), then the whole repository will be shown.

Username/Password

The credentials to use if your repository requires authentication.

Store Diff Info

Enable this option if you are using the Subversion or Perforce SCM systems and making use of per-author line counts. Otherwise, enabling this option is not necessary. Read more information

Enable Repository After Adding

Controls whether FishEye will immediately enable this repository, which starts the initial scan. If you wish to do some further configuration before the scan starts, then do not check. You can enable a repository later from the repository list.

 

Once the repository is added you can click the repository name on the 'Repositories' screen to configure the following settings:

SettingDescription

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. The minimum being 1. This field only accepts positive whole numbers. Requires a repository restart.

Svn Operation Timeout

Sets the timeout value that FishEye imposes on Subversion operations. Operations which exceed this value are terminated. The default for operations is 1 hour. It can be changed to a different interval, for example: "2 days", "10 hours", or "20 minutes".

Icon

The library that FishEye/Crucible uses (SVNKit) for SVN integration defines a timeout of 60 minutes by default if the property http-timeout is not defined in the Subversion configuration. This property defines the time to wait for a server response and terminates the HTTP call if it exceeds the timeout.

See this KB for more information: SVN Operations Taking Longer than an Hour Time Out

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 field 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 necessary. See also Subversion fisheye.access. (This field 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.
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.
Import without tag information means that 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.

Follow Base Moves

If you have changed the location of your repository in your Subversion server over time, set this option to true. Doing so will cause FishEye to index your repository's full history across all its locations within your server.

Use Built-in Symbolic Rules

Determines how FishEye attempts to understand the tag and branch structure of your Subversion repository. Read more information.

Icon

If FishEye returns the error 'Authentication Cancelled', this may simply indicate an incorrect username or password.

Finding your repository root

Run the following command:

svn info SVN_URL

Where SVN_URL is the complete URL of the repository you want to add.

You will get something like the following:

>svn info http://svn.example.com/svn5/

Path: svn5
URL: http://svn.example.com/svn5/
Repository Root: http://svn.example.com/
Repository UUID: ce062a09-193b-427a-a7b3-a85007076e5d
Revision: 83
Node Kind: directory
Last Changed Author: ryan
Last Changed Rev: 83
Last Changed Date: 2009-05-07 10:48:41 +1000 (Thu, 07 May 2009)

Next to "Repository Root" is the URL you should define as your repository root. The path will be whatever is remaining.

3 Comments

  1. Anonymous

    we have around 50 repositories and we create new branches every 2 months. Is there any way to add these repositories (may be through a small automation) to avoid hastle of fulling in multiple screens every time we create new branches ? Thanks much.

  2. We are evaluating FishEye with Crucible integration. I just added our single SubVersion repository which contains all of our Projects. FishEye projects can be configured with a relative path, however it does not seem to be possible for Crucible.

    Am I overlooking something or is this not possible? If this is not possible, should I setup several repositories with relative paths or will this feature be implemented soon?

  3. Hi Wouter de Vries, I would recommend setting up several repositories with relative paths as it will make it easier to handle the indexing of each repository.

    If you have more questions regarding your configuration I would encourage you to ask them on https://answers.atlassian.com where Atlassian people and other users will be able to provide you with answers and recommendations.