grok-fsck man page
GROK-FSCK — Check mirrored repositories for corruption
grok-fsck -c /path/to/fsck.conf
Git repositories can get corrupted whether they are frequently updated or not, which is why it is useful to routinely check them using "git fsck". Grokmirror ships with a "grok-fsck" utility that will run "git fsck" on all mirrored git repositories. It is supposed to be run nightly from cron, and will do its best to randomly stagger the checks so only a subset of repositories is checked each night. Any errors will be sent to the user set in MAILTO.
show program's version number and exit
- -h, --help
show this help message and exit
- -v, --verbose
Be verbose and tell us what you are doing
- -f, --force
Force immediate run on all repositories.
- -c CONFIG, --config=CONFIG
Location of fsck.conf
(Assumes --force): Run git fsck on all repos, but only check connectivity
(Assumes --force): Do a quick repack of all repos
(Assumes --force): Do a full repack of all repos
Locate fsck.conf and modify it to reflect your needs. The default configuration file is heavily commented.
Set up a cron job to run nightly and to email any discovered errors to root:
# Make sure MAILTO is set, for error reports MAILTO=root # Run nightly, at 2AM 00 02 * * * mirror /usr/bin/grok-fsck -c /etc/grokmirror/fsck.conf
You can force a full run using the -f flag, but unless you only have a few smallish git repositories, it's not recommended, as it may take several hours to complete, as it will do a full repack, prune and fsck of all repositories. To make this process faster, you can use:
- --connectivity: when doing fsck, only check object connectivity
- --repack-all-quick: do a quick repack of all repositories
- --repack-all-full: if you have full_repack_flags defined in the configuration file, trigger a full repack of every repository. This can be handy if you need to bring up a newly cloned mirror and want to make sure it's repacked and all bitmaps are built before serving content.
Please open an issue on Github:
The Linux Foundation and contributors