This page last changed on Oct 20, 2010 by alui.

You can configure how often FishEye/Crucible checks if there have been new commits to the repository. In most cases, you will not need to change the default settings for this "updater" which polls your repository.

To configure the updater for a repository,

  1. Click the menu labelled with your user name in the the FishEye/Crucible header, and click the 'Administration' option. You will need to be logged in as an administrator to see this link. The FishEye/Crucible administration console will be displayed.

  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.
  4. Click the 'Updates' tab. The 'Updates' screen will be displayed (see screenshot below).
  5. Tick the 'Use the system default settings for updates' checkbox to use the default updater settings. In most cases, you can leave this ticked. If you want to customise the updater settings, untick the checkbox and complete the following fields, as desired:
    • 'Disable polling' — Tick this checkbox if you want to disable repository polling altogether. If you disable repository polling, FishEye/Crucible will only pick up new commits to this repository if you scan it manually. You can perform a manual scan of the repository via the command line or by using the 'Scan For Updates' function on the repository 'Maintenance' screen.
    • 'Polling Interval' — Specify how often FishEye will check to see if there have been any new commits to the repository. Use the following terms to specify particular units of time: s, m, h, d, w, mo, y (for seconds, minutes, hours, days, weeks, months and years respectively). For example, 10s. The default value for this field is 60 seconds.
  6. The following additional settings can be configured for CVS repositories. You should not have to change the default values in most cases:
    FishEye will monitor your CVS history file CVSROOT/history to determine what has changed in your repository. FishEye will also periodically scan the whole repository. CVS is not always configured to create a history file. Talk to your CVS administrator if you need assistance.
    • 'History file' — Specify the location of the CVS history file. If you use a relative path, it must be relative to the CVS directory specified for this repository. The default value for this field is ./CVSROOT/history.
    • 'Full scan period' — Specify how often FishEye will perform a full scan of the repository. Use the following terms to specify particular units of time: second, minute, hour, day, week, month, year. For example, 10second. If you do not specify a unit of time, the default unit is days. For example, 15min. Set this field to '0' to disable the periodic full scan (you can still manually perform a full scan via the command line). The default value for this field is 15 minutes.
    • 'Strip prefix' — Specify the prefix to strip off files found in the history file. This will make the files relative to this repository's CVS directory.
      You must configure a strip prefix if the CVS directory specified is not the root of the CVS repository. For example, your CVS is located at /usr/local/cvsroot, but you have specified /usr/local/cvsroot/foo/bar as the CVS directory of this repository. In this case, you will need to set the history file as ../../CVSROOT/history and specify a strip prefix of foo/bar.
  7. Click the 'Save' button to save your changes.
  8. Restart FishEye, if you have changed any values. Your repositories will be scanned in order (depending on the number of threads you have configured) once FishEye starts up. The polling interval and full scan period (CVS only) will then be determined from the time that this initial scan is complete. For example, if you have set you polling interval to one hour, your next scan will begin one hour after your initial scan is complete.

Screenshot: Repository Updates Settings

Document generated by Confluence on Apr 03, 2011 23:09