lrbd(8) - f29

1lrbd(8)                     System Manager's Manual                    lrbd(8)
2
3
4

NAME

6       lrbd - configures iSCSI access to Ceph rbd images
7

SYNOPSIS

9       lrbd [OPTION] ...
10

DESCRIPTION

12       lrbd  without  any  options  will  read the configuration from Ceph and
13       apply the changes to  the  host.   The  configuration  is  detailed  in
14       lrbd.conf(5).  Changes are executed via targetcli(8).
15
16       The options are as follows:
17

OPTIONS

19       -e, --edit
20           edit  the global configuration.  If the EDITOR environment variable
21           is set, uses the specified editor.
22
23       -E editor, --edit editor
24           edit the global configuration with the program specified.
25
26       -c name, --config name
27           sets the object name in Ceph to name.  The default is lrbd.conf
28
29       --ceph ceph
30           set   the   Ceph    configuration    file.     The    default    is
31           /etc/ceph/ceph.conf.
32
33       -H host, --host host
34           specify the hostname which defaults to gethostname().
35
36       -o, --output
37           display the global configuration
38
39       -l, --local
40           display the host configuration
41
42       -f file, --file file
43           import the configuration from a file
44
45       -a file, --add file
46           add the configuration from a file
47
48       -u, --unmap
49           unmap the rbd images.  Images in use will fail to unmap.
50
51       -v, --verbose
52           print INFO messages
53
54       -d, --debug
55           print DEBUG messages
56
57       -I, --iblock
58           use an iblock backstore for images, default to rbd
59
60       -R, --rbd
61           use an rbd backstore for images, can override -I
62
63       -W, --wipe
64           remove all configuration objects from all pools.  Use with care.
65
66       -C, --clear
67           remove the current targetcli configuration from the host.
68
69       Some options may be combined, such as -Cu to first clear the configura‐
70       tion and then unmap the images.
71

EXAMPLES

73       ·   Customize a sample configuration and import.
74
75               $ cp /usr/share/doc/packages/lrbd/samples/tpg.json /tmp
76               $ vi /tmp/tpg.json
77               $ lrbd -f /tmp/tpg.json
78
79           Edit the current configuration with the editor joe
80
81               $ lrbd -E joe
82
83
84           Display the configuration for another host on the current gateway.
85
86               $ lrbd -H gateway2 -l
87
88

FILES

90       /etc/sysconfig/lrbd
91              The environment file for customizing options for  the  lrbd.ser‐
92              vice
93       /usr/lib/systemd/system/lrbd.service
94              The service file to apply the configuration during boot.
95

AUTHOR

97       Eric Jackson <ejackson@suse.com>
98