OCF_HEARTBEAT_WINPOP(7)

✨ ocf_heartbeat_WinPopup πŸ’Œ

okay bestie, so this is OCF_HEARTBEAT_WINPOP(7) from the OCF resource agents collection β€” yes the manpage name is giving shouty uppercase but it's literally just the WinPopup resource agent and she's here to slide into your sysadmin's DMs 🫢


🌸 NAME 🌸

ocf_heartbeat_WinPopup β€” she sends an SMB notification message to selected hosts, no cap πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

WinPopup [start | stop | status | monitor | meta-data | validate-all]

that's it, that's the whole vibe check ✨


πŸ’– DESCRIPTION πŸ’–

So this is the resource script for WinPopup, and her whole thing is: she sends WinPopups messages to a sysadmin's workstation whenever a takeover occurs. like, the cluster does a little switcheroo and she immediately goes "hey bestie, something happened πŸ‘€" straight to the workstation. iconic behaviour honestly, that's main character energy πŸ”₯


πŸŽ€ SUPPORTED PARAMETERS πŸŽ€

  • hostfile β€” the file containing the hosts to send WinPopup messages to, fr fr. She needs to know who's getting the message. It's required, it's a string, and the default is "hosts" 🌈

πŸ‘‘ SUPPORTED ACTIONS πŸ‘‘

This resource agent supports the following actions (operations), and yes each one has opinions about how long she's allowed to take:

  • start β€” starts the resource. Suggested minimum timeout: 30s. she's waking up, give her a sec 😭
  • stop β€” stops the resource. Suggested minimum timeout: 30s. same energy, she does not do rushed goodbyes πŸ’€
  • status β€” performs a status check. Suggested minimum timeout: 10s. Suggested interval: 10s.
  • monitor β€” performs a detailed status check. Suggested minimum timeout: 10s. Suggested interval: 10s. she's thorough, okay? 🧚
  • validate-all β€” performs a validation of the resource configuration. Suggested minimum timeout: 5s.
  • meta-data β€” retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s. not for you, bestie, that one's for the cluster πŸ™ˆ

πŸ’œ EXAMPLE CRM SHELL πŸ’œ

here's an example configuration for a WinPopup resource using the crm(8) shell β€” copy it exactly, don't get creative with the quotes, I'm begging:

primitive p_WinPopup ocf:heartbeat:WinPopup \
  params \
    hostfile="hosts" \
  op monitor depth="0" timeout="10s" interval="10s"

look at her. so neat. so demure 🌸


⭐ EXAMPLE PCS ⭐

and here's the same energy for pcs(8):

pcs resource create p_WinPopup ocf:heartbeat:WinPopup \
  hostfile="hosts" \
  op monitor OCF_CHECK_LEVEL="0" timeout="10s" interval="10s"

not me noticing the depth vs OCF_CHECK_LEVEL difference between the two examples πŸ‘€ that's just how the tools spell it, both are correct, don't @ me πŸ’…


🌈 SEE ALSO 🌈


🫢 AUTHOR 🫢

ClusterLabs contributors (see the resource agent source for information about individual authors) πŸ’–


⚠️ real talk: this whole page is from resource-agents version UNKNOWN, dated 04/08/2026, and it lives at section 7 of the manual β€” OCF_HEARTBEAT_WINPOP(7) πŸŽ€

and that's the whole page bestie, you ate it, periodt πŸ’…βœ¨πŸ¦‹

πŸ“¦ where this page comes from