1
2FENCE_AGENT(8)              System Manager's Manual             FENCE_AGENT(8)
3
4
5

NAME

7       fence_raritan - I/O Fencing agent for Raritan Dominion PX
8

DESCRIPTION

10       fence_raritan  is an I/O Fencing agent which can be used with the Rari‐
11       tan DPXS12-20 Power Distribution Unit. It logs into device  via  telnet
12       and  reboots  a  specified outlet. Lengthy telnet connections should be
13       avoided while a GFS cluster is  running  because  the  connection  will
14       block any necessary fencing actions.
15
16       fence_raritan  accepts  options  on  the  command  line as well as from
17       stdin. Fenced sends parameters through stdin when it execs  the  agent.
18       fence_raritan  can be run by itself with command line options.  This is
19       useful for testing and for turning outlets on or off from scripts.
20
21       Vendor URL: http://www.raritan.com/
22

PARAMETERS

24
25
26       -o, --action=[action]
27              Fencing action (Default Value: reboot)
28
29       -a, --ip=[ip]
30              IP address or hostname of fencing device This parameter  is  al‐
31              ways required.
32
33       -u, --ipport=[port]
34              TCP/UDP  port  to use for connection with device (Default Value:
35              23)
36
37       -p, --password=[password]
38              Login password or passphrase
39
40       -S, --password-script=[script]
41              Script to run to retrieve password
42
43       -n, --plug=[id]
44              Physical plug number on device, UUID or  identification  of  ma‐
45              chine This parameter is always required.
46
47       -l, --username=[name]
48              Login name This parameter is always required.
49
50       -q, --quiet
51              Disable logging to stderr. Does not affect --verbose or --debug-
52              file or logging to syslog.
53
54       -v, --verbose
55              Verbose mode. Multiple -v flags can be stacked  on  the  command
56              line (e.g., -vvv) to increase verbosity.
57
58       --verbose-level
59              Level  of  debugging detail in output. Defaults to the number of
60              --verbose flags specified on the command line, or to 1  if  ver‐
61              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
62
63
64       -D, --debug-file=[debugfile]
65              Write debug information to given file
66
67       -V, --version
68              Display version information and exit
69
70       -h, --help
71              Display help and exit
72
73       --plug-separator=[char]
74              Separator for plug parameter when specifying more  than  1  plug
75              (Default Value: ,)
76
77       -C, --separator=[char]
78              Separator for CSV created by 'list' operation (Default Value: ,)
79
80
81       --delay=[seconds]
82              Wait X seconds before fencing  is  started  (Default  Value:  0)
83
84
85       --disable-timeout=[true/false]
86              Disable  timeout (true/false) (default: true when run from Pace‐
87              maker 2.0+)
88
89       --login-timeout=[seconds]
90              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
91
92
93       --power-timeout=[seconds]
94              Test  X  seconds  for status change after ON/OFF (Default Value:
95              20)
96
97       --power-wait=[seconds]
98              Wait X seconds after issuing ON/OFF (Default Value: 0)
99
100       --shell-timeout=[seconds]
101              Wait X seconds for cmd prompt  after  issuing  command  (Default
102              Value: 3)
103
104       --stonith-status-sleep=[seconds]
105              Sleep  X  seconds  between  status calls during a STONITH action
106              (Default Value: 1)
107
108       --retry-on=[attempts]
109              Count of attempts to retry power on (Default Value: 1)
110
111       --telnet-path=[path]
112              Path to telnet binary (Default Value: /usr/bin/telnet)
113
114

ACTIONS

116
117
118       on     Power on machine.
119
120       off    Power off machine.
121
122       reboot Reboot machine.
123
124       status This returns the status of the plug/virtual machine.
125
126       list   List available plugs with aliases/virtual machines if  there  is
127              support for more then one device. Returns N/A otherwise.
128
129       list-status
130              List  available  plugs  with  aliases/virtual machines and their
131              power state if it can be obtained without  additional  commands.
132
133
134       monitor
135              Check the health of fence device
136
137       metadata
138              Display the XML metadata describing this resource.
139
140       manpage
141               The operational behavior of this is not known.
142
143       validate-all
144              Validate if all required parameters are entered.
145
146

STDIN PARAMETERS

148
149
150       action Fencing action (Default Value: reboot)
151
152       ip     IP  address  or hostname of fencing device This parameter is al‐
153              ways required. Obsoletes: ipaddr
154
155       ipport TCP/UDP port to use for connection with device  (Default  Value:
156              23)
157
158       password
159              Login password or passphrase Obsoletes: passwd
160
161       password_script
162              Script  to  run  to  retrieve  password Obsoletes: passwd_script
163
164
165       plug   Physical plug number on device, UUID or  identification  of  ma‐
166              chine  This  parameter is always required. Obsoletes: port
167
168
169       username
170              Login name This parameter is always required.  Obsoletes:  login
171
172
173       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
174              file or logging to syslog.
175
176       verbose
177              Verbose mode. Multiple -v flags can be stacked  on  the  command
178              line (e.g., -vvv) to increase verbosity.
179
180       verbose_level
181              Level  of  debugging detail in output. Defaults to the number of
182              --verbose flags specified on the command line, or to 1  if  ver‐
183              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
184
185
186       debug_file
187              Write debug information to given file Obsoletes: debug
188
189       version
190              Display version information and exit
191
192       help   Display help and exit
193
194       plug_separator
195              Separator for plug parameter when specifying more  than  1  plug
196              (Default Value: ,)
197
198       separator
199              Separator for CSV created by 'list' operation (Default Value: ,)
200
201
202       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
203
204
205       disable_timeout
206              Disable  timeout (true/false) (default: true when run from Pace‐
207              maker 2.0+)
208
209       login_timeout
210              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
211
212
213       power_timeout
214              Test  X  seconds  for status change after ON/OFF (Default Value:
215              20)
216
217       power_wait
218              Wait X seconds after issuing ON/OFF (Default Value: 0)
219
220       shell_timeout
221              Wait X seconds for cmd prompt  after  issuing  command  (Default
222              Value: 3)
223
224       stonith_status_sleep
225              Sleep  X  seconds  between  status calls during a STONITH action
226              (Default Value: 1)
227
228       retry_on
229              Count of attempts to retry power on (Default Value: 1)
230
231       telnet_path
232              Path to telnet binary (Default Value: /usr/bin/telnet)
233
234
235
236fence_raritan (Fence Agent)       2009-10-20                    FENCE_AGENT(8)