huschi.net

DNF-SYSTEM-UPGRADE(8)          dnf-plugins-core          DNF-SYSTEM-UPGRADE(8)
NAME
       dnf-system-upgrade - DNF system-upgrade Plugin
DESCRIPTION
       DNF  system-upgrades  plugin  provides  three commands: system-upgrade,
       offline-upgrade, and offline-distrosync.  Only  system-upgrade  command
       requires increase of distribution major version (--releasever) compared
       to installed version.
       dnf system-upgrade is a recommended way to upgrade a system  to  a  new
       major release.  It replaces fedup (the old Fedora Upgrade tool). Before
       you proceed ensure that your system is fully  upgraded  (dnf  --refresh
       upgrade).
       The  system-upgrade command also performes additional actions necessary
       for the upgrade of the system, for example an  upgrade  of  groups  and
       environments.
       WARNING:
          The  system-upgrade  command  is not supported on the RHEL distribu-
          tion.
SYNOPSIS
       dnf system-upgrade download --releasever VERSION [OPTIONS]
       dnf system-upgrade reboot
       dnf system-upgrade clean
       dnf system-upgrade log
       dnf system-upgrade log --number=<number>
       dnf offline-upgrade download [OPTIONS]
       dnf offline-upgrade reboot
       dnf offline-upgrade clean
       dnf offline-upgrade log
       dnf offline-upgrade log --number=<number>
       dnf offline-distrosync download [OPTIONS]
       dnf offline-distrosync reboot
       dnf offline-distrosync clean
       dnf offline-distrosync log
       dnf offline-distrosync log --number=<number>
SUBCOMMANDS
       download
              Downloads everything needed to upgrade to a new major release.
       reboot Prepares the system to perform the upgrade, and reboots to start
              the  upgrade.   This can only be used after the download command
              completes successfully.
       clean  Remove previously-downloaded data. This happens automatically at
              the end of a successful upgrade.
       log    Used  to  see  a  list  of  boots  during  which  an upgrade was
              attempted, or show the logs from an upgrade  attempt.  The  logs
              for  one of the boots can be shown by specifying one of the num-
              bers in the first column. Negative numbers can be used to number
              the  boots  from last to first. For example, log --number=-1 can
              be used to see the logs for the last upgrade attempt.
OPTIONS
       --releasever=VERSION
              REQUIRED. The version to upgrade to.  Sets  $releasever  in  all
              enabled repos. Usually a number, or rawhide.
       --downloaddir=<path>
              Redirect  download  of  packages to provided <path>. By default,
              packages are downloaded into (per repository created)  subdirec-
              tories of /var/lib/dnf/system-upgrade.
       --distro-sync
              Behave  like  dnf  distro-sync: always install packages from the
              new release, even if they are older than the currently-installed
              version. This is the default behavior.
       --no-downgrade
              Behave  like  dnf  update:  do not install packages from the new
              release if they are older than what is currently installed. This
              is  the  opposite  of  --distro-sync. If both are specified, the
              last option will be used. The option cannot  be  used  with  the
              offline-distrosync command.
       --number
              Applied  with  log subcommand will show the log specified by the
              number.
NOTES
       dnf system-upgrade reboot does not create a "System Upgrade" boot item.
       The upgrade will start regardless of which boot item is chosen.
       The  DNF_SYSTEM_UPGRADE_NO_REBOOT  environment variable can be set to a
       non-empty  value  to  disable  the  actual  reboot  performed  by  sys-
       tem-upgrade (e.g. for testing purposes).
       Since  this  is  a  DNF  plugin, options accepted by dnf are also valid
       here, such as --allowerasing.  See dnf(8) for more information.
       The fedup command is not provided, not even as an alias  for  dnf  sys-
       tem-upgrade.
BUGS
       Upgrading  from  install  media  (e.g.  a  DVD  or .iso file) currently
       requires the user to manually set up a DNF repo and fstab entry for the
       media.
EXAMPLES
   Typical upgrade usage
       dnf --refresh upgrade
       dnf system-upgrade download --releasever 26
       dnf system-upgrade reboot
   Show logs from last upgrade attempt
       dnf system-upgrade log --number=-1
REPORTING BUGS
       Bugs should be filed here:
          https://bugzilla.redhat.com/
       For more info on filing bugs, see the Fedora Project wiki:
          https://fedoraproject.org/wiki/How_to_file_a_bug_report
          https://fedoraproject.org/wiki/Bugs_and_feature_requests
       Please  include  /var/log/dnf.log  and the output of dnf system-upgrade
       log --number=-1 (if applicable) in your bug reports.
       Problems with dependency solving during download are best  reported  to
       the maintainers of the package(s) with the dependency problems.
       Similarly,  problems  encountered on your system after the upgrade com-
       pletes should be reported to the maintainers  of  the  affected  compo-
       nents. In other words: if (for example) KDE stops working, it's best if
       you report that to the KDE maintainers.
SEE ALSO
       dnf(8), dnf.conf(5), journalctl(1).
   Project homepage
       https://github.com/rpm-software-management/dnf-plugins-core
AUTHORS
       Will Woods <wwoods AT redhat.com>
       tpan Smetana <ssmetana AT redhat.com>
AUTHOR
       See AUTHORS in your Core DNF Plugins distribution
COPYRIGHT
       2014, Red Hat, Licensed under GPLv2+
4.0.21                           Apr 08, 2024            DNF-SYSTEM-UPGRADE(8)