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-INITIATOR(8) BSD System Manager's Manual ISCSI-INITIATOR(8) NAME
iscsi-initiator -- refuse-based iSCSI initiator SYNOPSIS
iscsi-initiator [-46bcDfVv] [-a authentication-type] [-d digest-type] [-h target-hostname] [-p target-port-number] [-t target-number] [-u username] mount_point DESCRIPTION
The iscsi-initiator utility can be used to access an iSCSI target, such as iscsi-target(8), to access block storage which has been exported. Information pertaining to the target is displayed underneath the mount point, along with the device corresponding to the storage which the target exports. The various arguments are as follows: -4 Use an IPv4 connection to the target. -6 Use an IPv6 connection to the target. -a authentication-type Use the specified authentication type when communicating with the target. The possible values are chap, kerberos, srp or none. The default value is none. -b Show the storage as a block device. -c Show the storage as a character device. -d digest-type Use the specified digest type when communicating with the target. The possible values are header, data, both, all or none. The default value is none. -D List the LUNs on the specified target and exit (i.e. do discovery only) -f Show the storage as a regular file. -h hostname Connect to the iSCSI target running on the host specified as the argument. -p port-number Connect to the iSCSI target running on the port specified as the argument. The default value is 3260. -t target Connect to the number of the iSCSI target running as the argument. -u username Use the specified user's credentials when logging in to the iSCSI target. There is no default. -V Print out the version number and then exit. -v Be verbose in operation. The refuse(3) library is used to provide the file system features. The mandatory parameter is the local mount point. This iSCSI initiator presents a view of the targets underneath the mount point. Firstly, it creates a directory tree with the hostname of the target, and, in that directory, a virtual directory is created for each target name exported by the iSCSI target program. Within that virtual target directory, symbolic links exist for the hostname (for convenience), a textual representation of the IP address, the iSCSI tar- get product name, the iSCSI target IQN, the iSCSI target vendor and version number. One other directory entry is presented in the virtual target directory, relating to the storage presented by the iSCSI target. This can be in the form of a regular file, which is also the default, a block device or a character device. Please note that the iscsi-initiator utility needs the ``puffs'' kernel module loaded via modload(8) to operate. EXAMPLES
# ./iscsi-initiator -u agc -h iscsi-target0.alistaircrooks.co.uk /mnt # ls -al /mnt/target0 total 576 drwxr-xr-x 2 agc agc 512 May 11 22:24 . drwxr-xr-x 2 agc agc 512 May 11 22:24 .. lrw-r--r-- 1 agc agc 39 May 11 22:24 hostname -> iscsi-target0.alistaircrooks.co.uk lrw-r--r-- 1 agc agc 14 May 11 22:24 ip -> 172.16.135.130 lrw-r--r-- 1 agc agc 16 May 11 22:24 product -> NetBSD iSCSI -rw-r--r-- 1 agc agc 104857600 May 11 22:24 storage lrw-r--r-- 1 agc agc 43 May 11 22:24 targetname -> iqn.1994-04.org.netbsd.iscsi-target:target0 lrw-r--r-- 1 agc agc 8 May 11 22:24 vendor -> NetBSD lrw-r--r-- 1 agc agc 4 May 11 22:24 version -> 0 # SEE ALSO
puffs(3), refuse(3), iscsi-target(8) HISTORY
The iscsi-initiator utility first appeared in NetBSD 6.0. An earlier version called iscsifs was available in NetBSD 5.0 in source format only. AUTHORS
The iscsi-initiator utility was written by Alistair Crooks <agc@NetBSD.org>. BUGS
iscsi-initiator currently only supports a CHAP challenge length of 16 octets. Other initiators support up to 1024 and thus it is expected that most targets will also support such lengths. This means that CHAP compatibility with other targets apart from iscsi-target(8) is likely to be poor. To workaround this, please use authentication type none by not specifying a username with the -u option. BSD
February 22, 2011 BSD