OS Manuals

lhbadm(8)

lhbadm - Lustre failover utility

LHBADM(8) Lustre Configuration Utilities LHBADM(8)

lhbadm - Lustre failover utility

lhbadm {failover|failback} REASON ...
pdsh -g lustre lhbadm status | dshbak -c

lhbadm simplifies heartbeat administration on Lustre clusters. It offers the following operations:

Print a single line status message consisting of the heartbeat resource status a hyphen, and lustre status. Under normal circumstances, server status should be local-local.
Initiate failover of local services (and foreign if active) to the failover partner. The command blocks until the transition is complete, which includes starting lustre on the partner node. Initiation and completion of failover is logged to the syslog user.err facility.
Initiate failback of the local services from the failover partner. The command blocks until the transition is complete, which includes starting lustre. Initiation and completion of failback is logged to the syslog user.err facility.

The heartbeat resource status values returned by lhbadm status may be one of the following:

Heartbeat expects only the local services to be running.
Heartbeat expects no services to be running.
Heartbeat expects local and foreign services to be running.
Heartbeat expects only the foreign services to be running.
Resources are in transition.

The lustre status values returned by lhbadm status may be one of the following:

Lustre modules are loaded but that's about it.
One or more Lustre services is in recovery.
Lustre is not healthy.
Lustre is not running any services
Lustre is running only the local services.
Lustre is running only the foreign services.
Lustre is running both the local and foreign services.
Lustre is partially started and may be running one or more services, but not exactly the local, foreign, or all sets.

lhbadm is part of the lustre(7) filesystem package since release 2.3.0

cl_status(1), hb_standby(1), hb_takeover(1)

2024-08-29 Lustre

lustre 2.17.59-r2 · enterprise-packages · ingested 2026-10-11