From Fedora Project Wiki

(add a note on using yum swap)
(tweak the dnf section text a bit, add an admon explicitly stating that direct yum/dnf upgrade is not supported)
(12 intermediate revisions by 5 users not shown)
Line 3: Line 3:
== Upgrading Fedora Products ==
== Upgrading Fedora Products ==


This section has some notes on upgrading to Fedora products.  Fedora 21 introduces three new products including workstation, server and cloud. If you are unfamiliar with them, refer to [[fedora.next]] page first.   
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.   


=== Can I upgrade to Fedora 21 without moving to using one of the products? ===
=== Do I need to specify or worry about products when upgrading from Fedora 21 or newer? ===


Yes. Although we are focusing on the products moving forward, upgrading from the existing official variants including Fedora Spins should continue to work.  Just use fedup as usual.  After the upgrade, you should have fedora-release-standard package installed.  
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).


=== How do I upgrade to one of the products? ===
== Upgrading with DNF system upgrade plugin ==
{{admon/note|Recommended Upgrade Method|This is the recommended method for Fedora upgrades.}}
For instructions on upgrading with the DNF system upgrade plugin, refer to [[DNF system upgrade|the dedicated page]].


Upgrade using fedup and then install the appropriate fedora-release package. Example:
== Upgrading directly using yum or DNF ==
{{admon/warning|Not a recommended upgrade method|This is '''NOT''' an officially recommended method for Fedora upgrades.}}


<code> yum swap fedora-release-standard fedora-release-workstation </code>
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]].
 
The release packages are as follows:
 
Workstation:  fedora-release-workstation 
 
Server:  fedora-release-server
 
Cloud: fedora-release-cloud
 
===  If I choose to upgrade to one of the products, can I move to another later? ===
 
Only a transition from cloud from server is planned to be supported in a future release.  If you are repurposing your system, a reinstallation is recommended for others.
 
=== Can I move from non productized installations to one of the products and vice versa? ===
 
This should work either way but not explicitly supported.
 
== Upgrading with FedUp ==
{{admon/note|Recommended Upgrade Method (for upgrading ''to'' Fedora 18 and newer)| This is the recommended method to upgrade your Fedora system to Fedora 18 and newer.  Note that FedUp is only available in Fedora 17 and later.  For instructions on upgrading, refer to [[FedUp#How_Can_I_Upgrade_My_System_with_FedUp.3F|the FedUp page]].}}
 
== Upgrading directly using Yum ==
Upgrading directly from one release to the next using {{command|yum}} is not explicitly tested by Fedora QA and issues with it are not considered blockers for a release, but in practise 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 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]].
== Using the DVD to upgrade ==
{{admon/note | Recommended Upgrade Method (when upgrading to Fedora 17 or earlier releases) | This was the recommended method for upgrading to releases up to Fedora 17. DVD upgrades are not available for later releases; instead, please use [[FedUp]].}}
For upgrading to all releases up to Fedora 17, the process of using Anaconda installer to upgrade was the recommended and supported method and detailed in the [http://docs.fedoraproject.org/en-US/Fedora/17/html/Installation_Guide/index.html Fedora Installation Guide]. However, for best results when migrating from unsupported versions to newer versions, back up your user and configuration data and perform a fresh installation.


== Tips ==
== Tips ==


* It's a good idea to have a backup of your system before performing an upgrade. Keeping {{filename|/home}} in a separate logical volume or partition makes backing up user data easier, because the home partition can be reused when upgrading or reinstalling. This is the default from Fedora 13 onwards.
* Ensure you have a good backup of your data.
 
* Doing a clean installation and then restoring user data from backups may work better for some users. Future releases may include features to assist in this process. Refer to [[Anaconda/WorkItems#upgrade|  AnacondaWorkItems]]  for more information.


* Make sure 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 ==
== Rawhide ==


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.
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.
{{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. }}
{{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]].
* To move from Rawhide to a stable release, refer to [[Upgrading from pre-release to final]].
* To move from a stable release to Rawhide, refer to [[Releases/Rawhide]].
* To move from a stable release to Rawhide, refer to [[Releases/Rawhide]].

Revision as of 18:54, 2 November 2015

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

Note.png
Recommended Upgrade Method
This is the recommended method for Fedora upgrades.

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

Upgrading directly using yum or DNF

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

Upgrading directly from one release to the next using dnf (or 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 dnf or yum.

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.

Tips

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

Rawhide

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.

Warning.png
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.