fence_cisco_mds(8)

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

NAME

7       fence_cisco_mds - Fence agent for Cisco MDS
8

DESCRIPTION

10       fence_cisco_mds  is  an  I/O  Fencing  agent which can be used with any
11       Cisco MDS 9000 series with SNMP enabled device.
12
13       fence_cisco_mds accepts options on the command line  as  well  as  from
14       stdin.  Fenced  sends parameters through stdin when it execs the agent.
15       fence_cisco_mds can be run by itself with command line  options.   This
16       is useful for testing and for turning outlets on or off from scripts.
17
18       Vendor URL: http://www.cisco.com
19

PARAMETERS

21
22
23       -o, --action=<action>
24              Fencing Action (Default Value: reboot)
25
26       -a, --ip=<ip>
27              IP Address or Hostname This parameter is always required.
28
29       -l, --username=<name>
30              Login Name
31
32       -p, --password=<password>
33              Login password or passphrase
34
35       -S, --password-script=<script>
36              Script to retrieve password
37
38       -n, --plug=<id>
39              Physical  plug  number or name of virtual machine This parameter
40              is always required.
41
42       -d, --snmp-version=<ver>
43              Specifies SNMP version to use (1,2c,3)
44
45       -c, --community=<community>
46              Set the community string
47
48       -b, --snmp-auth-prot=<prot>
49              Set authentication protocol (MD5|SHA)
50
51       -E, --snmp-sec-level=<level>
52              Set security level (noAuthNoPriv|authNoPriv|authPriv)
53
54       -B, --snmp-priv-prot=<prot>
55              Set privacy protocol (DES|AES)
56
57       -P, --snmp-priv-passwd=<pass>
58              Set privacy protocol password
59
60       -R, --snmp-priv-passwd-script
61              Script to run to retrieve privacy password
62
63       -u, --udpport
64              UDP/TCP port to use for connection with device  (Default  Value:
65              161)
66
67       -4, --inet4-only
68              Forces agent to use IPv4 addresses only
69
70       -6, --inet6-only
71              Forces agent to use IPv6 addresses only
72
73       -v, --verbose
74              Verbose mode
75
76       -D, --debug-file=<debugfile>
77              Write debug information to given file
78
79       -V, --version
80              Display version information and exit
81
82       -h, --help
83              Display help and exit
84
85       -C, --separator=<char>
86              Separator  for  CSV created by operation list (Default Value: ,)
87
88
89       --power-timeout
90              Test X seconds for status change after  ON/OFF  (Default  Value:
91              20)
92
93       --shell-timeout
94              Wait  X  seconds  for  cmd prompt after issuing command (Default
95              Value: 3)
96
97       --login-timeout
98              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
99
100
101       --power-wait
102              Wait X seconds after issuing ON/OFF (Default Value: 0)
103
104       --delay
105              Wait  X  seconds  before  fencing  is started (Default Value: 0)
106
107
108       --retry-on
109              Count of attempts to retry power on (Default Value: 1)
110
111

ACTIONS

113
114
115       on     Power on machine.
116
117       off    Power off machine.
118
119       reboot Reboot machine.
120
121       status This returns the status of the plug/virtual machine.
122
123       list   List available plugs with aliases/virtual machines if  there  is
124              support for more then one device. Returns N/A otherwise.
125
126       monitor
127              Check if fencing device is running. List available plugs/virtual
128              machines or get status of machine (if it does not support more).
129
130
131       metadata
132               The operational behavior of this is not known.
133
134

STDIN PARAMETERS

136
137
138       action Fencing Action (Default Value: reboot)
139
140       ipaddr IP Address or Hostname This parameter is always required.
141
142       login  Login Name
143
144       passwd Login password or passphrase
145
146       passwd_script
147              Script to retrieve password
148
149       port   Physical  plug  number or name of virtual machine This parameter
150              is always required.
151
152       snmp_version
153              Specifies SNMP version to use (1,2c,3)
154
155       community
156              Set the community string
157
158       snmp_auth_prot
159              Set authentication protocol (MD5|SHA)
160
161       snmp_sec_level
162              Set security level (noAuthNoPriv|authNoPriv|authPriv)
163
164       snmp_priv_prot
165              Set privacy protocol (DES|AES)
166
167       snmp_priv_passwd
168              Set privacy protocol password
169
170       snmp_priv_passwd_script
171              Script to run to retrieve privacy password
172
173       udpport
174              UDP/TCP port to use for connection with device  (Default  Value:
175              161)
176
177       inet4_only
178              Forces agent to use IPv4 addresses only
179
180       inet6_only
181              Forces agent to use IPv6 addresses only
182
183       verbose
184              Verbose mode
185
186       debug  Write debug information to given file
187
188       version
189              Display version information and exit
190
191       help   Display help and exit
192
193       separator
194              Separator  for  CSV created by operation list (Default Value: ,)
195
196
197       power_timeout
198              Test X seconds for status change after  ON/OFF  (Default  Value:
199              20)
200
201       shell_timeout
202              Wait  X  seconds  for  cmd prompt after issuing command (Default
203              Value: 3)
204
205       login_timeout
206              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
207
208
209       power_wait
210              Wait X seconds after issuing ON/OFF (Default Value: 0)
211
212       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
213
214
215       retry_on
216              Count of attempts to retry power on (Default Value: 1)
217
218
219
220fence_cisco_mds (Fence Agent)     2009-10-20                    FENCE_AGENT(8)