Documentation for FishEye 3.0.x. Documentation for other versions is available too.

You can define the SCM Details for a repository when adding or managing a repository. The SCM details will vary depending on the type of repository that you are adding, e.g. the SCM details for a Subversion repository differ to the SCM details for a Git repository.

Configuring the SCM details for a repository

To configure the SCM details for a repository:

  1. Click the user menu in the FishEye header, and choose Administration. You will need to be logged in as an administrator to see this link.
  2. Click the 'Repositories' link. The list of repositories set up in your FishEye instance will be displayed.
  3. Click the name of the repository, (under the 'Name' column in the list of repositories). The Repository Options for the repository will be displayed in a dialogue.
    (You can also click the cog icon () and click 'View' from the dropdown menu to open the Repository Options)
  4. Click 'SCM Details' in the left menu. The details for your repository will be displayed.
  5. Click the 'Edit' button at the bottom of the dialogue. The 'SCM Details' will refresh with the fields editable.
  6. Update the fields as desired.
    • 'Description' — Enter a description for the repository. This is used to describe the repository in FishEye screens.
    • 'Store Diff Info' — Tick this checkbox, if you want FishEye to cache information about file diffs in its database. This is required for some FishEye features. This setting will be enabled by default for new repositories. See the Notes section below for important information on this setting.
    • The rest of the fields will vary depending on the SCM. See the following topics:
      Note, the topics below are for adding a repository, however the fields are the same.
  7. Click the 'Apply and Test Connection' button to test your changes.
    • If you are happy with your changes, click the 'Save' button to save your changes.
    • If you need to abandon your changes, click the 'Revert' button.

Screenshot: Configuring the SCM details for a Subversion repository

Notes

About the 'Store Diff Info' setting

Enabling the 'Store Diff Info' setting means that FishEye will store information about file diffs in its database, i.e. FishEye will store summary of what lines are added and removed between subsequent versions of the same file. You will still be able view file diffs regardless of whether this setting is enabled or disabled.

(warning) Please note, you need to perform a full re-index of your repository after enabling this setting, for FishEye to collect the diff information for all revisions in your repository.

Please also take note of the following information about this setting:

  • Disabling the 'Store Diff Info' setting will disable per-author line graphs.
  • Disabling the 'Store Diff Info' setting also removes the author/revision information in the diff display.
  • Diff information is always stored for CVS repositories. Note, that a full re-index is required to enable per author charts after upgrading from FishEye 1.4.3 or earlier.
  • Enabling the 'Store Diff Info' setting will allow FishEye to perform text searches of lines added and removed, in addition to the text search of the trunk head.
  • Enabling the 'Store Diff Info' setting for Perforce repositories will force FishEye to make extra requests to your depot in order to collect the diffs. This may substantially increase the time it takes to scan your repository (scan times for other repositories, like CVS and Subversion, are not affected by the 'Store Diff Info' setting). If your Perforce repository was created before FishEye 1.5, this setting will be disabled by default.