TGT-ADMIN(8) TGT Configuration Tool TGT-ADMIN(8)NAMEtgt-admin - Linux SCSI Target Configuration Tool.
SYNOPSIStgt-admin -[OPTION]...
DESCRIPTIONtgt-admin is a utility which allows a persistent configuration of tar‐
gets and luns.
It uses tgtadm commands to create, delete and show targets.
OPTIONS-e, --execute
read /etc/tgt/targets.conf and execute tgtadm commands.
if target already exists it will be deleted and a new instance will be
created with the new parameters instead.
-d, --delete
delete all the targets
-s, --show
show all the targets
-f, --force
don't exit on tgtadm errors
-p, --pretend
only print tgtadm options
-v, --verbose
increase verbosity (no effect in "pretend" mode)
-c, --conf <conf_file>
specify an alternative configuration file instead of /etc/tgt/tar‐
get.conf, which is the default.
-h, --help
display a list of available options and exits
CONFIGURATION FILE SYNTAX
The defualt configuration file is: /etc/tgt/target.conf. It defines all
the targets and their properties.
The configuration file is in XML format and uses tags. Configuration
file contains several target blocks, where each block contains target's
proerties such as storage devices, initator ACL and authorization
information. You can include other config files using:
include /etc/tgt/xen/*.conf.
There are 2 types of storage devices:
backing-store - defines a virtual device on the target.
direct-store - defines a direct mapped device with the same properties
as the physical device (such as VENDOR_ID , SERIAL_NUM, etc.)
initiator-address - allows connections only from the specify IP
address. defaults to ALL if no "initiator-address" is specified
incominguser - define iscsi incoming authentication setting. if no
"incominguser" is specified, it is not used.
outgoinguser - define iscsi outgoing authentication setting. if no
"outgoinguser" is specified, it is not used.
example for a configuration file:
<target iqn.2007-04.com.example:san.monitoring>
backing-store /dev/san/monitoring
# if no "incominguser" is specified, it is not used
incominguser backup secretpass12
# defaults to ALL if no "initiator-address" is specified
initiator-address 192.168.1.2 </target>
<target iqn.2007-02.com.example:san.xen1>
backing-store /dev/san/xen1-disk1 # LUN1
direct-store /dev/san/xen1-disk2 # LUN2
initiator-address 192.168.1.2 # Allowed IP
initiator-address 192.168.5.6 # Allowed IP
incominguser user1 secretpass12
incominguser user2 secretpass23
outgoinguser userA secretpassA </target>
<target iqn.2007-02.com.example:san.xen2>
backing-store /dev/san/xen2 </target>
<target iqn.2007-06.com.example:san.vmware1>
backing-store /dev/san/vmware1 </target>
FILES
/etc/tgt/target.conf
Configuration file for tgt-admin.
SEE ALSOtgtadm(8)REPORTING BUGS
Report bugs to <stgt-devel@lists.berlios.de>
TGT Configuration Tool 2008-07-21 TGT-ADMIN(8)