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

NAME

7       fence_sanbox2 - Fence agent for QLogic SANBox2 FC switches
8

DESCRIPTION

10       fence_sanbox2  is  an  I/O  Fencing agent which can be used with QLogic
11       SANBox2 FC switches.  It logs into a SANBox2 switch via telnet and dis‐
12       ables  a  specified  port.  Disabling  the port which a machine is con‐
13       nected to effectively fences that machine. Lengthy  telnet  connections
14       to  the switch should be avoided while a GFS cluster is running because
15       the connection will block any necessary fencing actions.
16
17       fence_sanbox2 accepts options on the  command  line  as  well  as  from
18       stdin.  Fenced  sends parameters through stdin when it execs the agent.
19       fence_sanbox2 can be run by itself with command line options.  This  is
20       useful for testing and for turning outlets on or off from scripts.
21
22       Vendor URL: http://www.qlogic.com
23

PARAMETERS

25
26
27       -o, --action=<action>
28              Fencing Action (Default Value: disable)
29
30       -a, --ip=<ip>
31              IP Address or Hostname This parameter is always required.
32
33       -l, --username=<name>
34              Login Name This parameter is always required.
35
36       -p, --password=<password>
37              Login password or passphrase
38
39       -S, --password-script=<script>
40              Script to retrieve password
41
42       -c, --command-prompt=<prompt>
43              Force command prompt (Default Value: [' #> '])
44
45       -n, --plug=<id>
46              Physical  plug  number or name of virtual machine This parameter
47              is always required.
48
49       -u, --ipport=<port>
50              TCP port to use for connection with device
51
52       -v, --verbose
53              Verbose mode
54
55       -D, --debug-file=<debugfile>
56              Write debug information to given file
57
58       -V, --version
59              Display version information and exit
60
61       -h, --help
62              Display help and exit
63
64       -C, --separator=<char>
65              Separator for CSV created by operation list (Default  Value:  ,)
66
67
68       --power-timeout
69              Test  X  seconds  for status change after ON/OFF (Default Value:
70              20)
71
72       --shell-timeout
73              Wait X seconds for cmd prompt  after  issuing  command  (Default
74              Value: 3)
75
76       --login-timeout
77              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
78
79
80       --power-wait
81              Wait X seconds after issuing ON/OFF (Default Value: 0)
82
83       --delay
84              Wait X seconds before fencing  is  started  (Default  Value:  0)
85
86
87       --retry-on
88              Count of attempts to retry power on (Default Value: 1)
89
90

ACTIONS

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

STDIN PARAMETERS

115
116
117       io_fencing
118              Fencing Action (Default Value: disable)
119
120       ipaddr IP Address or Hostname This parameter is always required.
121
122       login  Login Name This parameter is always required.
123
124       passwd Login password or passphrase
125
126       passwd_script
127              Script to retrieve password
128
129       cmd_prompt
130              Force command prompt (Default Value: [' #> '])
131
132       port   Physical plug number or name of virtual machine  This  parameter
133              is always required.
134
135       ipport TCP port to use for connection with device
136
137       verbose
138              Verbose mode
139
140       debug  Write debug information to given file
141
142       version
143              Display version information and exit
144
145       help   Display help and exit
146
147       separator
148              Separator  for  CSV created by operation list (Default Value: ,)
149
150
151       power_timeout
152              Test X seconds for status change after  ON/OFF  (Default  Value:
153              20)
154
155       shell_timeout
156              Wait  X  seconds  for  cmd prompt after issuing command (Default
157              Value: 3)
158
159       login_timeout
160              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
161
162
163       power_wait
164              Wait X seconds after issuing ON/OFF (Default Value: 0)
165
166       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
167
168
169       retry_on
170              Count of attempts to retry power on (Default Value: 1)
171
172
173
174fence_sanbox2 (Fence Agent)       2009-10-20                    FENCE_AGENT(8)