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
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

SYNOPSIS

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

SUBCOMMANDS

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

OPTIONS

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

NOTES

101       dnf system-upgrade reboot does not create a "System Upgrade" boot item.
102       The upgrade will start regardless of which boot item is chosen.
103
104       Since this is a DNF plugin, options accepted  by  dnf  are  also  valid
105       here, such as --allowerasing.  See dnf(8) for more information.
106
107       The  fedup  command  is not provided, not even as an alias for dnf sys‐
108       tem-upgrade.
109

BUGS

111       Upgrading from install media  (e.g.  a  DVD  or  .iso  file)  currently
112       requires the user to manually set up a DNF repo and fstab entry for the
113       media.
114

EXAMPLES

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

REPORTING BUGS

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

AUTHORS

153       Will Woods <wwoods@redhat.com>
154
155       Štěpán Smetana <ssmetana@redhat.com>
156

AUTHOR

158       See AUTHORS in your Extras DNF Plugins distribution
159

COPYRIGHT

161       2020, Igor Gnatenko, Licensed under GPLv2+
162
163
164
165
1664.0.10                           Apr 08, 2020            DNF-SYSTEM-UPGRADE(8)