Bug 1219181

Summary:	[doc] Issue in "Monitoring fencing devices"
Product:	[openSUSE] PUBLIC SUSE Linux Enterprise High Availability Extension 15 SP5	Reporter:	Peter Varkoly <varkoly>
Component:	Documentation	Assignee:	Tahlia Richardson <tahlia.richardson>
Status:	RESOLVED FIXED	QA Contact:	Tanja Roth <taroth>
Severity:	Normal
Priority:	P5 - None	CC:	lars.pinne, varkoly
Version:	unspecified
Target Milestone:	---
Hardware:	Other
OS:	Other
Whiteboard:	https://jira.suse.com/browse/DOCTEAM-1251
Found By:	---	Services Priority:
Business Priority:		Blocker:	---
Marketing QA Status:	---	IT Deployment:	---

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.