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 19:38]
51.174.65.41 old revision restored (2023/06/30 16:21) 		debian:upgradepathtemplate [2024/04/30 13:42]
54.38.85.21 old revision restored (2023/02/02 14:16)
Line 4: Line 4:
  
 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. 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.
- 
-Debian Release upgrade paths: 
- 
-  Jessie -> Buster -> Bullseye 
-  Stretch -> Buster -> Bullseye 
-  Buster -> Bullseye 
  
 ===== 1. Preparing for the upgrade ===== ===== 1. Preparing for the upgrade =====
Line 24: Line 18:
 ==== 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 ==== ==== 1.6. Develop tests for section 3.3 that will ensure correct execution of needed tasks ====
  
- i.e.: +            i.e.: 
-  a. Web server delivers correctly +                a. Web server delivers correctly 
-  b. php scripts execute correctly +                b. php scripts execute correctly 
-  c. DB runs correctly +                c. DB runs correctly 
-  d. mail works+                d. mail works
  
 ===== 2. Checking system status ===== ===== 2. Checking system status =====
Line 48: Line 42:
 ==== 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" 
-  # dpkg --get-selections | grep 'hold$' +            # dpkg --get-selections | grep 'hold$'
- +
- 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 ====
  
Line 73: Line 64:
  
 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 =====
Line 96: Line 78:
  
 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 
- +            # scriptreplay ~/upgrade-TARGET_RELEASE.time ~/upgrade-TARGET_RELEASE.script
- To replay session use scriptreplay +
-  # 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 =====
Line 150: Line 112:
  
 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 +            # dpkg --remove package_name 
-  # dpkg --remove package_name +        or 
- or +            # apt-get -f install 
-  # apt-get -f install +            # dpkg --configure --pending 
-  # dpkg --configure --pending +        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 =====
Line 181: Line 134:
  
 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 
- +            if none are installed check which ones are available 
-  # dpkg -l "linux-image*" | grep ^ii | grep -i meta +                # apt-cache search linux-image- | grep -i meta | grep -v transition 
- +            select correct one based on value returned by running "uname -r" eg. kernel “2.6.32-5-amd64” 
- if none are installed check which ones are available +                # apt-cache show linux-image-amd64
- +
-  # apt-cache search linux-image- | grep -i meta | grep -v transition +
- +
- select correct one based on value returned by running "uname -r" eg. kernel “2.6.32-5-amd64” +
- +
-  # apt-cache show linux-image-amd64+
  
 ===== 8. Preparing for the next release ===== ===== 8. Preparing for the next release =====
Line 198: Line 145:
  
 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 
- +                # dpkg -l | awk '/^rc/ { print $2 }' 
- get list of removed packages +            remove using 
- +                # apt-get purge $(dpkg -l | awk '/^rc/ { print $2 }') 
-  # dpkg -l | awk '/^rc/ { print $2 }' +            or use 
- +                # aptitude search '~c' 
- remove using +                # aptitude purge '~c'
- +
-  # apt-get purge $(dpkg -l | awk '/^rc/ { print $2 }') +
- +
- or use +
- +
-  # aptitude search '~c' +
-  # aptitude purge '~c'+
  
 ===== 9. Obsolete packages ===== ===== 9. Obsolete packages =====
debian/upgradepathtemplate.txt · Last modified: 2024/05/21 20:00 by 18.217.181.166 · Currently locked by: 3.147.47.82

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