[stgt] Using opensolaris as iscsi initiator for stgt
FUJITA Tomonori
fujita.tomonori at lab.ntt.co.jp
Mon Dec 14 12:51:47 CET 2009
On Mon, 14 Dec 2009 11:40:55 +0100
Albert Pauw <albert.pauw at gmail.com> wrote:
> FUJITA Tomonori wrote:
> > On Mon, 14 Dec 2009 11:11:07 +0100
> > Albert Pauw <albert.pauw at gmail.com> wrote:
> >
> >
> >> I've attached the patches to move targets.conf.example to conf/examples/
> >> as well as the vtl examples (with the name Tomo suggested).
> >>
> >
> > Thanks!
> >
> >
> >
> >> As for the Makefile changes, I couldn't find anything to change, as only
> >> the empty targets.conf is installed as a dummy from conf/ which I just
> >> left as it was.
> >>
> >
> > I think we need to
> >
> > 1) modify doc/Makefile not to install targets.conf.example.
> > 2) modify conf/Makefile to create conf/examples/ and install the new
> > example files to it.
> >
> >
> Something like this?
We need to add tricks a bit.
This works for me.
=
From: FUJITA Tomonori <fujita.tomonori at lab.ntt.co.jp>
Subject: [PATCH] create conf/examples for multiple targets.conf examples
doc/targets.conf.example to conf/examples/targets.conf.example
Signed-off-by: FUJITA Tomonori <fujita.tomonori at lab.ntt.co.jp>
---
conf/Makefile | 4 +
conf/examples/targets.conf.example | 239 ++++++++++++++++++++++++++++++++++++
doc/Makefile | 3 +-
doc/targets.conf.example | 239 ------------------------------------
4 files changed, 244 insertions(+), 241 deletions(-)
create mode 100644 conf/examples/targets.conf.example
delete mode 100644 doc/targets.conf.example
diff --git a/conf/Makefile b/conf/Makefile
index 0ef29ab..d6b5ea6 100644
--- a/conf/Makefile
+++ b/conf/Makefile
@@ -1,5 +1,7 @@
sysconfdir ?= /etc
+EXAMPLES = targets.conf.example
+
.PHONY: all
all:
@@ -9,6 +11,8 @@ install:
if [ ! -f $(DESTDIR)$(sysconfdir)/tgt/targets.conf ] ; then \
install -m 644 targets.conf $(DESTDIR)$(sysconfdir)/tgt ; \
fi
+ install -d -m 755 $(DESTDIR)$(sysconfdir)/tgt/examples
+ install -m 644 examples/$(EXAMPLES) $(DESTDIR)$(sysconfdir)/tgt/examples
.PHONY: clean
clean:
diff --git a/conf/examples/targets.conf.example b/conf/examples/targets.conf.example
new file mode 100644
index 0000000..2f8020a
--- /dev/null
+++ b/conf/examples/targets.conf.example
@@ -0,0 +1,239 @@
+# This is a sample config file for tgt-admin.
+# By default, tgt-admin looks for its config file in /etc/tgt/targets.conf
+
+# This one includes other config files:
+
+include /etc/tgt/temp/*.conf
+
+
+# Set the driver. If not specified, defaults to "iscsi".
+
+default-driver iscsi
+
+
+# Continue if tgtadm exits with non-zero code (equivalent of
+# --ignore-errors command line option)
+#ignore-errors yes
+
+
+# Sample target with one LUN only. Defaults to allow access for all initiators:
+
+<target iqn.2008-09.com.example:server.target1>
+ backing-store /dev/LVM/somedevice
+</target>
+
+
+# Similar, but we use "direct-store" instead of "backing-store".
+# "direct-store" reads drive parameters with sg_inq command and sets them to
+# the target.
+# Parameters fatched with sg_inq are:
+# - Vendor identification
+# - Product identification
+# - Product revision level
+# - Unit serial number (if present)
+# We also specify "incominguser".
+
+<target iqn.2008-09.com.example:server.target2>
+ direct-store /dev/sdd
+ incominguser someuser secretpass12
+</target>
+
+
+# An example with multiple LUNs, disabled write-cache (tgtd enables write-cache
+# by default) and vendor identification set to "MyVendor"
+
+<target iqn.2008-09.com.example:server.target3>
+ backing-store /dev/LVM/somedevice1 # Becomes LUN 1
+ backing-store /dev/LVM/somedevice2 # Becomes LUN 2
+ backing-store /dev/LVM/somedevice3 # Becomes LUN 3
+ write-cache off
+ vendor_id MyCompany Inc.
+</target>
+
+
+# Similar to the one above, but we fetch vendor_id, product_id, product_rev and
+# scsi_sn from the disks.
+# Vendor identification (vendor_id) is replaced in all disks by "MyVendor"
+
+<target iqn.2008-09.com.example:server.target4>
+ direct-store /dev/sdb # Becomes LUN 1
+ direct-store /dev/sdc # Becomes LUN 2
+ direct-store /dev/sdd # Becomes LUN 3
+ write-cache off
+ vendor_id MyCompany Inc.
+</target>
+
+
+# Note that "first-device-first-lun numbering" will work only for simple
+# scenarios above, where _only_ direct-store _or_ backing-store is used.
+# If you mix backing-store and direct-store, then all backing-store entries
+# are processed before direct-store-entries.
+
+<target iqn.2008-09.com.example:server.target4>
+ direct-store /dev/sdb # Becomes LUN 3
+ backing-store /dev/sdc # Becomes LUN 1
+ direct-store /dev/sdd # Becomes LUN 4
+ backing-store /dev/sde # Becomes LUN 2
+</target>
+
+
+# Even more complicated example - each device has different parameters.
+# You can use indentation to make the config file more readable.
+# Note that LUNs will be assigned more or less randomly here (and still
+# backing-store get LUNs assigned before drect-store).
+# You can specify multiple mode_page parameters (they are commented out
+# in this example).
+# Note that some parameters (write-cache, scsi_sn) were specified "globally".
+# "Global" parameters will be applied to all LUNs; they can be overwritten
+# "locally", per LUN.
+# If lun is not specified, it will be allocated automatically (first available).
+
+<target iqn.2008-09.com.example:server.target5>
+
+ <direct-store /dev/sdd>
+ vendor_id VENDOR1
+ removable 1
+ device-type cd
+ lun 1
+ </direct-store>
+
+ <direct-store /dev/sda>
+ vendor_id VENDOR2
+ lun 2
+ </direct-store>
+
+ <backing-store /dev/sdb1>
+ vendor_id back1
+ scsi_sn SERIAL
+ write-cache on
+ # lun 3 # lun is commented out - will be allocated automatically
+ </backing-store>
+
+ <backing-store /dev/sdd1>
+ vendor_id back2
+ #mode_page 8:0:18:0x10:0:0xff....
+ #mode_page 8:0:18:0x10:0:0xff....
+ #bs-type aio
+ #params element_type=4,start_address=500,quantity=3,media_home=/root/tapes
+ #params element_type=4,address=500,tid=1,lun=1
+ lun 15
+ </backing-store>
+
+ # Some more parameters which can be specified locally or globally:
+ #scsi_id ...
+ #scsi_sn ...
+ #vendor_id ...
+ #product_id ...
+ #product_rev ...
+ #sense_format ...
+ #removable ...
+ #online ...
+ #path ...
+ #mode_page 8:0:18:0x10:0:0xff....
+ #mode_page 8:0:18:0x10:0:0xff....
+ #device-type ...
+ #bs-type ... # backing store type - default rdwr, can be aio, mmap, etc...
+ #params element_type=4,start_address=500,quantity=3,media_home=/root/tapes
+ #params element_type=4,address=500,tid=1,lun=1
+ #allow-in-use yes # if specified globally, can't be overwritten locally
+
+ write-cache off
+ scsi_sn multipath-10
+
+ # Parameters below are only global. They can't be configured per LUN.
+ # Only allow connections from 192.168.100.1 and 192.168.200.5
+ initiator-address 192.168.100.1
+ initiator-address 192.168.200.5
+
+ # Tuning parameters (global, per target)
+ #MaxRecvDataSegmentLength 8192
+ #MaxXmitDataSegmentLength 8192
+ #HeaderDigest None
+ #DataDigest None
+ #InitialR2T Yes
+ #MaxOutstandingR2T 1
+ #ImmediateData Yes
+ #FirstBurstLength 65536
+ #MaxBurstLength 262144
+ #DataPDUInOrder Yes
+ #DataSequenceInOrder Yes
+ #ErrorRecoveryLevel 0
+ #IFMarker No
+ #OFMarker No
+ #DefaultTime2Wait 2
+ #DefaultTime2Retain 20
+ #OFMarkInt Reject
+ #IFMarkInt Reject
+ #MaxConnections 1
+
+ # Allowed incoming users
+ incominguser user1 secretpass12
+ incominguser user2 secretpass23
+
+ # Outgoing user
+ outgoinguser userA secretpassA
+
+</target>
+
+
+# The device will have lun 1 unless you specify something else
+<target iqn.2008-09.com.example:server.target6>
+ backing-store /dev/LVM/somedevice
+ lun 10
+</target>
+
+
+# Devices which are in use (by system: mounted, for swap, part of RAID, or by
+# userspace: dd, by tgtd for another target etc.) can't be used, unless you use
+# --force flag or add 'allow-in-use yes' option
+<target iqn.2008-09.com.example:server.target7>
+ backing-store /dev/LVM/somedevice
+ allow-in-use yes
+</target>
+
+<target iqn.2008-09.com.example:server.target8>
+ <backing-store /dev/LVM/somedevice>
+ scsi_sn serial1
+ </backing-store>
+
+ <backing-store /dev/LVM/somedevice2>
+ scsi_sn serial2
+ </backing-store>
+
+ allow-in-use yes
+</target>
+
+
+
+
+
+# Not supported configurations, and therefore, commented out:
+
+#<target iqn.2008-09.com.example:server.target9>
+# backing-store /dev/LVM/somedevice1
+# backing-store /dev/LVM/somedevice2
+# lun 10
+# lun 11
+#</target>
+
+#<target iqn.2008-09.com.example:server.target10>
+# <direct-store /dev/sdd>
+# vendor_id VENDOR1
+# </direct-store>
+#
+# direct-store /dev/sdc
+#</target>
+
+# This one will break the parser:
+
+#<target iqn.2008-09.com.example:server.target11>
+# <direct-store /dev/sdd>
+# vendor_id VENDOR1
+# </direct-store>
+#
+# direct-store /dev/sdc
+#
+# <direct-store /dev/sdd>
+# vendor_id VENDOR1
+# </direct-store>
+#</target>
diff --git a/doc/Makefile b/doc/Makefile
index 4b22e0a..f7cdfd3 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -4,8 +4,7 @@ docdir ?= $(PREFIX)/share/doc/tgt
MANPAGES = manpages/tgtadm.8 manpages/tgt-admin.8 \
manpages/tgt-setup-lun.8
DOCS = README.fcoe README.ibmvstgt README.iscsi README.iser \
- README.lu_configuration README.mmc targets.conf.example \
- tmf.txt TODO
+ README.lu_configuration README.mmc tmf.txt
.PHONY:all
all:
diff --git a/doc/targets.conf.example b/doc/targets.conf.example
deleted file mode 100644
index 2f8020a..0000000
--- a/doc/targets.conf.example
+++ /dev/null
@@ -1,239 +0,0 @@
-# This is a sample config file for tgt-admin.
-# By default, tgt-admin looks for its config file in /etc/tgt/targets.conf
-
-# This one includes other config files:
-
-include /etc/tgt/temp/*.conf
-
-
-# Set the driver. If not specified, defaults to "iscsi".
-
-default-driver iscsi
-
-
-# Continue if tgtadm exits with non-zero code (equivalent of
-# --ignore-errors command line option)
-#ignore-errors yes
-
-
-# Sample target with one LUN only. Defaults to allow access for all initiators:
-
-<target iqn.2008-09.com.example:server.target1>
- backing-store /dev/LVM/somedevice
-</target>
-
-
-# Similar, but we use "direct-store" instead of "backing-store".
-# "direct-store" reads drive parameters with sg_inq command and sets them to
-# the target.
-# Parameters fatched with sg_inq are:
-# - Vendor identification
-# - Product identification
-# - Product revision level
-# - Unit serial number (if present)
-# We also specify "incominguser".
-
-<target iqn.2008-09.com.example:server.target2>
- direct-store /dev/sdd
- incominguser someuser secretpass12
-</target>
-
-
-# An example with multiple LUNs, disabled write-cache (tgtd enables write-cache
-# by default) and vendor identification set to "MyVendor"
-
-<target iqn.2008-09.com.example:server.target3>
- backing-store /dev/LVM/somedevice1 # Becomes LUN 1
- backing-store /dev/LVM/somedevice2 # Becomes LUN 2
- backing-store /dev/LVM/somedevice3 # Becomes LUN 3
- write-cache off
- vendor_id MyCompany Inc.
-</target>
-
-
-# Similar to the one above, but we fetch vendor_id, product_id, product_rev and
-# scsi_sn from the disks.
-# Vendor identification (vendor_id) is replaced in all disks by "MyVendor"
-
-<target iqn.2008-09.com.example:server.target4>
- direct-store /dev/sdb # Becomes LUN 1
- direct-store /dev/sdc # Becomes LUN 2
- direct-store /dev/sdd # Becomes LUN 3
- write-cache off
- vendor_id MyCompany Inc.
-</target>
-
-
-# Note that "first-device-first-lun numbering" will work only for simple
-# scenarios above, where _only_ direct-store _or_ backing-store is used.
-# If you mix backing-store and direct-store, then all backing-store entries
-# are processed before direct-store-entries.
-
-<target iqn.2008-09.com.example:server.target4>
- direct-store /dev/sdb # Becomes LUN 3
- backing-store /dev/sdc # Becomes LUN 1
- direct-store /dev/sdd # Becomes LUN 4
- backing-store /dev/sde # Becomes LUN 2
-</target>
-
-
-# Even more complicated example - each device has different parameters.
-# You can use indentation to make the config file more readable.
-# Note that LUNs will be assigned more or less randomly here (and still
-# backing-store get LUNs assigned before drect-store).
-# You can specify multiple mode_page parameters (they are commented out
-# in this example).
-# Note that some parameters (write-cache, scsi_sn) were specified "globally".
-# "Global" parameters will be applied to all LUNs; they can be overwritten
-# "locally", per LUN.
-# If lun is not specified, it will be allocated automatically (first available).
-
-<target iqn.2008-09.com.example:server.target5>
-
- <direct-store /dev/sdd>
- vendor_id VENDOR1
- removable 1
- device-type cd
- lun 1
- </direct-store>
-
- <direct-store /dev/sda>
- vendor_id VENDOR2
- lun 2
- </direct-store>
-
- <backing-store /dev/sdb1>
- vendor_id back1
- scsi_sn SERIAL
- write-cache on
- # lun 3 # lun is commented out - will be allocated automatically
- </backing-store>
-
- <backing-store /dev/sdd1>
- vendor_id back2
- #mode_page 8:0:18:0x10:0:0xff....
- #mode_page 8:0:18:0x10:0:0xff....
- #bs-type aio
- #params element_type=4,start_address=500,quantity=3,media_home=/root/tapes
- #params element_type=4,address=500,tid=1,lun=1
- lun 15
- </backing-store>
-
- # Some more parameters which can be specified locally or globally:
- #scsi_id ...
- #scsi_sn ...
- #vendor_id ...
- #product_id ...
- #product_rev ...
- #sense_format ...
- #removable ...
- #online ...
- #path ...
- #mode_page 8:0:18:0x10:0:0xff....
- #mode_page 8:0:18:0x10:0:0xff....
- #device-type ...
- #bs-type ... # backing store type - default rdwr, can be aio, mmap, etc...
- #params element_type=4,start_address=500,quantity=3,media_home=/root/tapes
- #params element_type=4,address=500,tid=1,lun=1
- #allow-in-use yes # if specified globally, can't be overwritten locally
-
- write-cache off
- scsi_sn multipath-10
-
- # Parameters below are only global. They can't be configured per LUN.
- # Only allow connections from 192.168.100.1 and 192.168.200.5
- initiator-address 192.168.100.1
- initiator-address 192.168.200.5
-
- # Tuning parameters (global, per target)
- #MaxRecvDataSegmentLength 8192
- #MaxXmitDataSegmentLength 8192
- #HeaderDigest None
- #DataDigest None
- #InitialR2T Yes
- #MaxOutstandingR2T 1
- #ImmediateData Yes
- #FirstBurstLength 65536
- #MaxBurstLength 262144
- #DataPDUInOrder Yes
- #DataSequenceInOrder Yes
- #ErrorRecoveryLevel 0
- #IFMarker No
- #OFMarker No
- #DefaultTime2Wait 2
- #DefaultTime2Retain 20
- #OFMarkInt Reject
- #IFMarkInt Reject
- #MaxConnections 1
-
- # Allowed incoming users
- incominguser user1 secretpass12
- incominguser user2 secretpass23
-
- # Outgoing user
- outgoinguser userA secretpassA
-
-</target>
-
-
-# The device will have lun 1 unless you specify something else
-<target iqn.2008-09.com.example:server.target6>
- backing-store /dev/LVM/somedevice
- lun 10
-</target>
-
-
-# Devices which are in use (by system: mounted, for swap, part of RAID, or by
-# userspace: dd, by tgtd for another target etc.) can't be used, unless you use
-# --force flag or add 'allow-in-use yes' option
-<target iqn.2008-09.com.example:server.target7>
- backing-store /dev/LVM/somedevice
- allow-in-use yes
-</target>
-
-<target iqn.2008-09.com.example:server.target8>
- <backing-store /dev/LVM/somedevice>
- scsi_sn serial1
- </backing-store>
-
- <backing-store /dev/LVM/somedevice2>
- scsi_sn serial2
- </backing-store>
-
- allow-in-use yes
-</target>
-
-
-
-
-
-# Not supported configurations, and therefore, commented out:
-
-#<target iqn.2008-09.com.example:server.target9>
-# backing-store /dev/LVM/somedevice1
-# backing-store /dev/LVM/somedevice2
-# lun 10
-# lun 11
-#</target>
-
-#<target iqn.2008-09.com.example:server.target10>
-# <direct-store /dev/sdd>
-# vendor_id VENDOR1
-# </direct-store>
-#
-# direct-store /dev/sdc
-#</target>
-
-# This one will break the parser:
-
-#<target iqn.2008-09.com.example:server.target11>
-# <direct-store /dev/sdd>
-# vendor_id VENDOR1
-# </direct-store>
-#
-# direct-store /dev/sdc
-#
-# <direct-store /dev/sdd>
-# vendor_id VENDOR1
-# </direct-store>
-#</target>
--
1.5.6.5
--
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