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

NAME

7       fence_rsb - I/O Fencing agent for Fujitsu-Siemens RSB
8

DESCRIPTION

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

PARAMETERS

24
25
26       -o, --action=[action]
27              Fencing Action (Default Value: reboot)
28
29       -c, --command-prompt=[prompt]
30              Force Python regex  for  command  prompt  (Default  Value:  ['to
31              quit:'])
32
33       -k, --identity-file=[filename]
34              Identity file for ssh
35
36       -4, --inet4-only
37              Forces agent to use IPv4 addresses only
38
39       -6, --inet6-only
40              Forces agent to use IPv6 addresses only
41
42       -a, --ip=[ip]
43              IP Address or Hostname This parameter is always required.
44
45       -u, --ipport=[port]
46              TCP/UDP  port  to use for connection with device (Default Value:
47              3172)
48
49       -l, --username=[name]
50              Login Name This parameter is always required.
51
52       -p, --password=[password]
53              Login password or passphrase
54
55       -S, --password-script=[script]
56              Script to retrieve password
57
58       -x, --ssh
59              SSH connection
60
61       --ssh-options=[options]
62              SSH options to use
63
64       -n TCP port to use (deprecated, use -u)
65              TCP port to use for connection with device (default is 3172  for
66              telnet)
67
68       -v, --verbose
69              Verbose mode
70
71       -D, --debug-file=[debugfile]
72              Write debug information to given file
73
74       -V, --version
75              Display version information and exit
76
77       -h, --help
78              Display help and exit
79
80       --delay=[seconds]
81              Wait  X  seconds  before  fencing  is started (Default Value: 0)
82
83
84       --login-timeout=[seconds]
85              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
86
87
88       --power-timeout=[seconds]
89              Test  X  seconds  for status change after ON/OFF (Default Value:
90              20)
91
92       --power-wait=[seconds]
93              Wait X seconds after issuing ON/OFF (Default Value: 0)
94
95       --shell-timeout=[seconds]
96              Wait X seconds for cmd prompt  after  issuing  command  (Default
97              Value: 3)
98
99       --retry-on=[attempts]
100              Count of attempts to retry power on (Default Value: 1)
101
102       --ssh-path=[path]
103              Path to ssh binary (Default Value: /usr/bin/ssh)
104
105       --telnet-path=[path]
106              Path to telnet binary (Default Value: /usr/bin/telnet)
107
108

ACTIONS

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

STDIN PARAMETERS

136
137
138       action Fencing Action (Default Value: reboot)
139
140       cmd_prompt
141              Force Python regex  for  command  prompt  (Default  Value:  ['to
142              quit:'])
143
144       identity_file
145              Identity file for ssh
146
147       inet4_only
148              Forces agent to use IPv4 addresses only
149
150       inet6_only
151              Forces agent to use IPv6 addresses only
152
153       ipaddr IP Address or Hostname This parameter is always required.
154
155       ipport TCP/UDP  port  to use for connection with device (Default Value:
156              3172)
157
158       login  Login Name This parameter is always required.
159
160       passwd Login password or passphrase
161
162       passwd_script
163              Script to retrieve password
164
165       secure SSH connection
166
167       ssh_options
168              SSH options to use
169
170       telnet_port
171              TCP port to use for connection with device (default is 3172  for
172              telnet)
173
174       verbose
175              Verbose mode
176
177       debug  Write debug information to given file
178
179       version
180              Display version information and exit
181
182       help   Display help and exit
183
184       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
185
186
187       login_timeout
188              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
189
190
191       power_timeout
192              Test  X  seconds  for status change after ON/OFF (Default Value:
193              20)
194
195       power_wait
196              Wait X seconds after issuing ON/OFF (Default Value: 0)
197
198       shell_timeout
199              Wait X seconds for cmd prompt  after  issuing  command  (Default
200              Value: 3)
201
202       retry_on
203              Count of attempts to retry power on (Default Value: 1)
204
205       ssh_path
206              Path to ssh binary (Default Value: /usr/bin/ssh)
207
208       telnet_path
209              Path to telnet binary (Default Value: /usr/bin/telnet)
210
211
212
213fence_rsb (Fence Agent)           2009-10-20                    FENCE_AGENT(8)