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

NAME

7       fence_rsa - Fence agent for IBM RSA
8

DESCRIPTION

10       fence_rsa is an I/O Fencing agent which can be used with the IBM RSA II
11       management interface. It logs into an RSA  II  device  via  telnet  and
12       reboots  the  associated machine. Lengthy telnet connections to the RSA
13       II device should be avoided while a GFS cluster is running because  the
14       connection will block any necessary fencing actions.
15
16       fence_rsa  accepts  options  on the command line as well as from stdin.
17       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
18       fence_rsa 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.ibm.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 This parameter is always required.
31
32       -l, --username=<name>
33              Login Name This parameter is always required.
34
35       -p, --password=<password>
36              Login password or passphrase
37
38       -S, --password-script=<script>
39              Script to retrieve password
40
41       -c, --command-prompt=<prompt>
42              Force command prompt (Default Value: >)
43
44       -x, --ssh
45              SSH connection
46
47       -k, --identity-file=<filename>
48              Identity file for ssh
49
50       -u, --ipport=<port>
51              TCP port to use for connection with device
52
53       -v, --verbose
54              Verbose mode
55
56       -D, --debug-file=<debugfile>
57              Write debug information to given file
58
59       -V, --version
60              Display version information and exit
61
62       -h, --help
63              Display help and exit
64
65       --power-timeout
66              Test X seconds for status change after  ON/OFF  (Default  Value:
67              20)
68
69       --shell-timeout
70              Wait  X  seconds  for  cmd prompt after issuing command (Default
71              Value: 3)
72
73       --login-timeout
74              Wait X seconds for cmd prompt after login  (Default  Value:  10)
75
76
77       --power-wait
78              Wait X seconds after issuing ON/OFF (Default Value: 0)
79
80       --delay
81              Wait  X  seconds  before  fencing  is started (Default Value: 0)
82
83
84       --retry-on
85              Count of attempts to retry power on (Default Value: 1)
86
87

ACTIONS

89
90
91       on     Power on machine.
92
93       off    Power off machine.
94
95       reboot Reboot machine.
96
97       status This returns the status of the plug/virtual machine.
98
99       list   List available plugs with aliases/virtual machines if  there  is
100              support for more then one device. Returns N/A otherwise.
101
102       monitor
103              Check if fencing device is running. List available plugs/virtual
104              machines or get status of machine (if it does not support more).
105
106
107       metadata
108               The operational behavior of this is not known.
109
110

STDIN PARAMETERS

112
113
114       action Fencing Action (Default Value: reboot)
115
116       ipaddr IP Address or Hostname This parameter is always required.
117
118       login  Login Name This parameter is always required.
119
120       passwd Login password or passphrase
121
122       passwd_script
123              Script to retrieve password
124
125       cmd_prompt
126              Force command prompt (Default Value: >)
127
128       secure SSH connection
129
130       identity_file
131              Identity file for ssh
132
133       ipport TCP port to use for connection with device
134
135       verbose
136              Verbose mode
137
138       debug  Write debug information to given file
139
140       version
141              Display version information and exit
142
143       help   Display help and exit
144
145       power_timeout
146              Test  X  seconds  for status change after ON/OFF (Default Value:
147              20)
148
149       shell_timeout
150              Wait X seconds for cmd prompt  after  issuing  command  (Default
151              Value: 3)
152
153       login_timeout
154              Wait  X  seconds  for cmd prompt after login (Default Value: 10)
155
156
157       power_wait
158              Wait X seconds after issuing ON/OFF (Default Value: 0)
159
160       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
161
162
163       retry_on
164              Count of attempts to retry power on (Default Value: 1)
165
166
167
168fence_rsa (Fence Agent)           2009-10-20                    FENCE_AGENT(8)