TGT-ADMIN(8) TGT Configuration Tool TGT-ADMIN(8)
NAME
tgt-admin - Linux SCSI Target Configuration Tool.
SYNOPSIS
tgt-admin -[OPTION]...
DESCRIPTION
tgt-admin is a utility which allows a persistent configuration of targets 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/target.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 tar-
get'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 ALSO
tgtadm(8)
REPORTING BUGS
Report bugs to <stgt-devel@lists.berlios.de>
TGT Configuration Tool 2008-07-21 TGT-ADMIN(8)