[WIP]:DOCTEAM-2062- kdump by Amrita42 · Pull Request #628 · SUSE/doc-modular

+            <term>WHAT?</term>
+            <listitem>
+              <para>
+               Configure &kdump; in case your system crashes. Its primary purpose is to capture a snapshot of the system's memory (a vmcore file) at the exact moment a kernel crashes (kernel panic).


Suggested change

Configure &kdump; in case your system crashes. Its primary purpose is to capture a snapshot of the system's memory (a vmcore file) at the exact moment a kernel crashes (kernel panic).

&kdump; is a Linux kernel crash dumping mechanism that captures

a snapshot of system memory (a vmcore file) when the Linux kernel

encounters a fatal error (kernel panic).

dariavladykina · 2026-06-12T12:35:50Z

+            <term>WHY?</term>
+            <listitem>
+              <para>
+Correctly setting up kdump and obtaining the memory dump may help SUSE support or kernel developers to debug a potential kernel crash.


Suggested change

Correctly setting up kdump and obtaining the memory dump may help SUSE support or kernel developers to debug a potential kernel crash.

Use Kdump to collect diagnostic data for kernel crash analysis and root-cause

investigation. Correctly setting up Kdump and obtaining the memory dump may

help SUSE support or kernel developers to debug a potential kernel crash.

dariavladykina · 2026-06-12T12:38:45Z

+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:trans="http://docbook.org/ns/transclusion">
+  <info>
+    <title>About &kdump;</title>


Suggested change

<title>About &kdump;</title>

<title>What is &kdump; and how does it work?</title>

dariavladykina · 2026-06-12T12:39:02Z

+    <abstract>
+      <para>
+&kdump; is a kernel crash dumping mechanism that captures the system’s memory state into a vmcore file when
+system crash occurs. A vmcore file is a snapshot of your computer's system memory (RAM) taken at the exact moment the Linux kernel crashed.


Suggested change

system crash occurs. A vmcore file is a snapshot of your computer's system memory (RAM) taken at the exact moment the Linux kernel crashed.

a system crash occurs. A vmcore file is a snapshot of your computer's system memory (RAM) taken at the exact moment the Linux kernel crashed.

dariavladykina · 2026-06-12T12:39:24Z

+    </abstract>
+  </info>
+  <section  xml:id="important-kdump">
+   <title>Why is &kdump; important?</title>


Suggested change

<title>Why is &kdump; important?</title>

<title>Why is &kdump; critical for system crash debugging?</title>

dariavladykina · 2026-06-12T13:31:40Z

+      more memory than estimated by <command>kdumptool calibrate</command> and set up automatically in
+      the boot loader config by the <literal>kdump-commandline.service</literal>.</para>
+      <para>During &kdump;, if you see error messages mentioning low memory and invoking the
+Out of Memory (OOM) killer, this is the likely cause. In case, you don't see such messages, trying with increased crash kernel reservation is a good


Suggested change

Out of Memory (OOM) killer, this is the likely cause. In case, you don't see such messages, trying with increased crash kernel reservation is a good

Out of Memory (OOM) killer, this is the likely cause. If you don't see such messages, trying with increased crash kernel reservation is a good

dariavladykina · 2026-06-12T13:34:05Z

+  <literal>KDUMP_VERBOSE</literal> to 11 turns on debugging output during all stages of the &kdump;
+   process, it:</para>


Suggested change

<literal>KDUMP_VERBOSE</literal> to 11 turns on debugging output during all stages of the &kdump;

process, it:</para>

<literal>KDUMP_VERBOSE</literal> to 11 turns on debugging output during all stages of the &kdump;

process and results in the following behavior:</para>

dariavladykina · 2026-06-12T13:35:22Z

+    <listitem><para> During the capture kernel boot, if you see problems with
+     <literal>makedumpfile</literal>, network config etc., set <literal>KDUMP_CONTINUE_ON_ERROR=false</literal>
+      or <literal>KDUMP_IMMEDIATE_REBOOT=false</literal>. This opens up an interactive shell when
+      an error occurs or when <literal>makedumpfile</literal> finishes,enabling you to manually debug problems
+      from within the capture system.


Suggested change

<listitem><para> During the capture kernel boot, if you see problems with

<literal>makedumpfile</literal>, network config etc., set <literal>KDUMP_CONTINUE_ON_ERROR=false</literal>

or <literal>KDUMP_IMMEDIATE_REBOOT=false</literal>. This opens up an interactive shell when

an error occurs or when <literal>makedumpfile</literal> finishes,enabling you to manually debug problems

from within the capture system.

<listitem><para> During the capture kernel boot, if you see problems with

<literal>makedumpfile</literal>, network config, etc., set <literal>KDUMP_CONTINUE_ON_ERROR=false</literal>

or <literal>KDUMP_IMMEDIATE_REBOOT=false</literal>. This opens up an interactive shell when

an error occurs or when <literal>makedumpfile</literal> finishes, enabling you to manually debug problems

from within the capture system.

dariavladykina · 2026-06-12T13:36:09Z

+<command>mkdumprd -fd</command>. You can also unpack and inspect the generated initramfs image with <command>lsinitrd --unpack /var/lib/kdump/initrd
+</command> command. </para></listitem>


Suggested change

<command>mkdumprd -fd</command>. You can also unpack and inspect the generated initramfs image with <command>lsinitrd --unpack /var/lib/kdump/initrd

</command> command. </para></listitem>

<command>mkdumprd -fd</command>. You can also unpack and inspect the generated initramfs image with <command>lsinitrd --unpack /var/lib/kdump/initrd

</command>. </para></listitem>

dariavladykina · 2026-06-12T13:39:57Z

