1targetd.yaml(5) File Formats Manual targetd.yaml(5)
2
3
4
6 targetd.yaml - configuration file
7
9 targetd.yaml is the configuration file for the targetd service.
10
12 targetd uses /etc/target/targetd.yaml for configuration. It is in YAML
13 format. targetd currently uses scalar values and collection values,
14 see example for details.
15
16 CONFIGURATION FILE SETTINGS
17 block_pools
18 Sets the LVM Volume Group(s) that targetd will use to allocate volumes.
19 Defaults to ["vg-targetd"].
20
21 Alternatively, targetd can allocate thinp (thin-provisioned) volumes
22 out of a thinpool LV. These should be listed as "<vgname>/<poolname>",
23 with the VG and thinpool LV names separated by a "/". These should
24 already be created; targetd will not create VGs or thinpool LVs.
25
26 If you want to use ZFS exclusively, this should be set as empty list.
27
28 zfs_block_pools
29 Sets the ZFS parent dataset(s) that targetd will use to allocate vol‐
30 umes. Defaults to empty list.
31
32 This should be list of already existing zfs filesystem datasets. It
33 cannot contain any two datasets which are in parent-child relationship,
34 like "tank/ds" and "tank/ds/ds2".
35
36 Using ZFS requires zfs binary to be accessible. Cannot contain colons
37 even though it's supported by ZFS itself.
38
39 zfs_enable_copy
40 Enables copy method on ZFS volumes. Warning: copying ZFS volumes will
41 make source volumes unable to be deleted as long as copies exist. This
42 is due to ZFS snapshot/clone limitations.
43
44 fs_pools
45 Sets the mount point(s) that targetd will use to export filesystems
46 over NFS. Defaults to none.
47
48 user
49 password
50 Sets the username and password required to use the remote API. "user"
51 defaults to admin, but password must be set prior to using targetd.
52
53 target_name
54 Sets the iSCSI target name that targetd will use. Default is
55 iqn.2003-01.org.linux-iscsi.<hostname>:targetd.
56
57 log_level
58 Set the daemon logging verbosity. Select one of the following: debug,
59 info, warning, error, critical. Defaults to "info".
60
61 ssl
62 ssl_key
63 ssl_cert
64 Settings for enabling SSL/TLS encryption. ssl defaults to off. If
65 enabled, it will default to looking for key and cert files named tar‐
66 getd_key.pem and targetd_cert.pem in /etc/target. These paths may also
67 be specified, using the ssl_key and ssl_cert config settings.
68
69 Key and self-signed cert may be generated using openssl:
70
71 openssl genrsa -out targetd_key.pem 2048
72 openssl req -new -x509 -key targetd_key.pem -out targetd_cert.pem -days
73 9999
74
75
77 targetd(8), targetcli(8), lvm(8), lsmcli(8)
78
79
81 Written by Andy Grover <andy@groveronline.com> and
82 Tony Asleson <tasleson@redhat.com>.
83
84
86 Report bugs via <targetd-devel@lists.fedorahosted.org>
87 or <https://github.com/open-iscsi/targetd/issues>
88
89
90
91 targetd.yaml(5)