Attachment 306655 Details for Bug 448368 – Uncompressed preupgrade man page text file.

Uncompressed preupgrade man page text file.

preupgrade.8 (text/plain), 3.72 KB, created by Greg Morgan on 2008-05-26 09:50:01 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Greg Morgan

Created: 2008-05-26 09:50:01 UTC

Size: 3.72 KB

patch

obsolete

>.de FN
>\fI\|\\$1\|\fP
>..
>.TH PREUPGRADE 8 "26 May 2008" "Red Hat, Inc."
>.UC 4
>.SH NAME
>preupgrade-gtk, preupgrade-cli \- pre-download packages before upgrading to next distribution version
> 
>.SH SYNOPSIS
>\fBpreupgrade\fR
>.in +7
>[options] {"release-name"|no options}
>.in -7
>.SH DESCRIPTION
>\fBpreupgrade\fR provides a way for Fedora users who wish to upgrade from one
>distribution version to the next.  \fBpreupgrade\fR implements a way of easily
>pre-resolving and downloading all the necessary packages before rebooting
>the system into the Fedora installer, Anaconda, that will complete the upgrade.
>\fBpreupgrade\fR removes the requirement of burning a boot.iso CD or full 
>distribution DVD to start a distribution upgrade.
>
>If a \fB"release-name"\fR such as "Rawhide" is specified, \fBpreupgrade\fR 
>will start the package resolution and download operation.  Since yum is 
>invoked by preupgrade, the operation can be aborted via a \fBNo\fR response
>to the \fB"Is this ok [y/N]:"\fR question.
>
>If \fBno options\fR are provided, then \fBpreupgrade\fR displays a list of
>possible release names that are available to upgrade an existing distribution
>to.  The number of releases available depends on where the existing system
>is in the Fedora release cycle.  For example, a Fedora 6 system may have a
>Fedora 7, Fedora 8, Fedora 9 and Rawhide release available right after Fedora 9
>has been released.  Please remember that Fedora 7 would shortly be at its
>end of life, EOL, in this example once Fedora 9 has reached general
>availability, GA.
>
>\fBpreupgrade\fR was designed to leave the system administrator in control.
>A grub menu item is created to launch the upgrade.  However, \fBpreupgrade\fR 
>leaves your last working kernel installation as the default grub menu item.
>The grub menu entry will be named something similar to
>\fB"Upgrade to Fedora X (release name)"\fR where \fBX\fR is the Fedora release
>number and \fB(release name)\fR may be something simliar to "Sulphur".
>You may modify the stock grub menu entry created by \fBpreupgrade\fR. You
>may need to add additional configuration options before rebooting your
>system.  Some ideas include a kickstart file, ks.cfg, video, or other
>options required by your hardware or installation environment.
>grubby is invoked to create the /boot/grub/grub.conf menu entry.
>
>.PD
>.SH NOTES
>If \fBpreupgrade\fR is interrupted, then it will resume the downloads where
>it left off.
>
>Make sure that you have enough disk space allocated to your /var partition,
>if you have placed /var on another disk or file system. \fBpreupgrade\fR 
>will use the /var/cache/yum directory to download other support files.
>
>Likewise, your /boot partition needs enough disk space to store another
>vmlinuz compressed kernel file and two image files.
>
>.PD
>.SH "RETURN CODES"
>\fBpreupgrade\fR returns 0 on success, 2 on error.
>
>.PD
>.SH FILES
>.PD 0
>.TP
>.TP
>.FN /etc/grub.conf or
>.FN /boot/grub/grub.conf
>\fBpreupgrade\fR modifies the existing system's grub menu providing an entry to invoke the upgrade after rebooting the system.
>.TP
>.FN /var/cache/yum
>\fBpreupgrade\fR uses the /var/cache/yum directory to stage the upgrade files.
>An anaconda-upgrade directory is created under the /var/cache/yum directory
>to hold and organize the related release files.
>.TP
>.FN /boot/upgrade
>The /boot/upgrade directory is used to store the three files used to 
>launch the upgrade.  These files include the kernel and its related initial
>ramdrive image file along with the Anaconda stage2 loader file.
>The file names are vmlinuz, initrd.img, and stage2.img respectfully.
>.TP
>.FN /usr/share/preupgrade/releases.list
>Provides a list of available \fB"supported"\fR Fedora releases.
>
>.PD
>.SH "SEE ALSO"
>yum(8), grub(8), grubby(8), anaconda
>
>.SH AUTHORS
>.nf
>Greg Morgan <dr_kludge@users.sourceforge.net>
>.fi

Actions: View

Attachments on bug 448368: 306655