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

NAME

6       targetd
7

DESCRIPTION

9       targetd  is a service to allow the remote configuration of block device
10       volumes and file systems within dedicated pools. Block devices  can  be
11       exported  to other hosts via iSCSI, and filesystems can be exported via
12       NFS.
13

USAGE

15       Run targetd as root.
16

CONFIGURATION

18       targetd uses /etc/target/targetd.yaml for configuration. It is in  YAML
19       format.   targetd  currently  uses scalar values and collection values,
20       see example for details.
21
22   CONFIGURATION FILE SETTINGS
23       block_pools
24       Sets the LVM Volume Group(s) that targetd will use to allocate volumes.
25       Defaults to "vg-targetd".
26
27       Alternatively,  targetd  can  allocate thinp (thin-provisioned) volumes
28       out of a thinpool LV. These should be listed as  "<vgname>/<poolname>",
29       with  the  VG  and  thinpool  LV names separated by a "/". These should
30       already be created; targetd will not create VGs or thinpool LVs.
31
32       fs_pools
33       Sets the mount point(s) that targetd will  use  to  export  filesystems
34       over NFS. Defaults to none.
35
36       user
37       password
38       Sets  the  username and password required to use the remote API. "user"
39       defaults to admin, but password must be set prior to using targetd.
40
41       target_name
42       Sets  the  iSCSI  target  name  that  targetd  will  use.  Default   is
43       iqn.2003-01.org.linux-iscsi.<hostname>:targetd.
44
45       ssl
46       ssl_key
47       ssl_cert
48       Settings  for  enabling  SSL/TLS  encryption.  ssl defaults to off.  If
49       enabled, it will default to looking for key and cert files  named  tar‐
50       getd_key.pem and targetd_cert.pem in /etc/target.  These paths may also
51       be specified, using the ssl_key and ssl_cert config settings.
52
53       Key and self-signed cert may be generated using openssl:
54
55       openssl genrsa -out targetd_key.pem 2048
56       openssl req -new -x509 -key targetd_key.pem -out targetd_cert.pem -days
57       9999
58

FILES

60       /etc/target/targetd.yaml
61       /etc/target/targetd_key.pem
62       /etc/target/targetd_cert.pem
63

SEE ALSO

65       The remote API is defined at
66       <https://github.com/agrover/targetd/blob/master/API.md>.
67
68       targetcli(8), lvm(8), lsmcli(8)
69

AUTHOR

71       Written by Andy Grover <agrover@redhat.com>.
72

REPORTING BUGS

74       Report bugs via <targetd-devel@lists.fedorahosted.org>
75       or <https://github.com/agrover/targetd/issues>
76
77
78
79                                                                    targetd(8)
Impressum