NAME
grip-cron.sh - cron job for Emdebian Grip with a logfile
SYNOPSIS
/usr/share/emdebian-tools/grip-cron.sh [-b] [--base-path] [[--t] |
[--tmpfs]] [[--e] |
[--edos-only]]
DESCRIPTION
grip-cron.sh is a wrapper for cron to automate updates using
em_autogrip, using a logfile for all output.
The filter repository is updated against a Debian mirror, updated
packages are downloaded and gripped, packages that have migrated into
Debian testing are also migrated into Emdebian Grip testing and
dependency checks are run.
Note that grip-cron.sh can take large amounts of time, temporary disc
space, CPU and network bandwidth during each run, depending on the
number of changes in the relevant Debian archives since the last run of
grip-cron.sh. Unpacking and repacking Debian binary packages can use a
tmpfs if already mounted. Ensure that the directory for the tmpfs is
writeable by the process / user running grip-cron.sh. You may need to
use sudo mkdir to create a suitable directory in your tmpfs and then
use sudo chown for the user running grip-cron.sh. tmpfs will use swap
space if appropriate but problems can occur if your tmpfs does not
provide enough space to unpack the larger Debian packages in Grip
(generally build dependencies) which can be more than 11Mb compressed.
-b|--base-path
The top level directory of the Emdebian Grip repository. If your
filter and grip repositories are in /path/filter/ and /path/grip/,
the base-path is /path.
The base-path must always be specified when using grip-cron.sh.
-t|--tmpfs
The path to a writeable directory within an tmpfs which must be
already mounted.
Tmpfs will not grow dynamically
Using a tmpfs could mean that certain packages fail to be
updated because dpkg -X failed with an error of No space left
on device. Check the grip-cron.sh logfiles and enlarge the
tmpfs before running grip-cron.sh again.
-e|--edos-only
Skips the updates and just runs the edos checks for each
architecture, outputting to the logfile as usual. This is useful
when just adding and updating packages to fix missing dependencies.
--tmpfs has no effect in this mode.
EXAMPLES
Example 1.1. Example crontab
0 2 * * * /usr/share/emdebian-tools/grip-cron.sh -b /opt/reprepro
Example 1.2. Example to setup the tmpfs
The size of the tmpfs is open to debate. A tmpfs can use swap space if
not enough RAM is available for the contents of the tmpfs but the size
of the tmpfs itself cannot be changed without unmounting and remounting
it. i.e. not without restarting grip-cron.sh. Packages that attempt to
unpack more files than the tmpfs can hold will fail to be updated.
Check the logs carefully.
$ cd /opt/reprepro/
$ mkdir tmpfs
$ sudo chmod +t tmpfs
$ sudo chmod 777 tmpfs
$ sudo mount -t tmpfs -o size=1G,user tmpfs tmpfs/
crontab for this setup:
0 2 * * * /usr/share/emdebian-tools/grip-cron.sh -b /opt/reprepro -t /opt/reprepro/tmpfs
AUTHOR
Emdebian
Neil Williams
Debian and Emdebian developer.
COPYRIGHT
The GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007.PP This
documentation is part of emdebian-grip.
emdebian-grip is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program. If not, see http://www.gnu.org/licenses/.
Note
In Debian you can find a copy of the GNU General Public Licence in
/usr/share/common-licenses/GPL-3
EMDEBIAN-GRIP Release: 2.Wed 23 Sep 2009 07:57:16 BST