suse man page for tgt-admin

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)