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
31              always 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
45              machine 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       -C, --separator=[char]
74              Separator for CSV created by 'list' operation (Default Value: ,)
75
76
77       --delay=[seconds]
78              Wait  X  seconds  before  fencing  is started (Default Value: 0)
79
80
81       --disable-timeout=[true/false]
82              Disable timeout (true/false) (default: true when run from  Pace‐
83              maker 2.0+)
84
85       --login-timeout=[seconds]
86              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
87
88
89       --power-timeout=[seconds]
90              Test X seconds for status change after  ON/OFF  (Default  Value:
91              20)
92
93       --power-wait=[seconds]
94              Wait X seconds after issuing ON/OFF (Default Value: 0)
95
96       --shell-timeout=[seconds]
97              Wait  X  seconds  for  cmd prompt after issuing command (Default
98              Value: 3)
99
100       --retry-on=[attempts]
101              Count of attempts to retry power on (Default Value: 1)
102
103       --telnet-path=[path]
104              Path to telnet binary (Default Value: /usr/bin/telnet)
105
106

ACTIONS

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

STDIN PARAMETERS

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