REDHAT-UPGRADE-TOO(8)

NAME
redhat-upgrade-tool - Red Hat Upgrade tool

SYNOPSIS

redhat-upgrade-tool [OPTIONS] SOURCE

DESCRIPTION

redhat-upgrade-tool is the Red Hat Upgrade Tool.

The redhat-upgrade-tool client runs on the source system. It determines what packages are needed for upgrade and gathers them from the given source(s). It also fetches and sets up the boot images needed to run the upgrade and sets up the system to perform the upgrade at next boot.

The actual upgrade occurs when the system is rebooted, using the boot images set up by redhat-upgrade-tool. The upgrade initrd starts the source system as normal, lets it mount all the local filesystems, and then starts the upgrade.

When the upgrade finishes, it reboots the system into the newly-upgraded OS.

OPTIONS

  Optional arguments

-h, --help
    Show a help message and exit.

-v, --verbose
    Print more info.

-d, --debug
    Print lots of debugging info.

--force
    Continue even if the Preupgrade Assistant risk check fails. Use it at your own risk.

--no-space-check
    Disable check of free space in /boot. By default the required minimum before reboot is 50 MiB. Use it at your own risk.

--debuglog DEBUGLOG
    Write debugging output to the given file. Defaults to /var/log/redhat-upgrade-tool.log.

--reboot
    Automatically reboot to start the upgrade when ready.

--snapshot-lv VOLUME[:CUSTOM_SNAPSHOT_NAME[:SIZE]]
    Specify the LVM logical volume from which a snapshot should be taken before performing the system upgrade.

--snapshot-root-lv VOLUME[:CUSTOM_SNAPSHOT_NAME[:SIZE]]
    Same as --snapshot-lv, but additionally creates a new Grub menu entry to allow the user to boot into the snapshot volume recently created.

--system-restore
    Restore system from previously created snapshots.

  SOURCE

These options provide redhat-upgrade-tool with the information where to look for the packages and boot images needed to run the upgrade. At least one of these options is required.

--device [DEV]
    Device or mountpoint of mounted install media. If DEV is omitted, redhat-upgrade-tool will scan all currently-mounted removable devices (for example USB disks and optical media).

--iso ISO
    Installation image file.

--network RELEASEVER
    Online repos. RELEASEVER will be used to replace $releasever variable if it occurs in some repo URL.

Multiple sources may be used, if desired.

  Additional options for --network

--enablerepo REPOID
    Enable one or more repos (wildcards are allowed).

--disablerepo REPOID
    Disable one or more repos (wildcards are allowed).

--addrepo REPOID=[@]URL
    Add the repo at URL. Prefix URL with @ to indicate that the URL is a mirrorlist.

--instrepo REPOID
    Get upgrader boot images from the repo named REPOID. The repo must contain a valid .treeinfo file, which points to the location of usable kernel and upgrade images.

  Cleanup commands

--resetbootloader
    Remove any modifications made to the bootloader configuration.

--clean-snapshots
    Clean up snapshots that were previously created.

--clean
    Clean up everything written by redhat-upgrade-tool.

EXAMPLES

redhat-upgrade-tool --network 7.0 --instrepo <repo URL>

Upgrade to RHEL 7.0 by downloading all needed packages and data from the specified repository.

redhat-upgrade-tool --network 7.0 --instrepo <repo URL> --snapshot-root-lv vg/lv_root:snap_root:5G --snapshot-lv vg/lv_var

Same as above, but first takes a snapshot from logical volumes vg/lv_root and vg/lv_var. For vg/lv_root the snapshot name will be named snap_root and its size will be 5G. Also, a new Grub menu entry, that allows booting into the snapshot taken from vg/lv_root, is created.

redhat-upgrade-tool --device

Upgrade the system by using installation media mounted on the system, fetching updates from the network if needed.

EXIT STATUS

0
    Success.

1
    Cancelled by user, failure writing files to disk, or other unknown error

2
    Failed to download/copy files from the given SOURCE

3
    RPM upgrade transaction test failed

BUGS

The --iso image must be on a filesystem listed in /etc/fstab.

AUTHORS

Will Woods <wwoods@redhat.com>