Differences between revisions 10 and 41 (spanning 31 versions)
Revision 10 as of 2011-01-05 21:27:17
Size: 1467
Editor: ?KarlOPinc
Comment: Note that release notes should be followed when upgrading major releases.
Revision 41 as of 2022-11-14 02:14:11
Size: 3895
Editor: PaulWise
Comment: https
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
||<tablestyle="width: 100%;" style="border: 0px hidden">~-Translation(s): [[pt_BR/DebianUpgrade|Brasileiro]] - [[DebianUpgrade|English]] - [[fr/DebianUpgrade|Français]] - [[it/DebianUpgrade|Italiano]]- [[ru/DebianUpgrade|Русский]] -~||<style="text-align: right;border: 0px hidden"> (!) [[/Discussion|Discussion]]|| ##For Translators - to have a constantly up to date translation header in you page, you can just add a line like the following (with the comment's character at the start of the line removed)
## <<Include(DebianUpgrade, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
##TAG:TRANSLATION-HEADER-START
||<tablestyle="width: 100%;" style="border: 0px hidden">~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: [[DebianUpgrade|English]] - [[es/DebianUpgrade|Español]] - [[fr/DebianUpgrade|Français]] - [[it/DebianUpgrade|Italiano]] - [[pt_BR/DebianUpgrade|Português (Brasil)]] - [[ru/DebianUpgrade|Русский]] - [[sv/DebianUpgrade|Svenska]] -~||<style="text-align: right;border: 0px hidden"> (!) [[/Discussion|Discussion]]||
##TAG:TRANSLATION-HEADER-END
Line 5: Line 10:
This page gives the directions how to upgrade your Debian distribution This page gives directions on how to upgrade your Debian distribution.
Line 7: Line 12:
## If your page gets really long, uncomment this Table of Contents  ## If your page gets really long, uncomment this Table of Contents
Line 10: Line 15:
= How to upgrade your distribution =
Upgrading from one stable release to the next (e.g. Lenny to Squeeze) is done by following the [[http://www.debian.org/releases/stable/releasenotes|release notes]] for your [[http://www.debian.org/ports/|architecture]]. For most people with 32 bit systems that means the [[http://www.debian.org/releases/stable/i386/release-notes/|Release Notes for Intel x86]]. For most with 64 bit systems that means the [[http://www.debian.org/releases/stable/amd64/release-notes/|Release Notes for AMD64]].
= How to release upgrade your distribution =
Upgrading from one stable release to the next (e.g. <<DebianCodename(oldstable)>> to <<DebianCodename(stable)>>) is done by following the [[https://www.debian.org/releases/stable/releasenotes|release notes]] for your [[https://www.debian.org/ports/|architecture]]. For most users, that means the [[https://www.debian.org/releases/stable/amd64/release-notes/|Release Notes for AMD64]].
Line 13: Line 18:
Minor upgrades are done with the package management tools: {{{#!wiki caution
'''Back up your data'''
Line 15: Line 21:
 * [[Synaptic#upgrade|Using Synaptic]]
 * [[Aptitude#upgrade|Using aptitude]]
Performing a release upgrade is never without risk. The upgrade may fail, leaving the system in a non-functioning state. USERS SHOULD BACKUP ALL DATA before attempting a release upgrade. DebianStability contains more information on these steps.
}}}
Line 18: Line 24:
= See also =
 * DebianRelease
 * DistUpgradeIssues
 * Sarge2EtchUpgrade
 * [[dist-upgradeOnSmallHardrives]]
----
## You can add other _helpful_ links here.
##See also:
## If this page belongs to an existing Category, add it below.
 QuickPackageManagement
Upgrading a system can take several hours, depending on the number of installed packages and the speed of the system, especially its hard disks. While the download portion of the upgrade can be done separately, the actual install portion should be done in a single pass. Most of the upgrade process is quite hands-off, but some administrator action is needed towards the end of the process if the system has a custom configuration.

Upgrades are done with [[PackageManagementTools|package management tools]], [[root]] or [[sudo]] access, and generally involve the following steps.

 * Obtain a text shell.
   * On desktop machines, switch to console tty via Ctrl+Alt+F3 (the upgrade should be done on a text console, because your desktop environment could freeze during post-install/service restarts, leaving the system in a broken state.)
 * Run the following, by entering lines beginning with $ into the shell:

{{{
# First, ensure your system is up-to-date in it's current release.
$ sudo apt update
$ sudo apt upgrade
$ sudo apt full-upgrade

# If you haven't already, ensure all backups are up-to-date.

# In a text editor, replace the codename of your release with that of the next release in APT's package sources
# For instance, the line
# deb https://deb.debian.org/debian/ buster main
# should be replaced with
# deb https://deb.debian.org/debian/ bullseye main
$ sudo nano /etc/apt/sources.list /etc/apt/sources.list.d/*

# Clean and update package lists
$ sudo apt clean
$ sudo apt update

# Perform the major release upgrade, removing packages if required
# Interrupting this step after downloading has completed is an excellent way to stress-test your backups
$ sudo apt upgrade
$ sudo apt full-upgrade

# Remove packages that are not required anymore
# Be sure to review this list: you may want to keep some of them
$ sudo apt autoremove

# Reboot to make changes effective (optional, but recommended)
$ sudo shutdown -r now
}}}

Now check the output of {{{ uname -a ; lsb_release -a }}} and you should see info about the upgraded system.

-----------------------------
CategoryPackageManagement

Translation(s): English - Español - Français - Italiano - Português (Brasil) - Русский - Svenska

(!) ?Discussion


This page gives directions on how to upgrade your Debian distribution.

How to release upgrade your distribution

Upgrading from one stable release to the next (e.g. bullseye to bookworm) is done by following the release notes for your architecture. For most users, that means the Release Notes for AMD64.

Back up your data

Performing a release upgrade is never without risk. The upgrade may fail, leaving the system in a non-functioning state. USERS SHOULD BACKUP ALL DATA before attempting a release upgrade. DebianStability contains more information on these steps.

Upgrading a system can take several hours, depending on the number of installed packages and the speed of the system, especially its hard disks. While the download portion of the upgrade can be done separately, the actual install portion should be done in a single pass. Most of the upgrade process is quite hands-off, but some administrator action is needed towards the end of the process if the system has a custom configuration.

Upgrades are done with package management tools, root or sudo access, and generally involve the following steps.

  • Obtain a text shell.
    • On desktop machines, switch to console tty via Ctrl+Alt+F3 (the upgrade should be done on a text console, because your desktop environment could freeze during post-install/service restarts, leaving the system in a broken state.)
  • Run the following, by entering lines beginning with $ into the shell:

# First, ensure your system is up-to-date in it's current release.
$ sudo apt update
$ sudo apt upgrade
$ sudo apt full-upgrade

# If you haven't already, ensure all backups are up-to-date.  

# In a text editor, replace the codename of your release with that of the next release in APT's package sources
# For instance, the line
#    deb https://deb.debian.org/debian/ buster main
# should be replaced with
#    deb https://deb.debian.org/debian/ bullseye main
$ sudo nano /etc/apt/sources.list /etc/apt/sources.list.d/*

# Clean and update package lists
$ sudo apt clean
$ sudo apt update

# Perform the major release upgrade, removing packages if required
# Interrupting this step after downloading has completed is an excellent way to stress-test your backups
$ sudo apt upgrade
$ sudo apt full-upgrade

# Remove packages that are not required anymore
# Be sure to review this list: you may want to keep some of them
$ sudo apt autoremove

# Reboot to make changes effective (optional, but recommended)
$ sudo shutdown -r now

Now check the output of  uname -a ; lsb_release -a  and you should see info about the upgraded system.


CategoryPackageManagement