| VBLADE-PERSISTENCE(5) | VBLADE-PERSISTENCE(5) |
vblade-persistence - description of the vblade persistence
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:
Any options as provided by vblade(7).
Use these to define an I/O scheduling class and level for that export. The value must be understood by ionice(1).
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'
Install vblade-generator in /lib/systemd/system-generators/, and both vblade.service and vblade@.service in /lib/systemd/system/. Enable the vblade service, reload systemd. Additional units for each export should appear, named vblade@<instance>.service.
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:
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.
As above, but without using LSB functions.
Pros: Should be fairly portable, no thrills.
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.
On SysV init systems, the configuration files are always sourced as shell scripts. On systemd systems, the configuration file is just a key/value store without shell expansion.
It’s a wise idea to run sh -n against a configuration file after any modification for basic format validation.
daemon: <http://www.libslack.org/daemon/>
Christoph Biedl <sourceforge.bnwi@manchmal.in-ulm.de>