1targetd.yaml(5)               File Formats Manual              targetd.yaml(5)
2
3
4

NAME

6       targetd.yaml - configuration file
7

DESCRIPTION

9       targetd.yaml is the configuration file for the targetd service.
10

CONFIGURATION

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

SEE ALSO

77       targetd(8), targetcli(8), lvm(8), lsmcli(8)
78
79

AUTHORS

81       Written by Andy Grover <andy@groveronline.com> and
82       Tony Asleson <tasleson@redhat.com>.
83
84

REPORTING BUGS

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)
Impressum