dnf-system-upgrade(8)

1DNF-SYSTEM-UPGRADE(8)         dnf-plugins-extras         DNF-SYSTEM-UPGRADE(8)
2
3
4

NAME

6       dnf-system-upgrade - DNF system-upgrade Plugin
7

DESCRIPTION

9       DNF  system-upgrades  plugin  provides  three commands: system-upgrade,
10       offline-upgrade, and offline-distrosync.  Only  system-upgrade  command
11       requires increase of distribution major version (--releasever) compared
12       to installed version.
13
14       dnf system-upgrade can be used to upgrade a Fedora system to a new  ma‐
15       jor  release.  It  replaces fedup (the old Fedora Upgrade tool). Before
16       you proceed ensure that your system is fully  upgraded  (dnf  --refresh
17       upgrade).
18
19       The  system-upgrade command also performes additional actions necessary
20       for the upgrade of the system, for example an upgrade of groups and en‐
21       vironments.
22

SYNOPSIS

24       dnf system-upgrade download --releasever VERSION [OPTIONS]
25
26       dnf system-upgrade reboot
27
28       dnf system-upgrade clean
29
30       dnf system-upgrade log
31
32       dnf system-upgrade log --number=<number>
33
34       dnf offline-upgrade download [OPTIONS]
35
36       dnf offline-upgrade reboot
37
38       dnf offline-upgrade clean
39
40       dnf offline-upgrade log
41
42       dnf offline-upgrade log --number=<number>
43
44       dnf offline-distrosync download [OPTIONS]
45
46       dnf offline-distrosync reboot
47
48       dnf offline-distrosync clean
49
50       dnf offline-distrosync log
51
52       dnf offline-distrosync log --number=<number>
53

SUBCOMMANDS

55       download
56              Downloads everything needed to upgrade to a new major release.
57
58       reboot Prepares the system to perform the upgrade, and reboots to start
59              the upgrade.  This can only be used after the  download  command
60              completes successfully.
61
62       clean  Remove previously-downloaded data. This happens automatically at
63              the end of a successful upgrade.
64
65       log    Used to see a list of boots during  which  an  upgrade  was  at‐
66              tempted,  or show the logs from an upgrade attempt. The logs for
67              one of the boots can be shown by specifying one of  the  numbers
68              in  the first column. Negative numbers can be used to number the
69              boots from last to first. For example, log  --number=-1  can  be
70              used to see the logs for the last upgrade attempt.
71

OPTIONS

73       --releasever=VERSION
74              REQUIRED. The version to upgrade to. Sets $releasever in all en‐
75              abled repos. Usually a number, or rawhide.
76
77       --downloaddir=<path>
78              Redirect download of packages to provided  <path>.  By  default,
79              packages  are downloaded into (per repository created) subdirec‐
80              tories of /var/lib/dnf/system-upgrade.
81
82       --distro-sync
83              Behave like dnf distro-sync: always install  packages  from  the
84              new release, even if they are older than the currently-installed
85              version. This is the default behavior.
86
87       --no-downgrade
88              Behave like dnf update: do not install packages from the new re‐
89              lease  if  they are older than what is currently installed. This
90              is the opposite of --distro-sync. If  both  are  specified,  the
91              last option will be used. The option cannot be used with the
92              ``
93              offline-distrosync` command.
94
95       --number
96              Applied  with  log subcommand will show the log specified by the
97              number.
98

NOTES

100       dnf system-upgrade reboot does not create a "System Upgrade" boot item.
101       The upgrade will start regardless of which boot item is chosen.
102
103       The  DNF_SYSTEM_UPGRADE_NO_REBOOT  environment variable can be set to a
104       non-empty value to disable the actual reboot  performed  by  system-up‐
105       grade (e.g. for testing purposes).
106
107       Since  this  is  a  DNF  plugin, options accepted by dnf are also valid
108       here, such as --allowerasing.  See dnf(8) for more information.
109
110       The fedup command is not provided, not even as an alias  for  dnf  sys‐
111       tem-upgrade.
112

BUGS

114       Upgrading  from  install  media (e.g. a DVD or .iso file) currently re‐
115       quires the user to manually set up a DNF repo and fstab entry  for  the
116       media.
117

EXAMPLES

119   Typical upgrade usage
120       dnf --refresh upgrade
121
122       dnf system-upgrade download --releasever 26
123
124       dnf system-upgrade reboot
125
126   Show logs from last upgrade attempt
127       dnf system-upgrade log --number=-1
128

REPORTING BUGS

130       Bugs should be filed here:
131          https://bugzilla.redhat.com/
132
133       For more info on filing bugs, see the Fedora Project wiki:
134          https://fedoraproject.org/wiki/How_to_file_a_bug_report
135
136          https://fedoraproject.org/wiki/Bugs_and_feature_requests
137
138       Please  include  /var/log/dnf.log  and the output of dnf system-upgrade
139       log --number=-1 (if applicable) in your bug reports.
140
141       Problems with dependency solving during download are best  reported  to
142       the maintainers of the package(s) with the dependency problems.
143
144       Similarly,  problems  encountered on your system after the upgrade com‐
145       pletes should be reported to the maintainers  of  the  affected  compo‐
146       nents. In other words: if (for example) KDE stops working, it's best if
147       you report that to the KDE maintainers.
148

AUTHORS

156       Will Woods <wwoods@redhat.com>
157
158       Štěpán Smetana <ssmetana@redhat.com>
159

AUTHOR

161       See AUTHORS in your Extras DNF Plugins distribution
162

COPYRIGHT

164       2021, Igor Gnatenko, Licensed under GPLv2+
165
166
167
168
1694.0.15                           Jul 21, 2021            DNF-SYSTEM-UPGRADE(8)