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       monitor_request
67           Request that shall be sent to named for monitoring. Usually an A
68           record in DNS.
69
70           (optional, string, default "localhost")
71
72       monitor_response
73           Expected response from named server.
74
75           (optional, string, default "127.0.0.1")
76
77       monitor_ip
78           IP Address where named listens.
79
80           (optional, string, default "127.0.0.1")
81

SUPPORTED ACTIONS

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

EXAMPLE CRM SHELL

113       The following is an example configuration for a named resource using
114       the crm(8) shell:
115
116           primitive p_named ocf:heartbeat:named \
117             op monitor depth="0" timeout="30s" interval="30s"
118

EXAMPLE PCS

120       The following is an example configuration for a named resource using
121       pcs(8)
122
123           pcs resource create p_named ocf:heartbeat:named \
124             op monitor depth="0" timeout="30s" interval="30s"
125

AUTHOR

130       ClusterLabs contributors (see the resource agent source for information
131       about individual authors)
132
133
134
135resource-agents UNKNOWN           03/15/2019            OCF_HEARTBEAT_NAMED(7)