[stgt] RFC [patch] README.passthrough v1
Mark Harvey
markh794 at gmail.com
Fri Aug 6 11:35:35 CEST 2010
As I'm not good with documentation, this is one version that may be
suitable.
This one is based on README.iscsi. The other patch is based on README.fcoe.
I'm happy to accept any comments on either version as to which one is
more suitable
and what sort of modifications / edits are required to get it to a
suitable format.
From 3a986694e335f890d7dfa88e41de8bc83fe8cf74 Mon Sep 17 00:00:00 2001
From: Mark Harvey <markh794 at gmail.com>
Date: Fri, 6 Aug 2010 17:06:51 +1000
Subject: Initial documentation for configuring passthrough mode
Signed-off-by: Mark Harvey <markh794 at gmail.com>
---
doc/README.passthrough | 190
++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 190 insertions(+), 0 deletions(-)
diff --git a/doc/README.passthrough b/doc/README.passthrough
new file mode 100755
index 0000000..c363b3c
--- /dev/null
+++ b/doc/README.passthrough
@@ -0,0 +1,190 @@
+Preface
+-------------
+This documents an example to set up tgt targets utilising existing SCSI
+targets on the host utilizing tgt passthrough module and /dev/sg paths.
+
+The hardware to be 'exported' via the SCSI target framework is an
+IBM 3573-TL library with a single LTO4 drive.
+
+Physical tape library connected and configured to host:
+# lsscsi -g
+[0:0:0:0] disk MAXTOR ATLAS10K4_36SCA DFM0 /dev/sda /dev/sg0
+[0:0:6:0] process PE/PV 1x3 SCSI BP 1.1 - /dev/sg1
+[2:0:1:0] tape IBM ULT3580-TD4 8192 /dev/st1 /dev/sg4
+[2:0:1:1] mediumx IBM 3573-TL 6.50 - /dev/sg5
+
+Please refer to the README.iscsi, README.iser or README.fcoe for
+instructions specific to setting up the transport layer specific section.
+
+Many of the examples below are using the iSCSI lld (low Level) transport.
+
+
+Starting the daemon
+-------------
+Please refer to 'Starting the daemon' in the README.iscsi, README.iser
or README.fcoe
+on instructions for correctly starting the daemon for your transport of
choice.
+
+
+Configuration
+-------------
+Everyting is configured via the tgtadm management tool.
+
+Please refer to "Configuration" in README.iscsi, README.iser or
README.fcoe on how to
+configure your target for the transport of choice.
+
+Return to here for further instructions on setting up each logical unit
using the
+passthrough module.
+
+An example to setup the target (target ID 1) for iSCSI
+host:~/tgt# ./usr/tgtadm --lld iscsi --op new --mode target --tid 1 \
+ -T iqn.2001-04.com.example:storage.vtl.amiens.sys1.xyz
+
+To display your target configuration:
+host:~/tgt# ./usr/tgtadm --lld iscsi --op show --mode target
+Target 1: iqn.2001-04.com.example:storage.vtl.amiens.sys1.xyz
+ System information:
+ Driver: iscsi
+ Status: running
+ I_T nexus information:
+ LUN information:
+ LUN: 0
+ Type: controller
+ SCSI ID: deadbeaf1:0
+ SCSI SN: beaf10
+ Size: 0
+ Backing store: No backing store
+ Account information:
+ ACL information:
+
+The controller device for management with lun 0 was created
+automatically. You can't remove it.
+
+Now it's time to add a logical unit to the target:
+ (The tape drive connected via /dev/sg4 - refer to 'lsscsi' output above)
+The important flags are:
+ - Specify device type as passthruough
+ "--device-type=pt"
+ - Backing store type is the '/dev/sg' paths
+ "--bstype=sg"
+ - Backing store path to use
+ "-b /dev/sg4"
+
+host:~/tgt# ./usr/tgtadm --lld iscsi --op new --mode logicalunit \
+ --tid 1 --lun 1 --bstype=sg --device-type=pt -b /dev/sg4
+
+To display the current configuration:
+
+host:~/tgt# ./usr/tgtadm --lld iscsi --op show --mode target
+Target 1: iqn.2001-04.com.example:storage.vtl.amiens.sys1.xyz
+ System information:
+ Driver: iscsi
+ Status: running
+ I_T nexus information:
+ LUN information:
+ LUN: 0
+ Type: controller
+ SCSI ID: deadbeaf1:0
+ SCSI SN: beaf10
+ Size: 0
+ Backing store: No backing store
+ LUN: 1
+ Type: (null)
+ SCSI ID: IET 00010002
+ SCSI SN: beaf12
+ Size: 0 MB
+ Online: Yes
+ Removable media: No
+ Backing store type: sg
+ Backing store path: /dev/sg4
+ Backing store flags:
+ Account information:
+ ACL information:
+
+To add another logical unit to this target:
+host:~/tgt# ./usr/tgtadm --lld iscsi --op new --mode logicalunit \
+ --tid 1 --lun 2 --bstype=sg --device-type=pt -b /dev/sg5
+
+
+If you don't need to configure this target any more, enable the target
+to accept any initiators:
+
+host:~/tgt# ./usr/tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL
+
+Note "ACL information" section. "ALL" means that this target accepts
+any initiators. The ACL feature also provides the access control based
+on initiators' addresses.
+
+For further instructions on ACL and account setup, please refer to the
README.iscsi
+
+As above, use the '--op show' option to display your current setup.
+host:~/tgt# ./usr/tgtadm --lld iscsi --op show --mode target
+Target 1: iqn.2001-04.com.example:storage.vtl.amiens.sys1.xyz
+ System information:
+ Driver: iscsi
+ Status: running
+ I_T nexus information:
+ LUN information:
+ LUN: 0
+ Type: controller
+ SCSI ID: deadbeaf1:0
+ SCSI SN: beaf10
+ Size: 0
+ Backing store: No backing store
+ LUN: 1
+ Type: (null)
+ SCSI ID: IET 00010002
+ SCSI SN: beaf12
+ Size: 0 MB
+ Online: Yes
+ Removable media: No
+ Backing store type: sg
+ Backing store path: /dev/sg4
+ Backing store flags:
+ LUN: 2
+ Type: (null)
+ SCSI ID: IET 00010002
+ SCSI SN: beaf12
+ Size: 0 MB
+ Online: Yes
+ Removable media: No
+ Backing store type: sg
+ Backing store path: /dev/sg5
+ Backing store flags:
+ Account information:
+ ACL information:
+ ALL
+
+
+
+iSCSI Initiator Information
+-------------
+After the target accepts initiators, the system information would be
+something like the following:
+
+Linux open-iscsi initiator
+hostb:~ # iscsiadm -m discovery -t sendtargets -p 10.251.60.20
+10.251.60.20:3260,1 iqn.2001-04.com.example:storage.vtl.amiens.sys1.xyz
+
+hostb:~ # iscsiadm -m node -T
iqn.2001-04.com.example:storage.vtl.amiens.sys1.xyz \
+ -p 10.251.60.20 --login
+Logging in to [iface: default, target:
iqn.2001-04.com.example:storage.vtl.amiens.sys1.xyz, portal:
10.251.60.20,3260]
+Login to [iface: default, target:
iqn.2001-04.com.example:storage.vtl.amiens.sys1.xyz, portal:
10.251.60.20,3260]: successful
+
+hostb:~ # lsscsi -g
+[0:0:0:0] cd/dvd TSSTcorp DVD-ROM TS-L333A D100 /dev/sr0 /dev/sg0
+[2:0:0:0] disk SEAGATE ST3400755SS NS25 /dev/sda /dev/sg1
+[2:0:1:0] disk SEAGATE ST3400755SS NS25 /dev/sdb /dev/sg2
+[3:0:0:0] disk DGC DISK 0429 /dev/sdc /dev/sg3
+[3:0:1:0] disk DGC DISK 0429 /dev/sdd /dev/sg4
+[11:0:0:0] storage IET Controller 0001 - /dev/sg5
+[11:0:0:1] tape IBM ULT3580-TD4 8192 /dev/st0 /dev/sg6
+[11:0:0:2] mediumx IBM 3573-TL 6.50 - /dev/sg7
+
+
+Shutdown the target cleanly
+---------------------------
+host:~/tgt# tgtadm --op unbind --mode target --tid 1 -I ALL
+host:~/tgt# tgtadm --op delete --mode conn --tid 1
+host:~/tgt# tgtadm --op delete --mode target --tid 1
+host:~/tgt# tgtadm --op delete --mode system
+
--
1.6.3.3
--
To unsubscribe from this list: send the line "unsubscribe stgt" in
the body of a message to majordomo at vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
More information about the stgt
mailing list