vblade-persistence(5)

Overview

vblade-persistence uses the files in /etc/vblade.conf.d/ to manage exports. File names must end in .conf. The "instance" name is the file name without .conf.

The file format is a POSIX shell fragment.

The following variables must be defined: netif, shelf, slot, and filename. See vblade(8) for their meaning. Incomplete configuration files are ignored, so are files that are not a valid shell syntax.

Additionally, the following variables may be defined:

• options

Any options as provided by vblade(7).

• ionice

Use these to define an I/O scheduling class and level for that export. The value must be understood by ionice(1).

Examples

    shelf=14
    slot=2
    netif=ens3
    filename=/dev/mapper/export
    options='-r -m 11:22:33:44:55:66,22:33:44:55:66:77 -o 8'
    ionice='--class best-effort --classdata 7'

Usage

On systems using systemd

Install vblade-generator in /lib/systemd/system-generators/, and both vblade.service and [email protected] in /lib/systemd/system/. Enable the vblade service, reload systemd. Additional units for each export should appear, named vblade@<instance>.service.

On systems using SysV init

Individual instances may be controlled by providing their name as a second option, e.g.

    /etc/init.d/vblade status demo

Two different init scripts are available:

vblade.init.lsb-daemon

Uses LSB functions and daemon(1) program to control the instance.

Pros: daemon(1) is a very fine tool for this, providing also respawning and output redirection.

vblade.init.daemon

As above, but without using LSB functions.

Pros: Should be fairly portable, no thrills.

Template

The template for these scripts is vblade.init.in, the actual templating is done using tpage(1p), see vblade.init.generate.

Support for using Debian’s start-stop-daemon has been prepared but requires pid file supprt in vblade to be usable.

History

Debian 13 (Trixie): the text shown here
Debian 12 (Bookworm)
Debian 11 (Bullseye)
Debian 10 (Buster)