LHBADM(8) Lustre Configuration Utilities LHBADM(8)

# [NAME](#NAME)

lhbadm - Lustre failover utility

# [SYNOPSIS](#SYNOPSIS)

`lhbadm` {**failover**|**failback**} *REASON* ...

`pdsh` **-g lustre lhbadm status | dshbak -c**

# [DESCRIPTION](#DESCRIPTION)

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

[**status**](#status)

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**.

[**failover REASON ...**](#failover)

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*.

[**failback REASON ...**](#failback)

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*.

## [HEARTBEAT STATUS VALUES](#HEARTBEAT_STATUS_VALUES)

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

[**local**](#local)

Heartbeat expects only the local services to be running.

[**none**](#none)

Heartbeat expects no services to be running.

[**all**](#all)

Heartbeat expects local and foreign services to be running.

[**foreign**](#foreign)

Heartbeat expects only the foreign services to be running.

[**transition**](#transition)

Resources are in transition.

## [LUSTRE STATUS VALUES](#LUSTRE_STATUS_VALUES)

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

[**loaded**](#loaded)

Lustre modules are loaded but that's about it.

[**recovery**](#recovery)

One or more Lustre services is in recovery.

[**unhealthy**](#unhealthy)

Lustre is not healthy.

[**none**](#none~2)

Lustre is not running any services

[**local**](#local~2)

Lustre is running only the local services.

[**foreign**](#foreign~2)

Lustre is running only the foreign services.

[**all**](#all~2)

Lustre is running both the local and foreign services.

[**partial**](#partial)

Lustre is partially started and may be running one or more services, but not exactly the local, foreign, or all sets.

# [AVAILABILITY](#AVAILABILITY)

**lhbadm** is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 2.3.0

# [SEE ALSO](#SEE_ALSO)

[**cl\_status**(1)](/man/enterprise-packages/lustre/cl_status.1), [**hb\_standby**(1)](/man/enterprise-packages/lustre/hb_standby.1), [**hb\_takeover**(1)](/man/enterprise-packages/lustre/hb_takeover.1)

2024-08-29 Lustre

---

Document: lhbadm(8) from lustre 2.17.60-r0 (Chainguard OS)
Source: https://github.com/lustre/lustre-release