Differences

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

--- debian:upgradepathtemplate [2025/04/28 04:19] – old revision restored (2022/06/10 17:53) 37.187.226.31
+++ debian:upgradepathtemplate [2026/05/23 00:35] (current) – old revision restored (2024/03/01 06:38) 113.44.101.108
@@ Line 5: / Line 5: @@
 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.
-. Preparing for the upgrade
+===== 1. Preparing for the upgrade =====
+==== 1.1. Back up any data or configuration information ====
+==== 1.2. Inform users in advance ====
+==== 1.3. Prepare for downtime on services ====
-.1. Back up any data or configuration information
-.2. Inform users in advance
-.3. Prepare for downtime on services
             Set maintainance window for upgrade with buffer
-.4. Prepare for recovery
+==== 1.4. Prepare for recovery ====
             Verify the recoverability of system from backup image
-.5. Prepare a safe environment for the upgrade
+==== 1.5. Prepare a safe environment for the upgrade ====
             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 =====
-. Checking system status
   find NON-Pure Debian packages
@@ Line 23: / Line 37: @@
     # apt-forktracer | sort
-.1. Review actions pending in package manager
+==== 2.1. Review actions pending in package manager ====
             # aptitude
             Select GO and review
-.2. Disabling APT pinning
+==== 2.2. Disabling APT pinning ====
             check /etc/apt/preferences & /etc/apt/preferences.d/ for entries
-.3. Checking packages status
+==== 2.3. Checking packages status ====
             # dpkg --audit
             # aptitude search "~ahold"
@@ Line 34: / Line 51: @@
          To remove a hold on a package: echo package_name install | dpkg --set-selections
-.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 ====
-.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 =====
-. Upgrading current version
 .1. Update current installation
@@ Line 50: / Line 70: @@
             see 3.3 above
-. Preparing sources for APT
+===== 4. Preparing sources for APT =====
 .1. Adding APT Internet sources
@@ Line 60: / Line 81: @@
             Only required for special 3rd party delivered software
-. Upgrading packages
+===== 5. Upgrading packages =====
     Ensure all partition mountpoints are mounted read-write
@@ Line 82: / Line 104: @@
             See 3.3 above
-. Possible issues during upgrade
+===== 6. Possible issues during upgrade =====
 .1. Dist-upgrade fails with “Could not perform immediate configuration”
@@ Line 103: / Line 126: @@
             Ctrl+Alt+F1 should recover the terminal window
-. Upgrading kernel and related packages
+===== 7. Upgrading kernel and related packages =====
 .1. Install any needed kernel metapackage
@@ Line 113: / Line 137: @@
                 # apt-cache show linux-image-amd64
-. Preparing for the next release
+===== 8. Preparing for the next release =====
 .1. Purging removed packages
@@ Line 125: / Line 150: @@
                 # aptitude purge '~c'
-. Obsolete packages
+===== 9. Obsolete packages =====
 .1. Dummy packages