lrbd man page

lrbd — configures iSCSI access to Ceph rbd images


lrbd [OPTION] ...


lrbd without any options will read the configuration from Ceph and apply the changes to the host. The configuration is detailed in lrbd.conf(5). Changes are executed via targetcli(8).

The options are as follows:


-e, --edit
edit the global configuration. If the EDITOR environment variable is set, uses the specified editor.
-E editor, --edit editor
edit the global configuration with the program specified.
-c name, --config name
sets the object name in Ceph to name. The default is lrbd.conf
--ceph ceph
set the Ceph configuration file. The default is /etc/ceph/ceph.conf.
-H host, --host host
specify the hostname which defaults to gethostname().
-o, --output
display the global configuration
-l, --local
display the host configuration
-f file, --file file
import the configuration from a file
-a file, --add file
add the configuration from a file
-u, --unmap
unmap the rbd images. Images in use will fail to unmap.
-v, --verbose
print INFO messages
-d, --debug
print DEBUG messages
-I, --iblock
use an iblock backstore for images, default to rbd
-R, --rbd
use an rbd backstore for images, can override -I
-W, --wipe
remove all configuration objects from all pools. Use with care.
-C, --clear
remove the current targetcli configuration from the host.

Some options may be combined, such as -Cu to first clear the configuration and then unmap the images.


· Customize a sample configuration and import.

$ cp /usr/share/doc/packages/lrbd/samples/tpg.json /tmp
$ vi /tmp/tpg.json
$ lrbd -f /tmp/tpg.json

Edit the current configuration with the editor joe

$ lrbd -E joe

Display the configuration for another host on the current gateway.

$ lrbd -H gateway2 -l



The environment file for customizing options for the lrbd.service


The service file to apply the configuration during boot.


Eric Jackson <>

See Also

lrbd.conf(5), targetcli(8),