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,
- 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).
- Click Repositories. The list of repositories set up in your Fisheye instance will be displayed.
- Click the name of the repository, (under the 'Name' column in the list of repositories).
- Click the Updates tab.
Check Use the system default settings for updates to use the default updater settings. In most cases, you can leave this ticked. If you want to customize the updater settings, clear the checkbox and complete the following fields, as required:
Disable polling 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 should check for 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.
The following additional settings can be configured for CVS repositories. You should not have to change the default values in most cases:
History File 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
Full Scan Interval 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 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/baras the CVS directory of this repository. In this case, you will need to set the history file as
../../CVSROOT/historyand specify a strip prefix of
Fisheye will monitor your CVS history file
CVSROOT/historyto 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.
- Click Save.
- 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