stopping server before reboot for migration from 5.0 (#4233) (#4263)

Karl Eichwalder · web-flow · commit ad9b7be740e9 · 2025-08-20T13:56:08.000+02:00
https://bugzilla.suse.com/show_bug.cgi?id=1247705 https://github.com/SUSE/spacewalk/issues/28033 plus drive-by edits
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,6 @@
+- Documented stopping the server before rebooting the host operating
+  system for the migration from 5.0 to 5.1 in Installation and
+  Upgrade Guide (bsc#1247705)
 - Fixed invocation of spacewalk-repo-sync command in Client
   Configuration Guide (bsc#1246883)
 - Removed reference to smdba from reference Guide (bsc#1247213)
diff --git a/modules/installation-and-upgrade/pages/container-deployment/mlm/migrations/proxy/proxy-mlm-50-51.adoc b/modules/installation-and-upgrade/pages/container-deployment/mlm/migrations/proxy/proxy-mlm-50-51.adoc
@@ -373,7 +373,6 @@ Ensure all relevant proxy containers are up:
 - `proxy-tftpd`
 - `proxy-ssh`
 
-_____
 
 
 === Migration Complete
diff --git a/modules/installation-and-upgrade/pages/container-deployment/mlm/migrations/server/server-mlm-50-51.adoc b/modules/installation-and-upgrade/pages/container-deployment/mlm/migrations/server/server-mlm-50-51.adoc
@@ -6,7 +6,7 @@
 [NOTE]
 ====
 * {productname} 5.0 must be stopped before upgrade.
-* {productname} 5.0 is not supported on top of {sl-micro} 6.1 & {sles} 15 SP7 as host os
+* {productname} 5.0 is not supported on top of {sl-micro} 6.1 & {sles} 15 SP7 as host OS.
 ====
 
 include::../../../snippet-hardened-tmpdir.adoc[leveloffset=+2]
@@ -39,14 +39,14 @@ SUSEConnect --status-text
 
 +
 
-**Confirm:**
+Confirm:
 
 - Base OS: `SUSE Linux Enterprise Micro 5.5`
 - Extension: `SUSE Manager Server 5.0 Extension`
 
 +
 
-. Ensure System is Updated
+. Ensure system is updated
 
 +
 
@@ -57,19 +57,25 @@ transactional-update patch
 
 +
 
+--
 
-* If patches were applied, **reboot the system** before proceeding to migration:
+* If patches were applied, stop the server and then reboot the system before proceeding to migration:
+
++
 
 [source,console]
 ----
+mgradm stop
 reboot
 ----
 
 * If no updates were found, you can proceed directly to the migration step.
 
+--
+
 +
 
-. Start the Migration:
+. Start the migration:
 
 +
 
@@ -84,18 +90,19 @@ Follow the prompts and select the available migration to **SUSE Linux Micro 6.1*
 
 +
 
-. Reboot to Apply Changes
+. Stop the server and then reboot to apply changes:
 
 +
 
 [source,console]
 ----
+mgradm stop
 reboot
 ----
 
 +
 
-. Post-Reboot Checks:
+. Post-Reboot checks:
 
 +
 
@@ -143,7 +150,7 @@ systemctl restart sshd
 
 For more information, see xref:administration:troubleshooting/tshoot-remote-root-on-micro.adoc[].
 
-. Upgrade Server Containers
+. Upgrade server containers
 
 +
 
@@ -229,7 +236,7 @@ This document provides the tested procedure to upgrade a SUSE Linux Enterprise S
 [role=procedure]
 _____
 
-. Verify Current Product Status
+. Verify current product status
 
 +
 
@@ -240,7 +247,7 @@ SUSEConnect --status-text
 
 +
 
-**Confirm:**
+Confirm:
 
 +
 
@@ -249,7 +256,7 @@ SUSEConnect --status-text
 
 +
 
-. Apply All System Patches
+. Apply all system patches
 
 +
 
@@ -260,12 +267,13 @@ zypper patch
 
 +
 
-*Reboot* if the update stack was updated:
+. Stop the server, and then reboot if the update stack was updated:
 
 +
 
 [source,console]
 ----
+mgradm stop
 reboot
 ----
 
@@ -286,18 +294,19 @@ Zypper will show the possible migration targets with detailed summaries.
 
 . Select the appropriate target, and follow the prompts to complete the migration.
 
-. After the upgrade completes, reboot the system:
+. After the upgrade completes, stop the server and then reboot the system:
 
 +
 
 [source,console]
 ----
+mgradm stop
 reboot
 ----
 
 +
 
-. Post-Reboot: Verify Upgrade Status
+. Post-Reboot: Verify upgrade status
 
 +
 
@@ -316,7 +325,7 @@ Expected output:
 
 +
 
-. Upgrade Server Containers
+. Upgrade server containers
 
 +
 
@@ -331,7 +340,7 @@ Follow prompts to pull the new container images and reconfigure the environment.
 
 +
 
-. Check Running Containers
+. Check running containers
 
 +
 
@@ -349,7 +358,7 @@ Expected containers:
 
 +
 
-. Verify {productname} Tools Version
+. Verify {productname} Tools version
 
 +
 

Original file line number	Diff line number	Diff line change
`@@ -6,7 +6,7 @@`
`6`	`6`	`[NOTE]`
`7`	`7`	`====`
`8`	`8`	`* {productname} 5.0 must be stopped before upgrade.`
`9`		`-* {productname} 5.0 is not supported on top of {sl-micro} 6.1 & {sles} 15 SP7 as host os`
	`9`	`+* {productname} 5.0 is not supported on top of {sl-micro} 6.1 & {sles} 15 SP7 as host OS.`
`10`	`10`	`====`
`11`	`11`
`12`	`12`	`include::../../../snippet-hardened-tmpdir.adoc[leveloffset=+2]`
`@@ -39,14 +39,14 @@ SUSEConnect --status-text`
`39`	`39`
`40`	`40`	`+`
`41`	`41`
`42`		`-Confirm:`
	`42`	`+Confirm:`
`43`	`43`
`44`	`44`	- Base OS: `SUSE Linux Enterprise Micro 5.5`
`45`	`45`	- Extension: `SUSE Manager Server 5.0 Extension`
`46`	`46`
`47`	`47`	`+`
`48`	`48`
`49`		`-. Ensure System is Updated`
	`49`	`+. Ensure system is updated`
`50`	`50`
`51`	`51`	`+`
`52`	`52`
`@@ -57,19 +57,25 @@ transactional-update patch`
`57`	`57`
`58`	`58`	`+`
`59`	`59`
	`60`	`+--`
`60`	`61`
`61`		`-* If patches were applied, reboot the system before proceeding to migration:`
	`62`	`+* If patches were applied, stop the server and then reboot the system before proceeding to migration:`
	`63`	`+`
	`64`	`++`
`62`	`65`
`63`	`66`	`[source,console]`
`64`	`67`	`----`
	`68`	`+mgradm stop`
`65`	`69`	`reboot`
`66`	`70`	`----`
`67`	`71`
`68`	`72`	`* If no updates were found, you can proceed directly to the migration step.`
`69`	`73`
	`74`	`+--`
	`75`	`+`
`70`	`76`	`+`
`71`	`77`
`72`		`-. Start the Migration:`
	`78`	`+. Start the migration:`
`73`	`79`
`74`	`80`	`+`
`75`	`81`
`@@ -84,18 +90,19 @@ Follow the prompts and select the available migration to *SUSE Linux Micro 6.1`
`84`	`90`
`85`	`91`	`+`
`86`	`92`
`87`		`-. Reboot to Apply Changes`
	`93`	`+. Stop the server and then reboot to apply changes:`
`88`	`94`
`89`	`95`	`+`
`90`	`96`
`91`	`97`	`[source,console]`
`92`	`98`	`----`
	`99`	`+mgradm stop`
`93`	`100`	`reboot`
`94`	`101`	`----`
`95`	`102`
`96`	`103`	`+`
`97`	`104`
`98`		`-. Post-Reboot Checks:`
	`105`	`+. Post-Reboot checks:`
`99`	`106`
`100`	`107`	`+`
`101`	`108`
`@@ -143,7 +150,7 @@ systemctl restart sshd`
`143`	`150`
`144`	`151`	`For more information, see xref:administration:troubleshooting/tshoot-remote-root-on-micro.adoc[].`
`145`	`152`
`146`		`-. Upgrade Server Containers`
	`153`	`+. Upgrade server containers`
`147`	`154`
`148`	`155`	`+`
`149`	`156`
`@@ -229,7 +236,7 @@ This document provides the tested procedure to upgrade a SUSE Linux Enterprise S`
`229`	`236`	`[role=procedure]`
`230`	`237`	`_____`
`231`	`238`
`232`		`-. Verify Current Product Status`
	`239`	`+. Verify current product status`
`233`	`240`
`234`	`241`	`+`
`235`	`242`
`@@ -240,7 +247,7 @@ SUSEConnect --status-text`
`240`	`247`
`241`	`248`	`+`
`242`	`249`
`243`		`-Confirm:`
	`250`	`+Confirm:`
`244`	`251`
`245`	`252`	`+`
`246`	`253`
`@@ -249,7 +256,7 @@ SUSEConnect --status-text`
`249`	`256`
`250`	`257`	`+`
`251`	`258`
`252`		`-. Apply All System Patches`
	`259`	`+. Apply all system patches`
`253`	`260`
`254`	`261`	`+`
`255`	`262`
`@@ -260,12 +267,13 @@ zypper patch`
`260`	`267`
`261`	`268`	`+`
`262`	`269`
`263`		`-Reboot if the update stack was updated:`
	`270`	`+. Stop the server, and then reboot if the update stack was updated:`
`264`	`271`
`265`	`272`	`+`
`266`	`273`
`267`	`274`	`[source,console]`
`268`	`275`	`----`
	`276`	`+mgradm stop`
`269`	`277`	`reboot`
`270`	`278`	`----`
`271`	`279`
`@@ -286,18 +294,19 @@ Zypper will show the possible migration targets with detailed summaries.`
`286`	`294`
`287`	`295`	`. Select the appropriate target, and follow the prompts to complete the migration.`
`288`	`296`
`289`		`-. After the upgrade completes, reboot the system:`
	`297`	`+. After the upgrade completes, stop the server and then reboot the system:`
`290`	`298`
`291`	`299`	`+`
`292`	`300`
`293`	`301`	`[source,console]`
`294`	`302`	`----`
	`303`	`+mgradm stop`
`295`	`304`	`reboot`
`296`	`305`	`----`
`297`	`306`
`298`	`307`	`+`
`299`	`308`
`300`		`-. Post-Reboot: Verify Upgrade Status`
	`309`	`+. Post-Reboot: Verify upgrade status`
`301`	`310`
`302`	`311`	`+`
`303`	`312`
`@@ -316,7 +325,7 @@ Expected output:`
`316`	`325`
`317`	`326`	`+`
`318`	`327`
`319`		`-. Upgrade Server Containers`
	`328`	`+. Upgrade server containers`
`320`	`329`
`321`	`330`	`+`
`322`	`331`
`@@ -331,7 +340,7 @@ Follow prompts to pull the new container images and reconfigure the environment.`
`331`	`340`
`332`	`341`	`+`
`333`	`342`
`334`		`-. Check Running Containers`
	`343`	`+. Check running containers`
`335`	`344`
`336`	`345`	`+`
`337`	`346`
`@@ -349,7 +358,7 @@ Expected containers:`
`349`	`358`
`350`	`359`	`+`
`351`	`360`
`352`		`-. Verify {productname} Tools Version`
	`361`	`+. Verify {productname} Tools version`
`353`	`362`
`354`	`363`	`+`
`355`	`364`