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
15       major  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
21       environments.
22

SYNOPSIS

24       dnf system-upgrade download --releasever VERSION [OPTIONS]
25
26       On  modular  system,  also set the module_platform_id. For example, for
27       Fedora 30:
28
29       dnf system-upgrade download --releasever 30 [OPTIONS]
30
31       dnf system-upgrade reboot
32
33       dnf system-upgrade clean
34
35       dnf system-upgrade log
36
37       dnf system-upgrade log --number=<number>
38
39       dnf offline-upgrade download [OPTIONS]
40
41       dnf offline-upgrade reboot
42
43       dnf offline-upgrade clean
44
45       dnf offline-upgrade log
46
47       dnf offline-upgrade log --number=<number>
48
49       dnf offline-distrosync download [OPTIONS]
50
51       dnf offline-distrosync reboot
52
53       dnf offline-distrosync clean
54
55       dnf offline-distrosync log
56
57       dnf offline-distrosync log --number=<number>
58

SUBCOMMANDS

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

OPTIONS

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

NOTES

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

BUGS

119       Upgrading from install media  (e.g.  a  DVD  or  .iso  file)  currently
120       requires the user to manually set up a DNF repo and fstab entry for the
121       media.
122

EXAMPLES

124   Typical upgrade usage
125       dnf --refresh upgrade
126
127       dnf system-upgrade download --releasever 26
128
129       dnf system-upgrade reboot
130
131   Show logs from last upgrade attempt
132       dnf system-upgrade log --number=-1
133

REPORTING BUGS

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

SEE ALSO

155       dnf(8), dnf.conf(5), journalctl(1).
156
157   Project homepage
158       https://github.com/rpm-software-management/dnf-plugins-extras
159

AUTHORS

161       Will Woods <wwoods@redhat.com>
162
163       Štěpán Smetana <ssmetana@redhat.com>
164

AUTHOR

166       See AUTHORS in your Extras DNF Plugins distribution
167
169       2020, Igor Gnatenko, Licensed under GPLv2+
170
171
172
173
1744.0.13                           Dec 03, 2020            DNF-SYSTEM-UPGRADE(8)
Impressum