Chucks notes and stuff

User Tools

Site Tools

Trace:
debian:upgradepathtemplate

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
debian:upgradepathtemplate [2024/04/17 22:13]
51.174.65.41 old revision restored (2024/04/14 18:29) 		debian:upgradepathtemplate [2024/04/30 10:43]
65.108.0.71 old revision restored (2022/11/16 21:13)
Line 1: Line 1:
 ====== Template for Debian System Release Upgrade ====== ====== Template for Debian System Release Upgrade ======
  
-1. Preparing for the upgrade+This template is meant to serve as a general upgrade path for any Debian release. This is my standard path and will be adjusted based on the "old" current release installed on the system and the target "new" release the server is being upgraded to. 
 + 
 +I will normally create a complete system clone and use this template to work out the entire correct and functional path for the production system in question. 
 + 
 +===== 1. Preparing for the upgrade ===== 
  
 1.1. Back up any data or configuration information 1.1. Back up any data or configuration information
-    1.2. Inform users in advance +1.2. Inform users in advance 
-    1.3. Prepare for downtime on services+1.3. Prepare for downtime on services
             Set maintainance window for upgrade with buffer             Set maintainance window for upgrade with buffer
-    1.4. Prepare for recovery+1.4. Prepare for recovery
             Verify the recoverability of system from backup image             Verify the recoverability of system from backup image
-    1.5. Prepare a safe environment for the upgrade+1.5. Prepare a safe environment for the upgrade
             Local terminal or SSH access             Local terminal or SSH access
 +1.6. Develop tests for section 3.3 that will ensure correct execution of needed tasks
 +            i.e.:
 +                a. Web server delivers correctly
 +                b. php scripts execute correctly
 +                c. DB runs correctly
 +                d. mail works
 +
 +===== 2. Checking system status =====
  
-2. Checking system status 
  
   find NON-Pure Debian packages   find NON-Pure Debian packages
Line 19: Line 31:
     # apt-forktracer | sort     # apt-forktracer | sort
  
-    2.1. Review actions pending in package manager+2.1. Review actions pending in package manager
             # aptitude             # aptitude
             Select GO and review             Select GO and review
-    2.2. Disabling APT pinning+2.2. Disabling APT pinning
             check /etc/apt/preferences & /etc/apt/preferences.d/ for entries             check /etc/apt/preferences & /etc/apt/preferences.d/ for entries
-    2.3. Checking packages status+2.3. Checking packages status
             # dpkg --audit             # dpkg --audit
             # aptitude search "~ahold"             # aptitude search "~ahold"
Line 30: Line 42:
  
          To remove a hold on a package: echo package_name install | dpkg --set-selections          To remove a hold on a package: echo package_name install | dpkg --set-selections
-    2.4. Remove proposed-updates section if present in /etc/apt/sources.list +2.4. Remove proposed-updates section if present in /etc/apt/sources.list 
-    2.5. Verify Unofficial sources are available for target Debian version+2.5. Verify Unofficial sources are available for target Debian version
  
-3. Upgrading current version+===== 3. Upgrading current version =====
  
-    3.1. Update current installation+ 
 +3.1. Update current installation
             # sudo apt update             # sudo apt update
-    3.2. Upgrade current installation+3.2. Upgrade current installation
             # sudo apt upgrade             # sudo apt upgrade
-    3.3. Check functionality+3.3. Check functionality
             Verify all services required of current host is functioning correctly             Verify all services required of current host is functioning correctly
-    3.4. Upgrade current distribution+3.4. Upgrade current distribution
             # sudo apt dist-upgrade             # sudo apt dist-upgrade
-    3.5. Check functionality+3.5. Check functionality
             see 3.3 above             see 3.3 above
  
-4. Preparing sources for APT+===== 4. Preparing sources for APT ===== 
  
-    4.1. Adding APT Internet sources+4.1. Adding APT Internet sources
             # sudo sed -i 's/CURRENT_RELEASE/TARGET_RELEASE/g' /etc/apt/sources.list             # sudo sed -i 's/CURRENT_RELEASE/TARGET_RELEASE/g' /etc/apt/sources.list
             # sudo sed -i 's/CURRENT_RELEASE/TARGET_RELEASE/g' /etc/apt/sources.list.d/*             # sudo sed -i 's/CURRENT_RELEASE/TARGET_RELEASE/g' /etc/apt/sources.list.d/*
-    4.2. Adding APT sources for a local mirror+4.2. Adding APT sources for a local mirror
             Only required for special in-house software             Only required for special in-house software
