Linux Certif

Toute la documentation sur la certification Linux LPI

tgt-admin

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 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 ALSO

tgtadm(8)

REPORTING BUGS

Report bugs to <stgt-devel@lists.berlios.de>