From Fedora Project Wiki

(tweak the dnf section text a bit, add an admon explicitly stating that direct yum/dnf upgrade is not supported)
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{autolang|base=yes}}
{{autolang|base=yes}}
== Upgrading Fedora Products ==
This section has some notes on upgrading to Fedora products.  Fedora 21 introduced three new products: Workstation, Server and Cloud. If you are unfamiliar with them, you may wish to refer to [[Fedora.next]] first. 
=== Do I need to specify or worry about products when upgrading from Fedora 21 or newer? ===
No, you don't need to specify a product for upgrades of Fedora 21 or later. Since the products were introduced in Fedora 21, all Fedora 21+ installs have a product identifier (even if that's 'nonproduct'). You only need to specify this when upgrading from a release older than Fedora 21 (which is no longer supported).


== Upgrading with DNF system upgrade plugin ==
== Upgrading with DNF system upgrade plugin ==
{{admon/note|Recommended Upgrade Method|This is the recommended method for Fedora upgrades.}}
{{admon/note|Recommended Upgrade Method|This is the recommended method for upgrades of '''all Fedora installs except Fedora Atomic Host'''.}}
For instructions on upgrading with the DNF system upgrade plugin, refer to [[DNF system upgrade|the dedicated page]].
For instructions on upgrading with the DNF system upgrade plugin, refer to [[DNF system upgrade|the dedicated page]].


== Upgrading directly using yum or DNF ==
== Online rebases for [https://getfedora.org/en/cloud/download/atomic.html Fedora Atomic Host] via rpm-ostree ==
{{admon/note|Recommended Upgrade Method for Atomic Host|This is the recommended method for upgrades of '''[https://getfedora.org/en/cloud/download/atomic.html Fedora Atomic Host] installations'''.}}
For instructions on upgrading Fedora Atomic Host installations between Fedora releases, refer to [[Atomic Host upgrade|the dedicated page]].
 
== Online upgrade with pure DNF ==
{{admon/warning|Not a recommended upgrade method|This is '''NOT''' an officially recommended method for Fedora upgrades.}}
{{admon/warning|Not a recommended upgrade method|This is '''NOT''' an officially recommended method for Fedora upgrades.}}
Upgrading from one release to the next using {{command|dnf}} directly, without the DNF system upgrade plugin, is not explicitly tested by Fedora QA and issues with it are not considered blockers for a release, but in practice it works for many users. To learn more, refer to [[Upgrading_Fedora_using_package_manager|Upgrading Fedora using dnf]].


Upgrading directly from one release to the next using {{command|dnf}} (or {{command|yum}} for releases before Fedora 22) is not explicitly tested by Fedora QA and issues with it are not considered blockers for a release, but in practice it works for many users, probably due to our packaging guidelines providing detailed information on maintaining upgradability.  To learn more, refer to [[Upgrading Fedora using yum|Upgrading Fedora using dnf or yum]].
== Updating from a pre-release (Alpha, Beta, or other development snapshot) to the final release ==
 
== Upgrading from a pre-release (Alpha, Beta, or other development snapshot) to the final release ==


If you are using a pre-release of Fedora, and want to know more about upgrading to the final release, refer to [[Upgrading from pre-release to final]].
If you are using a pre-release of Fedora, and want to know more about upgrading to the final release, refer to [[Upgrading from pre-release to final]]. This is not technically an 'upgrade' operation, it is simply an update, but there are some special considerations involved in making sure you stay on the update track you intend to use, which are documented on this page.


== Tips ==
== Tips ==
Line 28: Line 23:
* Ensure you read the [http://docs.fedoraproject.org/en-US/Fedora/{{FedoraVersionNumber}}/html/Release_Notes/ Release Notes] carefully before attempting an upgrade.
* Ensure you read the [http://docs.fedoraproject.org/en-US/Fedora/{{FedoraVersionNumber}}/html/Release_Notes/ Release Notes] carefully before attempting an upgrade.


== Rawhide ==
== Upgrading to Rawhide and Branched ==


Rawhide is a development version of Fedora that is updated daily. It is suitable for people who are developing or testing Fedora before broad public release.
[[Releases/Rawhide|Rawhide]] and [[Releases/Branched|Branched]] are the development releases of Fedora. They are suitable for people who are developing or testing Fedora before broad public release. They are '''NOT SUITABLE''' for regular day-to-day use unless you are a fairly experienced user, and certainly not suitable for mission-critical use. You should read through those pages carefully before deciding to run Branched or, particularly, Rawhide. See [[Fedora Release Life Cycle]] for more information on how the whole Fedora cycle works from Rawhide, to Branched, to the milestone releases (Alpha and Beta), to a 'final' release.
{{Admon/warning | Rawhide is not for casual use! | Packages in rawhide aren't inherently unstable, but interactions and dependencies between packages there can be unpredictable. The testing performed in release branches to prevent these conflicts isn't there in rawhide - or, more correctly, it happens in rawhide so that the release branches can benefit. Do not use Rawhide just for newer versions of a package; use it when you are an experienced user that wants to actively contribute to a stable rawhide.}}


* To move from Rawhide to a stable release, refer to [[Upgrading from pre-release to final]].
If you are sure you want to do it, upgrading to a Branched release or to Rawhide can be done with [[DNF system upgrade]] just like upgrading to a newer stable release. There are just a couple of special notes that are covered in the instructions.
* To move from a stable release to Rawhide, refer to [[Releases/Rawhide]].

Revision as of 19:37, 1 April 2016

Upgrading with DNF system upgrade plugin

Note.png
Recommended Upgrade Method
This is the recommended method for upgrades of all Fedora installs except Fedora Atomic Host.

For instructions on upgrading with the DNF system upgrade plugin, refer to the dedicated page.

Online rebases for Fedora Atomic Host via rpm-ostree

Note.png
Recommended Upgrade Method for Atomic Host
This is the recommended method for upgrades of Fedora Atomic Host installations.

For instructions on upgrading Fedora Atomic Host installations between Fedora releases, refer to the dedicated page.

Online upgrade with pure DNF

Warning.png
Not a recommended upgrade method
This is NOT an officially recommended method for Fedora upgrades.

Upgrading from one release to the next using dnf directly, without the DNF system upgrade plugin, is not explicitly tested by Fedora QA and issues with it are not considered blockers for a release, but in practice it works for many users. To learn more, refer to Upgrading Fedora using dnf.

Updating from a pre-release (Alpha, Beta, or other development snapshot) to the final release

If you are using a pre-release of Fedora, and want to know more about upgrading to the final release, refer to Upgrading from pre-release to final. This is not technically an 'upgrade' operation, it is simply an update, but there are some special considerations involved in making sure you stay on the update track you intend to use, which are documented on this page.

Tips

  • Ensure you have a good backup of your data.
  • Ensure you read the Release Notes carefully before attempting an upgrade.

Upgrading to Rawhide and Branched

Rawhide and Branched are the development releases of Fedora. They are suitable for people who are developing or testing Fedora before broad public release. They are NOT SUITABLE for regular day-to-day use unless you are a fairly experienced user, and certainly not suitable for mission-critical use. You should read through those pages carefully before deciding to run Branched or, particularly, Rawhide. See Fedora Release Life Cycle for more information on how the whole Fedora cycle works from Rawhide, to Branched, to the milestone releases (Alpha and Beta), to a 'final' release.

If you are sure you want to do it, upgrading to a Branched release or to Rawhide can be done with DNF system upgrade just like upgrading to a newer stable release. There are just a couple of special notes that are covered in the instructions.