vblade-persistence - description of the vblade persistence

Christoph Biedl sourceforge.bnwi@manchmal.in-ulm.deVBLADE-PERSISTENCE(5)

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.

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

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'

vblade-persistence - description of the vblade persistence

daemon: http://www.libslack.org/daemon/tpage(1p) vblade(8)

Onsystemsusingsystemd 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. OnsystemsusingSysVinit 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.