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

NAME

7       fence_alom - Fence agent for Sun ALOM
8

DESCRIPTION

10       fence_alom  is  an  I/O  Fencing agent which can be used with ALOM con‐
11       nected machines.
12
13       fence_alom accepts options on the command line as well as  from  stdin.
14       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
15       fence_alom can be run by itself with command  line  options.   This  is
16       useful for testing and for turning outlets on or off from scripts.
17
18       Vendor URL: http://www.sun.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 This parameter is always required.
31
32       -p, --password=<password>
33              Login password or passphrase
34
35       -S, --password-script=<script>
36              Script to retrieve password
37
38       -x, --ssh
39              SSH connection (Default Value: true)
40
41       -k, --identity-file=<filename>
42              Identity file for ssh
43
44       -4, --inet4-only
45              Forces agent to use IPv4 addresses only
46
47       -6, --inet6-only
48              Forces agent to use IPv6 addresses only
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: 5)
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       secure SSH connection (Default Value: true)
126
127       identity_file
128              Identity file for ssh
129
130       inet4_only
131              Forces agent to use IPv4 addresses only
132
133       inet6_only
134              Forces agent to use IPv6 addresses only
135
136       ipport TCP port to use for connection with device
137
138       verbose
139              Verbose mode
140
141       debug  Write debug information to given file
142
143       version
144              Display version information and exit
145
146       help   Display help and exit
147
148       power_timeout
149              Test X seconds for status change after  ON/OFF  (Default  Value:
150              20)
151
152       shell_timeout
153              Wait  X  seconds  for  cmd prompt after issuing command (Default
154              Value: 3)
155
156       login_timeout
157              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
158
159
160       power_wait
161              Wait X seconds after issuing ON/OFF (Default Value: 0)
162
163       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
164
165
166       retry_on
167              Count of attempts to retry power on (Default Value: 1)
168
169
170
171fence_alom (Fence Agent)          2009-10-20                    FENCE_AGENT(8)