dnf.plugin.system-upgrade(8)

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

NAME

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

DESCRIPTION

9       dnf  system-upgrade  can  be  used  to upgrade a Fedora system to a new
10       major release. It replaces fedup (the old Fedora Upgrade tool).  Before
11       you  proceed  ensure  that your system is fully upgraded (dnf --refresh
12       upgrade).
13

SYNOPSIS

15       dnf system-upgrade download --releasever VERSION [OPTIONS]
16
17       On modular system, also set the module_platform_id.  For  example,  for
18       Fedora 30:
19          dnf  system-upgrade  download --releasever 30 --setopt='module_plat‐
20          form_id=platform:f30' [OPTIONS]
21
22       dnf system-upgrade reboot
23
24       dnf system-upgrade clean
25
26       dnf system-upgrade log
27
28       dnf system-upgrade log --number=<number>
29

SUBCOMMANDS

31       download
32              Downloads everything needed to upgrade to a new major release.
33
34       reboot Prepares the system to perform the upgrade, and reboots to start
35              the  upgrade.   This can only be used after the download command
36              completes successfully.
37
38       clean  Remove previously-downloaded data. This happens automatically at
39              the end of a successful upgrade.
40
41       log    Used  to  see  a  list  of  boots  during  which  an upgrade was
42              attempted, or show the logs from an upgrade  attempt.  The  logs
43              for  one of the boots can be shown by specifying one of the num‐
44              bers in the first column. Negative numbers can be used to number
45              the  boots  from last to first. For example, log --number=-1 can
46              be used to see the logs for the last upgrade attempt.
47

OPTIONS

49       --releasever=VERSION
50              REQUIRED. The version to upgrade to.  Sets  $releasever  in  all
51              enabled repos. Usually a number, or rawhide.
52
53       --downloaddir=<path>
54              Redirect  download  of  packages to provided <path>. By default,
55              packages are downloaded into (per repository created)  subdirec‐
56              tories of /var/lib/dnf/system-upgrade.
57
58       --distro-sync
59              Behave  like  dnf  distro-sync: always install packages from the
60              new release, even if they are older than the currently-installed
61              version. This is the default behavior.
62
63       --no-downgrade
64              Behave  like  dnf  update:  do not install packages from the new
65              release if they are older than what is currently installed. This
66              is  the  opposite  of  --distro-sync. If both are specified, the
67              last option will be used.
68
69       --number
70              Applied with log subcommand will show the log specified  by  the
71              number.
72

NOTES

74       dnf system-upgrade reboot does not create a "System Upgrade" boot item.
75       The upgrade will start regardless of which boot item is chosen.
76
77       Since this is a DNF plugin, options accepted  by  dnf  are  also  valid
78       here, such as --allowerasing.  See dnf(8) for more information.
79
80       The  fedup  command  is not provided, not even as an alias for dnf sys‐
81       tem-upgrade.
82

BUGS

84       Upgrading from install media  (e.g.  a  DVD  or  .iso  file)  currently
85       requires the user to manually set up a DNF repo and fstab entry for the
86       media.
87

EXAMPLES

89   Typical upgrade usage
90       dnf --refresh upgrade
91
92       dnf system-upgrade download --releasever 26
93
94       dnf system-upgrade reboot
95
96   Show logs from last upgrade attempt
97       dnf system-upgrade log --number=-1
98

REPORTING BUGS

100       Bugs should be filed here:
101          https://bugzilla.redhat.com/
102
103       For more info on filing bugs, see the Fedora Project wiki:
104          https://fedoraproject.org/wiki/How_to_file_a_bug_report
105
106          https://fedoraproject.org/wiki/Bugs_and_feature_requests
107
108       Please include /var/log/dnf.log and the output  of  dnf  system-upgrade
109       log --number=-1 (if applicable) in your bug reports.
110
111       Problems  with  dependency solving during download are best reported to
112       the maintainers of the package(s) with the dependency problems.
113
114       Similarly, problems encountered on your system after the  upgrade  com‐
115       pletes  should  be  reported  to the maintainers of the affected compo‐
116       nents. In other words: if (for example) KDE stops working, it's best if
117       you report that to the KDE maintainers.
118

AUTHORS

126       Will Woods <wwoods@redhat.com>
127
128       Štěpán Smetana <ssmetana@redhat.com>
129

AUTHOR

131       See AUTHORS in your Extras DNF Plugins distribution
132

COPYRIGHT

134       2019, Igor Gnatenko, Licensed under GPLv2+
135
136
137
138
1394.0.8                            Nov 07, 2019     DNF.PLUGIN.SYSTEM-UPGRADE(8)