+      <meta name="title" its:translate="yes">Introduction to kdump</meta>
+      <meta name="social-descr" its:translate="yes">Learn how to configure kdump in case your system crashes. kdump is a
+        kernel crash dumping mechanism. When a system encounters a fatal error, kdump allows the system to save the contents of its memory to a file for expert analysis.</meta>
+
+      <!-- Search -->
+      <meta name="description" its:translate="yes">Use kdump to capture data on system crashes </meta>


Suggested change

<meta name="title" its:translate="yes">Introduction to kdump</meta>

<meta name="social-descr" its:translate="yes">Learn how to configure kdump in case your system crashes. kdump is a

kernel crash dumping mechanism. When a system encounters a fatal error, kdump allows the system to save the contents of its memory to a file for expert analysis.</meta>



<meta name="description" its:translate="yes">Use kdump to capture data on system crashes </meta>

<meta name="title" its:translate="yes">SUSE Linux Kdump Setup and Troubleshooting Guide</meta>

<meta name="social-descr" its:translate="yes">Configure and troubleshoot Kdump on SUSE Linux</meta>

<meta name="description" its:translate="yes">Learn how to install, configure and troubleshoot Kdump on standard and immutable SUSE Linux systems to capture memory snapshots during a kernel crash</meta>

dariavladykina

Hi, please see some suggestions for this article. Thanks!

dariavladykina · 2026-06-12T13:54:01Z

+<!-- S T R U C T U R E -->
+  <structure renderas="article" xml:id="ansible" xml:lang="en">
+    <merge>
+      <title>Introduction to &kdump;</title>


Can we have a longer title, please?

Suggested change

<title>Introduction to &kdump;</title>

<title>Kdump Configuration and Troubleshooting Guide</title>

adds toc structure for kdump

8956dc5

Amrita42 self-assigned this Jan 12, 2026

Amrita42 added 6 commits January 13, 2026 15:20

intro

9a09a2a

intro

02c57dc

vmcore

c711428

placement of list

fa9b2ca

installing kdump

4d968d9

trubleshoot

2912b0b

Amrita42 changed the title ~~[WIP]DOCTEAM-2062: adds toc structure for kdump~~ [WIP]DOCTEAM-2062: kdump Jan 20, 2026

Amrita42 added 2 commits January 21, 2026 15:16

trobleshooting

01c5092

more info

09f9f4f

Amrita42 changed the title ~~[WIP]DOCTEAM-2062: kdump~~ [WIP]:DOCTEAM-2062- kdump Jan 22, 2026

Amrita42 added 3 commits February 2, 2026 11:27

more info

30f208d

configure kdump

31c29d7

configure and asm file

65b5e3e

Amrita42 added 10 commits February 6, 2026 13:07

review

7861f4d

tech review-part 1

5410fa7

fdbk

865ed40

tech feedback-part1

30ec13a

troubleshooting

ac3a998

troubleshooting

cd7f96a

feedback-2

bb3dee6

feedback-3

74844d1

other configs

69808da

feedback

8e2c62f

dc-sap

2c8d0ef

Amrita42 requested a review from lvicoun May 27, 2026 09:12

productnumber

705605c

lvicoun requested changes May 29, 2026

View reviewed changes

Amrita42 added 4 commits June 4, 2026 12:55

tech feedback 2.1

128c900

tech feedback 2.2

58f9092

jana-feedback

02812d9

jana-feedback-2

1f70ab9

lvicoun requested changes Jun 10, 2026

View reviewed changes

Amrita42 added 2 commits June 11, 2026 20:27

jana-feedback

f7be4c9

self review

4fb553b

Amrita42 requested a review from dariavladykina June 11, 2026 15:06

dariavladykina reviewed Jun 12, 2026

View reviewed changes

-               Configure &kdump; in case your system crashes. Its primary purpose is to capture a snapshot of the system's memory (a vmcore file) at the exact moment a kernel crashes (kernel panic).
+               &kdump; is a Linux kernel crash dumping mechanism that captures
+               a snapshot of system memory (a vmcore file) when the Linux kernel
+               encounters a fatal error (kernel panic).

	<title>About &kdump;</title>
	<title>What is &kdump; and how does it work?</title>

	system crash occurs. A vmcore file is a snapshot of your computer's system memory (RAM) taken at the exact moment the Linux kernel crashed.
	a system crash occurs. A vmcore file is a snapshot of your computer's system memory (RAM) taken at the exact moment the Linux kernel crashed.

	<title>Why is &kdump; important?</title>
	<title>Why is &kdump; critical for system crash debugging?</title>

	Out of Memory (OOM) killer, this is the likely cause. In case, you don't see such messages, trying with increased crash kernel reservation is a good
	Out of Memory (OOM) killer, this is the likely cause. If you don't see such messages, trying with increased crash kernel reservation is a good

		<literal>KDUMP_VERBOSE</literal> to 11 turns on debugging output during all stages of the &kdump;
		process, it:</para>

		<command>mkdumprd -fd</command>. You can also unpack and inspect the generated initramfs image with <command>lsinitrd --unpack /var/lib/kdump/initrd
		</command> command. </para></listitem>

	<title>Introduction to &kdump;</title>
	<title>Kdump Configuration and Troubleshooting Guide</title>

Conversation

Amrita42 commented Jan 12, 2026

PR creator: Description

PR creator: Are there any relevant issues/feature requests?

PR reviewer: Checklist for editorial review

Uh oh!

Amrita42 commented Feb 2, 2026

Uh oh!

Amrita42 commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Amrita42 commented May 27, 2026

Uh oh!

lvicoun left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Amrita42 commented Jun 10, 2026

Uh oh!

lvicoun left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Amrita42 commented Jun 11, 2026

Uh oh!

dariavladykina left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dariavladykina left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Amrita42 commented May 15, 2026 •

edited

Loading