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

NAME

7       fence_rcd_serial - rcd_serial fence agent
8

DESCRIPTION

10       fence_rcd_serial  operates  a  serial  cable that toggles a reset of an
11       opposing server using the reset switch on its  motherboard.  The  cable
12       itself  is simple with no power, network or moving parts. An example of
13       the cable is available here: https://smcleod.net/rcd-stonith/  and  the
14       circuit design is available in the fence-agents src as SVG
15
16       fence_rcd_serial  accepts  options  on the command line as well as from
17       stdin. Fenced sends parameters through stdin when it execs  the  agent.
18       fence_rcd_serial  can be run by itself with command line options.  This
19       is useful for testing and for turning outlets on or off from scripts.
20
21       Vendor URL: https://github.com/sammcj/fence_rcd_serial
22

PARAMETERS

24
25
26       -o, --action=[action]
27              Fencing action (Default Value: reboot)
28
29       -m, --method=[method]
30              Method to fence (onoff|cycle) (Default Value: cycle)
31
32       --serial-port=[port]
33              Port of the serial device (Default Value: /dev/ttyS0)
34
35       -q, --quiet
36              Disable logging to stderr. Does not affect --verbose or --debug-
37              file or logging to syslog.
38
39       -v, --verbose
40              Verbose  mode.  Multiple  -v flags can be stacked on the command
41              line (e.g., -vvv) to increase verbosity.
42
43       --verbose-level
44              Level of debugging detail in output. Defaults to the  number  of
45              --verbose  flags  specified on the command line, or to 1 if ver‐
46              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
47
48
49       -D, --debug-file=[debugfile]
50              Write debug information to given file
51
52       -V, --version
53              Display version information and exit
54
55       -h, --help
56              Display help and exit
57
58       --delay=[seconds]
59              Wait  X  seconds  before  fencing  is started (Default Value: 0)
60
61
62       --disable-timeout=[true/false]
63              Disable timeout (true/false) (default: true when run from  Pace‐
64              maker 2.0+)
65
66       --login-timeout=[seconds]
67              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
68
69
70       --power-timeout=[seconds]
71              Test X seconds for status change after  ON/OFF  (Default  Value:
72              20)
73
74       --power-wait=[seconds]
75              Wait X seconds after issuing ON/OFF (Default Value: 2)
76
77       --shell-timeout=[seconds]
78              Wait  X  seconds  for  cmd prompt after issuing command (Default
79              Value: 3)
80
81       --retry-on=[attempts]
82              Count of attempts to retry power on (Default Value: 1)
83
84

ACTIONS

86
87
88       reboot Reboot machine.
89
90       monitor
91              Check the health of fence device
92
93       metadata
94              Display the XML metadata describing this resource.
95
96       manpage
97               The operational behavior of this is not known.
98
99       validate-all
100              Validate if all required parameters are entered.
101
102

STDIN PARAMETERS

104
105
106       action Fencing action (Default Value: reboot)
107
108       method Method to fence (onoff|cycle) (Default Value: cycle)
109
110       serial_port
111              Port of the serial device (Default Value: /dev/ttyS0)
112
113       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
114              file or logging to syslog.
115
116       verbose
117              Verbose  mode.  Multiple  -v flags can be stacked on the command
118              line (e.g., -vvv) to increase verbosity.
119
120       verbose_level
121              Level of debugging detail in output. Defaults to the  number  of
122              --verbose  flags  specified on the command line, or to 1 if ver‐
123              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
124
125
126       debug_file
127              Write debug information to given file Obsoletes: debug
128
129       version
130              Display version information and exit
131
132       help   Display help and exit
133
134       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
135
136
137       disable_timeout
138              Disable timeout (true/false) (default: true when run from  Pace‐
139              maker 2.0+)
140
141       login_timeout
142              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
143
144
145       power_timeout
146              Test X seconds for status change after  ON/OFF  (Default  Value:
147              20)
148
149       power_wait
150              Wait X seconds after issuing ON/OFF (Default Value: 2)
151
152       shell_timeout
153              Wait  X  seconds  for  cmd prompt after issuing command (Default
154              Value: 3)
155
156       retry_on
157              Count of attempts to retry power on (Default Value: 1)
158
159
160
161fence_rcd_serial (Fence Agent)    2009-10-20                    FENCE_AGENT(8)
Impressum