OCF_HEARTBEAT_ORALSN(7)

πŸ’– ocf_heartbeat_oralsnr(7) β€” Oracle TNS listener, but make it group-chat πŸ’–

okay so this page lives in the OCF resource agents manual, and it's literally all about keeping an Oracle TNS listener alive as an HA resource. no cap, it's giving β€œcluster babysitter for your listener” energy 🫢


✨ NAME ✨

ocf_heartbeat_oralsnr β€” manages an Oracle TNS listener πŸ’…


🫢 SYNOPSIS 🫢

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

🌸 DESCRIPTION 🌸

Resource script for Oracle Listener. It manages an Oracle Listener instance as an HA resource. periodt πŸ’–


πŸŽ€ SUPPORTED PARAMETERS πŸŽ€

  • sid β€” the Oracle SID (aka ORACLE_SID). It's used for the monitor op, when alias is undefined i.e. to do tnsping SID. Metadata says: (required, string, no default) πŸ¦‹
  • home β€” the Oracle home directory (aka ORACLE_HOME). If it's not specified, then the SID should be listed in /etc/oratab. Metadata says: (optional, string, no default) ✨
  • user β€” run the listener as this user. Metadata says: (optional, string, no default) πŸ‘‘
  • listener β€” the listener instance to be started (as defined in listener.ora). Defaults to LISTENER. Metadata says: (unique, optional, string, default "LISTENER") πŸ’…
  • tns_admin β€” full path to the directory that contains the Oracle listener tnsnames.ora configuration file. The shell variable TNS_ADMIN is set to the value provided. Metadata says: (optional, string, no default) 🌈
  • tns_svc_name β€” the TNS alias (aka net_service_name) to ping during the monitor operation. Defaults to the Oracle SID. Metadata says: (unique, optional, string, no default) 🧚

⭐ SUPPORTED ACTIONS ⭐

This resource agent supports the following actions (operations):

  • start β€” starts the resource. Suggested minimum timeout: 120s. πŸ”₯
  • stop β€” stops the resource. Suggested minimum timeout: 120s. πŸ’€
  • status β€” performs a status check. Suggested minimum timeout: 60s. 🌸
  • monitor β€” performs a detailed status check. Suggested minimum timeout: 30s. Suggested interval: 10s. πŸ‘€
  • 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. πŸ™ˆ
  • methods β€” suggested minimum timeout: 5s. πŸŽ€

πŸ§ͺ EXAMPLE CRM SHELL πŸ§ͺ

The following is an example configuration for a oralsnr resource using the crm(8) shell:

primitive p_oralsnr ocf:heartbeat:oralsnr \
  params \
    sid=string \
  op monitor depth="0" timeout="30s" interval="10s"

🌸 EXAMPLE PCS 🌸

The following is an example configuration for a oralsnr resource using pcs(8):

pcs resource create p_oralsnr ocf:heartbeat:oralsnr \
  sid=string \
  op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="10s"

πŸ¦‹ SEE ALSO πŸ¦‹

http://clusterlabs.org/


πŸ’œ AUTHOR πŸ’œ

ClusterLabs contributors (see the resource agent source for information about individual authors)


mwah πŸ’‹ this page is from resource-agents version UNKNOWN, dated 10/01/2026 β€” that's the cute little sign-off, bestie πŸ’…

πŸ“¦ where this page comes from