source: trunk/debathena/config/auto-update/debian/athena-auto-upgrade.8 @ 25955

.TH ATHENA-AUTO-UPGRADE 8 "3 August 2010" "debathena-auto-upgrade" "Athena Upgrade System"
.SH NAME
athena-auto-upgrade \- Attempt to automatically upgrade to a newer release of Ubuntu
.SH SYNOPSIS
.nf
.B athena-auto-upgrade [ -f | -d ] [ -t ]
.sp
.SH DESCRIPTION
.BR athena-auto-upgrade
is intended to be run by cron on a regular basis.  It queries Hesiod
for the newest release of Ubuntu, and then kexec's into the installer
for that version. If the upgrade fails prior to kexec, a message will
be sent to the \fIuser\fP syslog facility, with priority \fInotice\fP.

It will also reinstall the machine at the current version if the
\fIreinstall_at\fP clusterinfo tag exists and its value is greater than
the last mod time of /var/log/athena-install.log (in seconds since the
epoch).

You really don't want to run this by hand.

.SH FEATURES
Here be dragons.

.SH OPTIONS
.IP -f
Forces athena-auto-upgrade to reboot even if someone is logged in.
Don't use this.
.IP -t
Causes athena-auto-upgrade to upgrade to a 'testing' release.  Don't
use this.
.IP -d
Debug mode.  Will also force it to simulate an upgrade, even on
non-cluster machines. Set DEBUG_RELEASE to force a specific release. 
.IP -v
Add verbosity. By default stdin and stderr for system calls are 
redirected to /dev/null.
.SH SEE ALSO
getcluster(1), kexec(8)

.SH AUTHOR
SIPB Debathena Project (http://debathena.mit.edu)