Bug 1211587 - [doc] Issue in "DRBD" - missing cluster/Pacemaker configuration
Summary: [doc] Issue in "DRBD" - missing cluster/Pacemaker configuration
Status: RESOLVED FIXED
Alias: None
Product: PUBLIC SUSE Linux Enterprise High Availability Extension 15 SP4
Classification: openSUSE
Component: Documentation (show other bugs)
Version: unspecified
Hardware: Other Other
: P5 - None : Normal
Target Milestone: ---
Assignee: Tahlia Richardson
QA Contact: Tanja Roth
URL:
Whiteboard: https://jira.suse.com/browse/DOCTEAM-998
Keywords:
Depends on:
Blocks:
 
Reported: 2023-05-22 10:00 UTC by Jiri Belka
Modified: 2023-10-24 04:05 UTC (History)
4 users (show)

See Also:
Found By: ---
Services Priority:
Business Priority:
Blocker: ---
Marketing QA Status: ---
IT Deployment: ---

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Jiri Belka 2023-05-22 10:00:42 UTC 
DRBD:

https://documentation.suse.com/sle-ha/15-SP4/html/SLE-HA-all/cha-ha-drbd.html#

Usually customers run drbd under pacemaker cluster - this "howto" does not cover
it, neither it covers "outside the cluster" scenario.

Thus the documentation is "incomplete".

See https://documentation.suse.com/sle-ha/15-SP1/single-html/SLE-HA-nfs-quick/index.html#sec-ha-quick-nfs-resources for content...
Comment 1 Tahlia Richardson 2023-05-23 03:53:03 UTC 
Thanks Jiri, that's a good point. The DRBD steps in the HA NFS guide are much easier to follow (and include adding resources to the cluster, as you noted), while the DRBD chapter in the Admin Guide tries to include as many options as possible but is harder to read as a result.

I also recently opened an issue to improve the structure of '22.3 Setting up DRBD service', so I can probably work on that in parallel with this one and improve the whole chapter overall.
Comment 2 Tahlia Richardson 2023-10-20 06:29:36 UTC 
Hi Jiri, here's the PR for this: https://github.com/SUSE/doc-sleha/pull/353

Yan, could you please look too? It should be fine as the procedure comes from the recently improved HA NFS guide, but just in case. 


I do still intend to improve the structure of '22.3 Setting up DRBD service', but that will take a bit longer so I didn't want to delay this one waiting for it.
Comment 3 Yan Gao 2023-10-20 10:16:48 UTC 
It makes sense and looks good to me, Tahlia.

What do you think, Roger?
Comment 4 Roger Zhou 2023-10-23 01:21:19 UTC 
All look good to me! Thank you Jiri, Tahlia, and Yan for the join feedback from different angles!
Comment 5 Tahlia Richardson 2023-10-24 04:05:44 UTC 
Thanks everyone! This is now complete and has been backported. It will be published with the next weekly docs update.