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

NAME

7       fence_ovh - Fence agent for OVH
8

DESCRIPTION

10       fence_ovh  is an Power Fencing agent which can be used within OVH date‐
11       centre. Poweroff is simulated with a reboot into rescue-pro mode.
12
13       fence_ovh accepts options on the command line as well  as  from  stdin.
14       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
15       fence_ovh can be run by itself with command line options.  This is use‐
16       ful for testing and for turning outlets on or off from scripts.
17
18       Vendor URL: http://www.ovh.net
19

PARAMETERS

21
22
23       -o, --action=[action]
24              Fencing action (Default Value: reboot)
25
26       -Z, --email=[email]
27              Reboot  email  This  parameter  is always required.
28
29
30       -p, --password=[password]
31              Login password or passphrase
32
33       -S, --password-script=[script]
34              Script to run to retrieve password
35
36       -n, --plug=[id]
37              Physical plug  number  on  device,  UUID  or  identification  of
38              machine This parameter is always required.
39
40       -l, --username=[name]
41              Login name This parameter is always required.
42
43       -q, --quiet
44              Disable logging to stderr. Does not affect --verbose or --debug-
45              file or logging to syslog.
46
47       -v, --verbose
48              Verbose mode
49
50       -D, --debug-file=[debugfile]
51              Write debug information to given file
52
53       -V, --version
54              Display version information and exit
55
56       -h, --help
57              Display help and exit
58
59       -C, --separator=[char]
60              Separator for CSV created by 'list' operation (Default Value: ,)
61
62
63       --delay=[seconds]
64              Wait  X  seconds  before  fencing  is started (Default Value: 0)
65
66
67       --login-timeout=[seconds]
68              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
69
70
71       --power-timeout=[seconds]
72              Test  X  seconds  for status change after ON/OFF (Default Value:
73              20)
74
75       --power-wait=[seconds]
76              Wait X seconds after issuing ON/OFF (Default Value: 0)
77
78       --shell-timeout=[seconds]
79              Wait X seconds for cmd prompt  after  issuing  command  (Default
80              Value: 3)
81
82       --retry-on=[attempts]
83              Count of attempts to retry power on (Default Value: 1)
84
85

ACTIONS

87
88
89       on     Power on machine.
90
91       off    Power off machine.
92
93       reboot Reboot machine.
94
95       list   List  available  plugs with aliases/virtual machines if there is
96              support for more then one device. Returns N/A otherwise.
97
98       list-status
99              List available plugs with  aliases/virtual  machines  and  their
100              power  state  if it can be obtained without additional commands.
101
102
103       monitor
104              Check the health of fence device
105
106       metadata
107              Display the XML metadata describing this resource.
108
109       manpage
110               The operational behavior of this is not known.
111
112       validate-all
113              Validate if all required parameters are entered.
114
115

STDIN PARAMETERS

117
118
119       action Fencing action (Default Value: reboot)
120
121       email  Reboot email This parameter is  always  required.
122
123
124       password
125              Login password or passphrase Obsoletes: passwd
126
127       password_script
128              Script  to  run  to  retrieve  password Obsoletes: passwd_script
129
130
131       plug   Physical plug  number  on  device,  UUID  or  identification  of
132              machine This parameter is always required. Obsoletes: port
133
134
135       username
136              Login name This parameter is always required.  Obsoletes:  login
137
138
139       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
140              file or logging to syslog.
141
142       verbose
143              Verbose mode
144
145       debug_file
146              Write debug information to given file Obsoletes: debug
147
148       version
149              Display version information and exit
150
151       help   Display help and exit
152
153       separator
154              Separator for CSV created by 'list' operation (Default Value: ,)
155
156
157       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
158
159
160       login_timeout
161              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
162
163
164       power_timeout
165              Test  X  seconds  for status change after ON/OFF (Default Value:
166              20)
167
168       power_wait
169              Wait X seconds after issuing ON/OFF (Default Value: 0)
170
171       shell_timeout
172              Wait X seconds for cmd prompt  after  issuing  command  (Default
173              Value: 3)
174
175       retry_on
176              Count of attempts to retry power on (Default Value: 1)
177
178
179
180fence_ovh (Fence Agent)           2009-10-20                    FENCE_AGENT(8)
Impressum