Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
tree: 7a3999079d
Fetching contributors…

Cannot retrieve contributors at this time

89 lines (87 sloc) 1.818 kb
.TH targetd 8
.SH NAME
.B targetd
.SH DESCRIPTION
.B targetd
is a service to allow the remote configuration of block device volumes
within a pool, as well as exporting volumes to other hosts via iSCSI.
.SH USAGE
Run
.B targetd
as root.
.SH CONFIGURATION
.B targetd
uses
.B /etc/target/targetd.yaml
for configuration. It is in YAML format.
.B targetd
currently only sets scalar values so all values are just
.BR "<setting>: <value>" .
.SS CONFIGURATION FILE SETTINGS
.B pool_name
.br
Sets the LVM Volume Group that
.B targetd
will use to allocate volumes. Defaults to
.BR "pool_name: vg-targetd" .
.B targetd
currently supports a single volume group only.
.P
.B user
.br
.B password
.br
Sets the username and password required to use the remote
API. Defaults to
.B admin
and
.BR targetd ,
respectively.
.P
.B target_name
.br
Sets the iSCSI target name that
.B targetd
will use. Default is
.BR iqn.2003-01.org.linux-iscsi.<hostname>:targetd .
.P
.B ssl
.br
.B ssl_key
.br
.B ssl_cert
.br
Settings for enabling SSL/TLS encryption.
.B ssl
defaults to
.BR off .
If enabled, it will default to looking for key and cert files named
.B targetd_key.pem
and
.BR targetd_cert.pem
in
.BR /etc/target .
These paths may also be specified, using the
.B ssl_key
and
.B ssl_cert
config settings.
.P
Key and self-signed cert may be generated using openssl:
.P
.B openssl genrsa -out targetd_key.pem 2048
.br
.B openssl req -new -x509 -key targetd_key.pem -out targetd_cert.pem -days 9999
.SH FILES
.B /etc/target/targetd.yaml
.SH SEE ALSO
The remote API is defined at
.br
<https://github.com/agrover/targetd/blob/master/API.md>.
targetcli(8), lvm(8), lsmcli(8)
.SH AUTHOR
Written by Andy Grover <agrover@redhat.com>.
.SH REPORTING BUGS
Report bugs via <target-devel@vger.kernel.org>
.br
or <https://github.com/agrover/targetd/issues>
Jump to Line
Something went wrong with that request. Please try again.