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
41
42       -D, --debug-file=[debugfile]
43              Write debug information to given file
44
45       -V, --version
46              Display version information and exit
47
48       -h, --help
49              Display help and exit
50
51       --delay=[seconds]
52              Wait  X  seconds  before  fencing  is started (Default Value: 0)
53
54
55       --login-timeout=[seconds]
56              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
57
58
59       --power-timeout=[seconds]
60              Test  X  seconds  for status change after ON/OFF (Default Value:
61              20)
62
63       --power-wait=[seconds]
64              Wait X seconds after issuing ON/OFF (Default Value: 2)
65
66       --shell-timeout=[seconds]
67              Wait X seconds for cmd prompt  after  issuing  command  (Default
68              Value: 3)
69
70       --retry-on=[attempts]
71              Count of attempts to retry power on (Default Value: 1)
72
73

ACTIONS

75
76
77       reboot Reboot machine.
78
79       monitor
80              Check the health of fence device
81
82       metadata
83              Display the XML metadata describing this resource.
84
85       manpage
86               The operational behavior of this is not known.
87
88       validate-all
89              Validate if all required parameters are entered.
90
91

STDIN PARAMETERS

93
94
95       action Fencing action (Default Value: reboot)
96
97       method Method to fence (onoff|cycle) (Default Value: cycle)
98
99       serial_port
100              Port of the serial device (Default Value: /dev/ttyS0)
101
102       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
103              file or logging to syslog.
104
105       verbose
106              Verbose mode
107
108       debug_file
109              Write debug information to given file Obsoletes: debug
110
111       version
112              Display version information and exit
113
114       help   Display help and exit
115
116       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
117
118
119       login_timeout
120              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
121
122
123       power_timeout
124              Test X seconds for status change after  ON/OFF  (Default  Value:
125              20)
126
127       power_wait
128              Wait X seconds after issuing ON/OFF (Default Value: 2)
129
130       shell_timeout
131              Wait  X  seconds  for  cmd prompt after issuing command (Default
132              Value: 3)
133
134       retry_on
135              Count of attempts to retry power on (Default Value: 1)
136
137
138
139fence_rcd_serial (Fence Agent)    2009-10-20                    FENCE_AGENT(8)