Re: RFC [patch] README.passthrough v1 (2nd send)

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



I've also attached the patch as well as inline.

Cheers
Mark

From 07e7587991912d9225f2b273d140558048157b7d Mon Sep 17 00:00:00 2001
From: Mark Harvey <markh794@xxxxxxxxx>
Date: Fri, 6 Aug 2010 17:06:51 +1000
Subject: Initial documentation for configuring passthrough mode

Signed-off-by: Mark Harvey <markh794@xxxxxxxxx>
---
doc/README.passthrough |  190 ++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 190 insertions(+), 0 deletions(-)

diff --git a/doc/README.passthrough b/doc/README.passthrough
new file mode 100644
index 0000000..59eb068
--- /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




>From 07e7587991912d9225f2b273d140558048157b7d Mon Sep 17 00:00:00 2001
From: Mark Harvey <markh794@xxxxxxxxx>
Date: Fri, 6 Aug 2010 17:06:51 +1000
Subject: Initial documentation for configuring passthrough mode

Signed-off-by: Mark Harvey <markh794@xxxxxxxxx>
---
 doc/README.passthrough |  190 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 190 insertions(+), 0 deletions(-)

diff --git a/doc/README.passthrough b/doc/README.passthrough
new file mode 100644
index 0000000..59eb068
--- /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


[Index of Archives]     [Linux SCSI]     [Linux RAID]     [Linux Clusters]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]

  Powered by Linux