ZFS intent-log recovery

A missing ZFS SLOG can hold acknowledged synchronous writes that have not yet reached the main pool.

After a crash, ZFS replays the intent log to complete synchronous writes. If a separate log device is missing or unreadable, zpool import -m can discard that log and make the pool importable, but recent acknowledged transactions may be lost.

Understand the symptom

The SLOG is read after a crash when uncommitted synchronous transactions need replay.

WHY

What is happening

Recovery determines whether the log device can be made readable, whether it was mirrored, when the last transaction group committed and which applications used synchronous writes. A readonly no-mount import can inventory the pool before any destructive import flag is considered.

What you may see

Symptoms that change the recovery path.

01

Import reports a missing log device

The pool labels reference a SLOG that is absent or faulted.

02

ZFS intent log read failure

The log cannot be replayed after an unexpected shutdown.

03

Pool imported only with -m

The system discarded the missing log to continue.

04

Database or NFS writes are missing

Acknowledged synchronous transactions may have existed only in the lost log.

Protect the source

Actions that can make the situation worse.

01

Import -m discards recent transactions

Applications may have been told those synchronous writes were durable.

02

Force import can create dual ownership

Importing a pool still active elsewhere can corrupt it.

03

Replacing the SLOG erases the clue

A newly initialized device does not contain the old intent log records.

Do this now

Safe steps before evaluation.

01

Stop import attempts

Do not use -m, -F, -X, clear or replacement commands on production.

02

Preserve all pool devices

Image the SLOG and label every data, special, cache and log vdev.

03

Collect ZFS evidence

Save zpool import output, labels, host logs, topology and last shutdown history.

04

Identify synchronous workloads

Record databases, NFS, VM or application services that relied on durable writes.

NEPFOSYS process

How a data-first evaluation proceeds.

01

Log-device assessment

NEPFOSYS evaluates whether the original or mirrored SLOG can be read and replayed.

02

Pool-state reconstruction

Labels, transaction groups and readonly import options are tested on copies.

03

Application validation

Recovered pool data is checked for database, VM and filesystem consistency around the outage.

A clear next step

Preserve the original device before another repair or recovery attempt.

Start a case with the exact symptoms, incident timeline, prior attempts, encryption details, and the files that matter most. NEPFOSYS will route the case to the appropriate DFW intake or nationwide mail-in path.

Start with a case review

Questions, answered

What customers ask before starting.

Does losing a SLOG always lose the pool?

Usually the main pool remains structurally present, but uncommitted synchronous writes may be lost after a crash.

What does zpool import -m do?

It allows import by discarding the missing log device and its unreplayed recent transactions.

Can I try a readonly import first?

A no-mount readonly import is a safer diagnostic step, but preserve unstable devices before repeated reads.

DFW local · Nationwide mail-in

Protect the device. Start with the facts.

Start my recovery case