Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tgt-admin(8) [suse man page]

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)

Check Out this Related Man Page

ISCSI.CONF(5)							File Formats Manual						     ISCSI.CONF(5)

NAME

       iscsi.conf - iSCSI Target and LUN configuration

SYNOPSIS

       /etc/iscsi.conf

DESCRIPTION

       This manual page describes the format of the /etc/iscsi.conf file. This file is a simple text file that iscsid(8) uses to locate iSCSI tar-
       get devices and LUNs.  Comments are marked by lines beginning with '#'.

       Available entries include:

       DiscoveryAddress=<address>
	      IP address or hostname to use for target discovery.  A TCP port number may be specified by appending a colon followed  by  the  port
	      number. This entry must start in the first column, and must not contain any whitespace.

       TargetIpAddr=<address>
	      A synonym for DiscoveryAddress.

       Username=<user>
	      Specify  the  authentication user.  If this entry precedes all DiscoveryAddress entries, it serves as the default.  If this entry is
	      indented under a DiscoveryAddress entry, it specifies the user for all targets discovered at that IP address.

       Password=<pass>
	      Specify the authentication password for the previously listed iSCSI If this entry precedes all DiscoveryAddress entries,	it  serves
	      as  the default.	If this entry is indented under a DiscoveryAddress entry, it specifies the user for all targets discovered at that
	      IP address.

EXAMPLE

       # set the default user and password
       Username=alice
       Password=nty57nbe

       # targets at this address will use the default Username and Password
       DiscoveryAddress=192.168.10.94

       # targets at this address will use the Username and Password below
       DiscoveryAddress=192.168.10.95
	   Username=beatrice
	   Password=93fdgc20

NOTES

       The iSCSI initiator drivers, README files, and example configuration files are available on the Linux-iSCSI homepage at:

       http://linux-iscsi.sourceforge.com <http://linux-iscsi.sourceforge.com>

FILES

       /etc/iscsi.conf
	      iSCSI Target and LUN configuration

SEE ALSO

       iscsid(8)

$Revision: 1.9 $					   $Date: 2002/09/19 20:00:32 $ 					     ISCSI.CONF(5)
Man Page