.TH "LVM2-ACTIVATION\-GENERATOR" "8" "LVM TOOLS 2.03.01(2) (2018-10-31)" "Red Hat, Inc" "\""
.SH "NAME"
lvm2\-activation\-generator \- generator for systemd units to activate LVM2 volumes on boot
.SH SYNOPSIS
.B /lib/systemd/system-generators/lvm2\-activation\-generator
.sp
.SH DESCRIPTION

The lvm2\-activation\-generator is called by \fBsystemd\fP(1) on boot to
generate systemd units at runtime to activate LVM Logical Volumes (LVs)
when global/event_activation=0 is set in \fBlvm.conf\fP(5).  These units use
\fBvgchange \-ay\fP to activate LVs.

If event_activation=1, the lvm2\-activation\-generator exits immediately without
generating any systemd units, and LVM fully relies on event-based
activation to activate LVs.  In this case, event-generated \fBpvscan
-\-cache \-aay\fP commands activate LVs.

These systemd units are generated by lvm2\-activation\-generator:
.sp
\fIlvm2\-activation\-early.service\fP
used for activation of LVM2 volumes that is ordered before systemd's
special \fBcryptsetup.target\fP to support LVM2 volumes which are not
layered on top of encrypted devices.

\fIlvm2\-activation.service\fP
used for activation of LVM2 volumes that is ordered after systemd's
special \fBcryptsetup.target\fP to support LVM2 volumes which are
layered on top of encrypted devices.

\fIlvm2\-activation\-net.service\fP
used for activation of LVM2 volumes that is ordered after systemd's
special \fBremote-fs\-pre.target\fP to support LVM2 volumes which are
layered on attached remote devices.

Note that all the underlying devices (Physical Volumes) need to be present
when the service is run. If the there are any devices presented in the system
anytime later, any LVM2 volumes on top of such devices need to be activated
directly by \fBlvchange\fP(8) or \fBvgchange\fP(8). This limitation does
not exist when using \fBlvmetad\fP(8) and accompanying event-based activation
since such LVM volumes are activated automatically as soon as the Volume Group
is ready (all the Physical Volumes making up the Volume Group are present
in the system).

The lvm2\-activation\-generator implements the \fBGenerators Specification\fP
as referenced in \fBsystemd\fP(1).
.sp
.SH SEE ALSO
.BR lvm.conf (5)
.BR vgchange (8)
.BR lvchange (8)
.BR lvmetad (8)
.BR pvscan (8)
.BR udev (7)
.BR systemd (1)
.BR systemd.target (5)
.BR systemd.special (7)