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)