Bug 1223889

Summary: [doc] Issue in "Regenerating the initramfs" -- needs additional scenario added
Product: [openSUSE] PUBLIC SUSE Linux Enterprise Server 15 SP5 Reporter: Jared Hudson <jared.hudson>
Component: DocumentationAssignee: Tomáš Bažant <tbazant>
Status: RESOLVED FIXED QA Contact: Frank Sundermeyer <fs>
Severity: Normal    
Priority: P5 - None CC: brad.bendily, jared.hudson
Version: unspecified   
Target Milestone: ---   
Hardware: Other   
OS: SLES 15   
Whiteboard: https://jira.suse.com/browse/DOCTEAM-1438
Found By: --- Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

Description Jared Hudson 2024-05-03 17:53:07 UTC
Regenerating the initramfs:

https://documentation.suse.com/sles/15-SP5/single-html/SLES-administration/#sec-boot-initrd-regenerate

In that section it says:
-------------------------------
However, there are some occasions when you need to regenerate an initramfs manually:

    Adding drivers because of hardware changes

    Moving system directories to a RAID or LVM

    Adding disks to an LVM group or Btrfs RAID containing the root file system

    Changing kernel variables 
-------------------------------
Please add an additional entry to warn customers of another scenario for which they need to regenerate the initramfs.

* Adding, removing swap devices or recreating swap area

-------------------------------
below that it could be described as:

Adding, removing swap devices or recreating swap area
   Whenever you add or remove a swap device or recreate a swap area with a different UUID, you need to update the initramfs as outlined in Procedure 16.1, “Generate an initramfs”. You may also need to update GRUB_CMDLINE_* variables that reference resume= in /etc/default/grub then regenerate /boot/grub2/grub.cfg as outlined in section 18.2.1.
-------------------------------
Comment 1 Tomáš Bažant 2024-05-27 08:16:52 UTC
Thank you for reporting this bug!
It is being tracked and processed as part of our queue.
Comment 2 Tomáš Bažant 2024-06-24 11:36:59 UTC
progress is tracked in https://github.com/SUSE/doc-sle/pull/1735
@Jared, can you review please?
Comment 3 Jared Hudson 2024-06-24 13:56:31 UTC
(In reply to Tomáš Bažant from comment #2)
> progress is tracked in https://github.com/SUSE/doc-sle/pull/1735
> @Jared, can you review please?

The change seems good.