Whamcloud - gitweb
LU-107 Add scripts for implementing heartbeat v1 failover
[fs/lustre-release.git] / lustre / doc / lhbadm.8
1 .TH lhbadm 8 "2009 Apr 29" Lustre "System Administration Utilities"
2 .SH NAME
3 lhbadm \- Lustre failover utility
4 .SH SYNOPSIS
5 .B lhbadm {failover|failback} reason ...
6 .br
7 .B pdsh -g lustre lhbadm status | dshbak -c
8 .br
9 .SH DESCRIPTION
10 .B lhbadm
11 simlifies heartbeat administration on Lustre clusters.
12 It offers the following operations:
13 .TP
14 .B status
15 Print a single line status message consisting of the heartbeat resource
16 status a hyphen, and lustre status.
17 Under normal circumstatus, server status should be \fIlocal-local\fR.
18 .TP
19 .B failover \fIreason ...\fR
20 Initiate failover of local services (and foreign if active) to the
21 failover partner.
22 The command blocks until the transition is complete, which includes
23 starting lustre on the partner node.
24 Initiation and completion of failover is logged to the syslog
25 \fRuser.err\fI facility.
26 .TP
27 .B failback \fIreason ...\fR
28 Initiate failback of the local services from the failover
29 partner.  The command blocks until the transition is complete, which
30 includes starting lustre.
31 Initiation and completion of failback is logged to the syslog
32 \fRuser.err\fI facility.
33 .SH "HEARTBEAT STATUS VALUES"
34 The heartbeat resource status values returned by \fBlhbadm status\fR
35 may be one of the following:
36 .TP
37 .B local
38 Hearbeat expects only the local services to be running.
39 .TP
40 .B none
41 Hearbeat expects no services to be running.
42 .TP
43 .B all
44 Hearbeat expects local and foreign services to be running.
45 .TP
46 .B foreign
47 Hearbeat expects only the foreign services to be running.
48 .TP
49 .B transition
50 Resources are in transition.
51 .SH "LUSTRE STATUS VALUES"
52 The lustre status values returned by \fBlhbadm status\fR
53 may be one of the following:
54 .TP
55 .B loaded
56 Lustre modules are loaded but that's about it.
57 .TP
58 .B recovery
59 One or more Lustre services is in recovery.
60 .TP
61 .B unhealthy
62 Lustre is not healthy.
63 .TP
64 .B none
65 Lustre is not running any services
66 .TP
67 .B local
68 Lustre is running only the local services.
69 .TP
70 .B foreign
71 Lustre is running only the foreign services.
72 .TP
73 .B all
74 Lustre is running both the local and foreign services.
75 .TP
76 .B partial
77 Lustre is partially started and may be running one or more services,
78 but not exactly the local, foreign, or all sets.
79 .SH SEE ALSO
80 .BR cl_status (1)
81 .BR hb_takeover (1)
82 .BR hb_standby (1)