tcmu-runner - Man Page

A daemon that handles the userspace side of the LIO TCM-User backstore

Description

tcmu-runner is a service that provides an operating environment for LIO TCM-User handlers. These currently include handlers for Gluster glfs and the qcow and qcow2 image formats.

Usage

While normally started automatically via D-Bus system activation, tcmu-runner can also be run as root directly, usually for debugging and development purposes.

Options

-h,  --help

Print usage information

-d,  --debug

Enable debug messages

-V,  --version

Print tcmu-runner's version

Configuring Handlers

TCMU-backed handlers are typically configured using normal LIO configuration tools, such as targetcli. Part of doing this will be entering a handler-specific configuration string.

CONFIGURING GLUSTER HANDLER (glfs)

This handler uses the Gluster glfs API to use Gluster as a backstore for the image file.

Its configuration string is:

volume@hostname/filename
volume: The volume on the Gluster server
hostname: The server's hostname
filename: The backing file

CONFIGURING QCOW HANDLER (qcow)

This handler supports qcow, qcow2, or raw image file formats.

Its configuration string is:

path
path: The full path to a file of a supported file format. The file must already have been created using qemu-img.

See Also

qemu-img(1), targetcli(8), targetctl(8)

Author

Andy Grover <agrover@redhat.com>

Reporting Bugs

Report bugs via <target-devel@vger.kernel.org>
or <https://github.com/agrover/tcmu-runner/issues>

Referenced By

gluster-block(8), gluster-blockd(8), targetcli(8), targetclid(8).