-    4.3. Adding APT sources from optical media+4.3. Adding APT sources from optical media
             Only required for special 3rd party delivered software             Only required for special 3rd party delivered software
  
-5. Upgrading packages+===== 5. Upgrading packages ===== 
  
     Ensure all partition mountpoints are mounted read-write     Ensure all partition mountpoints are mounted read-write
         # mount -o remount,rw /mountpoint         # mount -o remount,rw /mountpoint
  
-    5.1. Recording the session+5.1. Recording the session
             # script -t 2>~/upgrade-TARGET_RELEASEstep.time -a ~/upgrade-TARGET_RELEASEstep.script             # script -t 2>~/upgrade-TARGET_RELEASEstep.time -a ~/upgrade-TARGET_RELEASEstep.script
          To replay session use scriptreplay          To replay session use scriptreplay
             # scriptreplay ~/upgrade-TARGET_RELEASE.time ~/upgrade-TARGET_RELEASE.script             # scriptreplay ~/upgrade-TARGET_RELEASE.time ~/upgrade-TARGET_RELEASE.script
-    5.2. Updating the package list+5.2. Updating the package list
             # apt-get update             # apt-get update
-    5.3. Make sure you have sufficient space for the upgrade+5.3. Make sure you have sufficient space for the upgrade
             # apt-get -o APT::Get::Trivial-Only=true dist-upgrade             # apt-get -o APT::Get::Trivial-Only=true dist-upgrade
-    5.4. Minimal system upgrade+5.4. Minimal system upgrade
             # apt-get upgrade             # apt-get upgrade
-    5.5. Check functionality+5.5. Check functionality
             See 3.3 above             See 3.3 above
-    5.6. Upgrading the system+5.6. Upgrading the system
             # apt-get dist-upgrade             # apt-get dist-upgrade
-    5.7. Check functionality+5.7. Check functionality
             See 3.3 above             See 3.3 above
  
-6. Possible issues during upgrade+===== 6. Possible issues during upgrade =====
  
-    6.1. Dist-upgrade fails with “Could not perform immediate configuration”+ 
 +6.1. Dist-upgrade fails with “Could not perform immediate configuration”
             # apt-get dist-upgrade -o APT::Immediate-Configure=0             # apt-get dist-upgrade -o APT::Immediate-Configure=0
-    6.2. Expected removals +6.2. Expected removals 
-    6.3. Conflicts or Pre-Depends loops+6.3. Conflicts or Pre-Depends loops
             use -o APT::Force-LoopBreak=1 with apt-get             use -o APT::Force-LoopBreak=1 with apt-get
          or          or
Line 92: Line 108:
         or         or
             # dpkg --install /path/to/package_name.deb             # dpkg --install /path/to/package_name.deb
-    6.4. File conflicts+6.4. File conflicts
             # dpkg -r --force-depends package_name             # dpkg -r --force-depends package_name
-    6.5. Configuration changes+6.5. Configuration changes
             Usually answer "YES" to files in /etc/init.d directory or /etc/manpath.config             Usually answer "YES" to files in /etc/init.d directory or /etc/manpath.config
-    6.6. Change of session to console+6.6. Change of session to console
             Ctrl+Alt+F1 should recover the terminal window             Ctrl+Alt+F1 should recover the terminal window
  
-7. Upgrading kernel and related packages+===== 7. Upgrading kernel and related packages =====
  
-    7.1. Install any needed kernel metapackage+ 
 +7.1. Install any needed kernel metapackage
             Check for meta package             Check for meta package
                 # dpkg -l "linux-image*" | grep ^ii | grep -i meta                 # dpkg -l "linux-image*" | grep ^ii | grep -i meta
Line 109: Line 126:
                 # apt-cache show linux-image-amd64                 # apt-cache show linux-image-amd64
  
-8. Preparing for the next release+===== 8. Preparing for the next release =====
  
-    8.1. Purging removed packages+ 
 +8.1. Purging removed packages
             Remove redundant or obsolete packages. see 5.3 above             Remove redundant or obsolete packages. see 5.3 above
             get list of removed packages             get list of removed packages
Line 121: Line 139:
                 # aptitude purge '~c'                 # aptitude purge '~c'
  
-9. Obsolete packages+===== 9. Obsolete packages ===== 
  
-    9.1. Dummy packages+9.1. Dummy packages
debian/upgradepathtemplate.txt · Last modified: 2024/05/21 09:09 by 3.145.7.116

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki