ocf_heartbeat_named(7)

1OCF_HEARTBEAT_NAMED(7)        OCF resource agents       OCF_HEARTBEAT_NAMED(7)
2
3
4

NAME

6       ocf_heartbeat_named - Manages a named server
7

SYNOPSIS

9       named [start | stop | status | monitor | meta-data | validate-all]
10

DESCRIPTION

12       Resource script for named (Bind) server. It manages named as an HA
13       resource.
14

SUPPORTED PARAMETERS

16       named
17           Path to the named command.
18
19           (optional, string, default "/usr/sbin/named")
20
21       rndc
22           Path to the rndc command.
23
24           (optional, string, default "/usr/sbin/rndc")
25
26       host
27           Path to the host command.
28
29           (optional, string, default "/usr/bin/host")
30
31       named_user
32           User that should own named process.
33
34           (optional, string, default "named")
35
36       named_config
37           Configuration file for named.
38
39           (unique, optional, string, no default)
40
41       named_pidfile
42           PIDFILE file for named.
43
44           (unique, optional, string, default "/var/run/named/named.pid")
45
46       named_rootdir
47           Directory that named should use for chroot if any.
48
49           (unique, optional, string, no default)
50
51       named_options
52           Options for named process if any.
53
54           (optional, string, no default)
55
56       named_keytab_file
57           named service keytab file (for GSS-TSIG).
58
59           (optional, string, no default)
60
61       rndc_options
62           Options for rndc process if any.
63
64           (optional, string, no default)
65
66       host_options
67           Options for host process if any.
68
69           (optional, string, no default)
70
71       monitor_request
72           Request that shall be sent to named for monitoring. Usually an A
73           record in DNS.
74
75           (optional, string, default "localhost")
76
77       monitor_response
78           Expected response from named server.
79
80           (optional, string, default "127.0.0.1")
81
82       monitor_ip
83           IP Address where named listens.
84
85           (optional, string, default "127.0.0.1")
86

SUPPORTED ACTIONS

88       This resource agent supports the following actions (operations):
89
90       start
91           Starts the resource. Suggested minimum timeout: 60s.
92
93       stop
94           Stops the resource. Suggested minimum timeout: 60s.
95
96       reload
97           Suggested minimum timeout: 60s.
98
99       status
100           Performs a status check. Suggested minimum timeout: 10s.
101
102       monitor
103           Performs a detailed status check. Suggested minimum timeout: 30s.
104           Suggested interval: 30s.
105
106       meta-data
107           Retrieves resource agent metadata (internal use only). Suggested
108           minimum timeout: 5s.
109
110       validate-all
111           Performs a validation of the resource configuration. Suggested
112           minimum timeout: 5s.
113
114       methods
115           Suggested minimum timeout: 5s.
116

EXAMPLE CRM SHELL

118       The following is an example configuration for a named resource using
119       the crm(8) shell:
120
121           primitive p_named ocf:heartbeat:named \
122             op monitor depth="0" timeout="30s" interval="30s"
123

EXAMPLE PCS

125       The following is an example configuration for a named resource using
126       pcs(8)
127
128           pcs resource create p_named ocf:heartbeat:named \
129             op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="30s"
130

AUTHOR

135       ClusterLabs contributors (see the resource agent source for information
136       about individual authors)
137
138
139
140resource-agents UNKNOWN           01/25/2023            OCF_HEARTBEAT_NAMED(7)