Bug 1219181 - [doc] Issue in "Monitoring fencing devices"
Summary: [doc] Issue in "Monitoring fencing devices"
Status: RESOLVED FIXED
Alias: None
Product: PUBLIC SUSE Linux Enterprise High Availability Extension 15 SP5
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-...
Keywords:
Depends on:
Blocks:
 
Reported: 2024-01-25 12:32 UTC by Peter Varkoly
Modified: 2024-07-18 00:11 UTC (History)
2 users (show)

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


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Peter Varkoly 2024-01-25 12:32:32 UTC
Monitoring fencing devices:

https://documentation.suse.com/sle-ha/15-SP5/html/SLE-HA-all/cha-ha-fencing.html#sec-ha-fencing-monitor

As discussed monitoring of fence-agent does not make sence. Please adapt documentation in this regard. Do not forget this must be changed for all SLES versions. Also SLE12-SP5 has this text:
https://documentation.suse.com/sle-ha/12-SP5/html/SLE-HA-all/cha-ha-fencing.html#sec-ha-fencing-monitor
Comment 1 Tahlia Richardson 2024-01-29 03:59:44 UTC
Thanks Peter, I've added this to our queue. 

Could you please elaborate on what was discussed? I agree that this section is a bit odd and needs an update, but more context would be helpful.
Comment 5 Tahlia Richardson 2024-07-12 06:03:36 UTC
Hi Lars, 

Thanks for the clarifications. I've also got another question about a contradiction in this section. In one paragraph, it says:

---
Monitor STONITH resources regularly, yet sparingly. For most devices a monitoring interval of at least 1800 seconds (30 minutes) should suffice. 
---

But a few paragraphs later, it says: 

---
Checking the status of fencing devices once every few hours should be enough.
---

Which of these intervals should we recommend?
Comment 6 Lars Pinne 2024-07-15 09:12:40 UTC
(In reply to Tahlia Richardson from comment #5)
> Hi Lars, 
> 
> Thanks for the clarifications. I've also got another question about a
> contradiction in this section. In one paragraph, it says:
> 
> ---
> Monitor STONITH resources regularly, yet sparingly. For most devices a
> monitoring interval of at least 1800 seconds (30 minutes) should suffice. 
> ---
> 
> But a few paragraphs later, it says: 
> 
> ---
> Checking the status of fencing devices once every few hours should be enough.
> ---
> 
> Which of these intervals should we recommend?

Hi Tahlia,

in fact the monitoring interval depends on the device and the infrastructure. For sbd rescources the monitor is pointless at all.

So you may change the sentence to:

"For most devices a monitoring interval of 1800 seconds (30 minutes) or more should suffice. The exact value depends on device and infrastructure. Stonith SBD resources do not need a monitor at all."

Regards,
Lars
Comment 7 Tahlia Richardson 2024-07-16 04:42:11 UTC
(In reply to Lars Pinne from comment #6)
> (In reply to Tahlia Richardson from comment #5)
> > Hi Lars, 
> > 
> > Thanks for the clarifications. I've also got another question about a
> > contradiction in this section. In one paragraph, it says:
> > 
> > ---
> > Monitor STONITH resources regularly, yet sparingly. For most devices a
> > monitoring interval of at least 1800 seconds (30 minutes) should suffice. 
> > ---
> > 
> > But a few paragraphs later, it says: 
> > 
> > ---
> > Checking the status of fencing devices once every few hours should be enough.
> > ---
> > 
> > Which of these intervals should we recommend?
> 
> Hi Tahlia,
> 
> in fact the monitoring interval depends on the device and the
> infrastructure. For sbd rescources the monitor is pointless at all.
> 
> So you may change the sentence to:
> 
> "For most devices a monitoring interval of 1800 seconds (30 minutes) or more
> should suffice. The exact value depends on device and infrastructure.
> Stonith SBD resources do not need a monitor at all."
> 
> Regards,
> Lars

Thanks Lars, I've updated the text in https://github.com/SUSE/doc-sleha/pull/400
Let me know if you're happy with this :)
Comment 8 Lars Pinne 2024-07-16 06:58:07 UTC
(In reply to Tahlia Richardson from comment #7)
> (In reply to Lars Pinne from comment #6)
> > (In reply to Tahlia Richardson from comment #5)
> > > Hi Lars, 
> > > 
> > > Thanks for the clarifications. I've also got another question about a
> > > contradiction in this section. In one paragraph, it says:
> > > 
> > > ---
> > > Monitor STONITH resources regularly, yet sparingly. For most devices a
> > > monitoring interval of at least 1800 seconds (30 minutes) should suffice. 
> > > ---
> > > 
> > > But a few paragraphs later, it says: 
> > > 
> > > ---
> > > Checking the status of fencing devices once every few hours should be enough.
> > > ---
> > > 
> > > Which of these intervals should we recommend?
> > 
> > Hi Tahlia,
> > 
> > in fact the monitoring interval depends on the device and the
> > infrastructure. For sbd rescources the monitor is pointless at all.
> > 
> > So you may change the sentence to:
> > 
> > "For most devices a monitoring interval of 1800 seconds (30 minutes) or more
> > should suffice. The exact value depends on device and infrastructure.
> > Stonith SBD resources do not need a monitor at all."
> > 
> > Regards,
> > Lars
> 
> Thanks Lars, I've updated the text in
> https://github.com/SUSE/doc-sleha/pull/400
> Let me know if you're happy with this :)

Hi Tahlia,
the PR looks good to me.
Thanks,
Lars
Comment 9 Tahlia Richardson 2024-07-18 00:11:05 UTC
Thanks Lars! This is now complete and backported, and will be published with the next weekly docs update.