Annotation of embedaddon/istgt/etc/istgt.large.conf.in, revision 1.1

1.1     ! misho       1: # istgt configuration file
        !             2: #
        !             3: # Please do not write parameters excluding ASCII.
        !             4: # The parameter must be quoted if space or separator include.
        !             5: #
        !             6: # configuration syntax:
        !             7: # spaces at head of line are deleted, other spaces are as separator
        !             8: # starting with '#' is comment line, not evaluate
        !             9: # ending with '\' is concatenating next line
        !            10: # bracket key is section key grouping following keys
        !            11: # group number of section key is used as tag number
        !            12: # (group number might not be continuous value)
        !            13: # 1st string is key may appear multiple times
        !            14: # 2nd and more are value associated the key
        !            15: # Comment key is placed for human readable like user interface
        !            16: #
        !            17: [Global]
        !            18:   Comment "Global section"
        !            19:   # node name (not include optional part)
        !            20:   NodeBase "iqn.2007-09.jp.ne.peach.istgt"
        !            21: 
        !            22:   # files
        !            23:   PidFile /var/run/istgt.pid
        !            24:   AuthFile %%CONFIGDIR%%/auth.conf
        !            25: 
        !            26:   # directories
        !            27:   # for removable media (virtual DVD/virtual Tape)
        !            28:   #MediaDirectory /mnt
        !            29:   MediaDirectory %%MEDIADIR%%
        !            30:   #MediaDirectory /tank/iscsi
        !            31: 
        !            32:   # syslog facility
        !            33:   LogFacility "local7"
        !            34: 
        !            35:   # socket I/O timeout sec. (polling is infinity)
        !            36:   Timeout 30
        !            37:   # NOPIN sending interval sec.
        !            38:   NopInInterval 20
        !            39: 
        !            40:   # authentication information for discovery session
        !            41:   DiscoveryAuthMethod Auto
        !            42:   #DiscoveryAuthMethod CHAP
        !            43:   #DiscoveryAuthGroup AuthGroup9999
        !            44: 
        !            45:   # reserved maximum connections and sessions
        !            46:   # NOTE: iSCSI boot is 2 or more sessions required
        !            47:   MaxSessions 16
        !            48:   MaxConnections 4
        !            49: 
        !            50:   # maximum number of sending R2T in each connection
        !            51:   # actual number is limited to QueueDepth and MaxCmdSN and ExpCmdSN
        !            52:   # 0=disabled, 1-256=improves large writing
        !            53:   MaxR2T 32
        !            54: 
        !            55:   # iSCSI initial parameters negotiate with initiators
        !            56:   # NOTE: incorrect values might crash
        !            57:   MaxOutstandingR2T 16
        !            58:   DefaultTime2Wait 2
        !            59:   DefaultTime2Retain 60
        !            60:   FirstBurstLength 262144
        !            61:   MaxBurstLength 1048576
        !            62:   MaxRecvDataSegmentLength 262144
        !            63: 
        !            64:   # NOTE: not supported
        !            65:   InitialR2T Yes
        !            66:   ImmediateData Yes
        !            67:   DataPDUInOrder Yes
        !            68:   DataSequenceInOrder Yes
        !            69:   ErrorRecoveryLevel 0
        !            70: 
        !            71: [UnitControl]
        !            72:   Comment "Internal Logical Unit Controller"
        !            73:   #AuthMethod Auto
        !            74:   AuthMethod CHAP Mutual
        !            75:   AuthGroup AuthGroup10000
        !            76:   # this portal is only used as controller (by istgtcontrol)
        !            77:   # if it's not necessary, no portal is valid
        !            78:   #Portal UC1 [::1]:3261
        !            79:   Portal UC1 127.0.0.1:3261
        !            80:   #Portal UC1 192.168.2.36:3261
        !            81:   # accept IP netmask
        !            82:   #Netmask [::1]
        !            83:   Netmask 127.0.0.1
        !            84:   #Netmask 192.168.2.0/24
        !            85:   #Netmask 192.168.2.36/32
        !            86: 
        !            87: # You should set IPs in /etc/rc.conf for physical I/F
        !            88: [PortalGroup1]
        !            89:   Comment "DUAL CONTROLLER TEST"
        !            90:   # Portal Label(not used) IP(IPv6 or IPv4):Port
        !            91:   Portal DA1 192.168.3.36:3260
        !            92:   Portal DA2 192.168.4.36:3260
        !            93:   Portal DB1 192.168.3.37:3260
        !            94:   Portal DB2 192.168.4.37:3260
        !            95: 
        !            96: [PortalGroup2]
        !            97:   Comment "IPv6 TEST"
        !            98:   Portal DA1 [2001:03e0:06cf:0003:021b:21ff:fe04:f405]:3260
        !            99:   Portal DA2 [2001:03e0:06cf:0004:021f:d0ff:fe16:38bd]:3260
        !           100:   #Portal DA3 [2001:380:e00:5:203:47ff:fe72:34f2]:3260
        !           101: 
        !           102: [PortalGroup3]
        !           103:   Comment "SINGLE PORT TEST"
        !           104:   Portal DA1 192.168.2.36:3260
        !           105: 
        !           106: [PortalGroup10]
        !           107:   Comment "SINGLE PORT TEST"
        !           108:   Portal DA1 192.168.2.37:3260
        !           109: 
        !           110: # wildcard address you may need if use DHCP
        !           111: # DO NOT USE WITH OTHER PORTALS
        !           112: #[PortalGroup4]
        !           113: #  Comment "ANY IP"
        !           114: #  #Portal DA1 [::]:3260
        !           115: #  Portal DA1 0.0.0.0:3260
        !           116: 
        !           117: [InitiatorGroup1]
        !           118:   # initiator group1
        !           119:   Comment "Initiator Group1"
        !           120:   InitiatorName "iqn.1991-05.com.microsoft:ceres"
        !           121:   InitiatorName "iqn.1991-05.com.microsoft:saturn"
        !           122:   Netmask 192.168.3.0/24
        !           123:   Netmask 192.168.4.0/24
        !           124: 
        !           125: [InitiatorGroup2]
        !           126:   # initiator group2
        !           127:   Comment "Initiator Group2"
        !           128:   InitiatorName "iqn.1991-05.com.microsoft:athena"
        !           129:   InitiatorName "iqn.1991-05.com.microsoft:venus"
        !           130:   InitiatorName "iqn.1991-05.com.microsoft:saturn"
        !           131:   Netmask [2001:3e0:6cf:2::]/64
        !           132:   Netmask [2001:380:e00:5::]/64
        !           133: 
        !           134: [InitiatorGroup3]
        !           135:   InitiatorName "iqn.1991-05.com.microsoft:saturn"
        !           136:   Netmask 192.168.2.0/24
        !           137: 
        !           138: [InitiatorGroup4]
        !           139:   Comment "ALL initiators from 192.168.2.0/24"
        !           140:   # name with ! deny login/discovery
        !           141:   #InitiatorName "!iqn.1991-05.com.microsoft:moon"
        !           142:   # spetified name allow login/discovery
        !           143:   #InitiatorName "iqn.1991-05.com.microsoft:saturn"
        !           144:   # special word "ALL" match all of initiators
        !           145:   InitiatorName ALL
        !           146:   Netmask 192.168.2.0/24
        !           147: 
        !           148: [InitiatorGroup5]
        !           149:   Comment "Initiator Group5"
        !           150:   InitiatorName "iqn.2007-09.jp.ne.peach:pluto"
        !           151:   Netmask 192.168.2.0/24
        !           152:   Netmask 192.168.3.0/24
        !           153:   Netmask 192.168.4.0/24
        !           154:   Netmask [2001:3e0:6cf:2::]/64
        !           155:   Netmask [2001:380:e00:5::]/64
        !           156: 
        !           157: [InitiatorGroup6]
        !           158:   InitiatorName "iqn.2008-04.com.sun.virtualbox.initiator"
        !           159:   Netmask 192.168.2.0/24
        !           160: 
        !           161: [InitiatorGroup256]
        !           162:   Comment "ALL initiators from ALL IP"
        !           163:   InitiatorName ALL
        !           164:   Netmask ALL
        !           165: 
        !           166: # TargetName, Mapping, UnitType, LUN0 are minimum required
        !           167: [LogicalUnit1]
        !           168:   Comment "Hard Disk Sample"
        !           169:   # full specified iqn (same as below)
        !           170:   #TargetName iqn.2007-09.jp.ne.peach.istgt:disk1
        !           171:   # short specified non iqn (will add NodeBase)
        !           172:   TargetName disk1
        !           173:   TargetAlias "Data Disk1"
        !           174:   # use both portal group tag1 and tag3 for initiator tag1
        !           175:   Mapping PortalGroup3 InitiatorGroup1
        !           176:   Mapping PortalGroup1 InitiatorGroup1
        !           177:   #Mapping PortalGroup2 InitiatorGroup2
        !           178:   #AuthMethod CHAP Mutual
        !           179:   AuthMethod CHAP
        !           180:   #AuthMethod Auto
        !           181:   AuthGroup AuthGroup1
        !           182:   # force use digest Header/Data/Auto
        !           183:   UseDigest Header Data
        !           184:   #UseDigest Header
        !           185:   #UseDigest Data
        !           186:   #UseDigest Auto
        !           187:   ReadOnly No
        !           188:   UnitType Disk
        !           189:   UnitOnline Yes
        !           190:   # SCSI INQUIRY - Vendor(8) Product(16) Revision(4) Serial(16)
        !           191:   #UnitInquiry "FreeBSD" "iSCSI Disk" "0123" "10000001"
        !           192:   # one of 512,1024,2048,4096 (default 512 is strongly recommended)
        !           193:   #BlockLength 512
        !           194:   # Queuing 0=disabled, 1-255=enabled with specified depth.
        !           195:   #QueueDepth 32
        !           196: 
        !           197:   # override global setting if need
        !           198:   #MaxOutstandingR2T 16
        !           199:   #DefaultTime2Wait 2
        !           200:   #DefaultTime2Retain 60
        !           201:   #FirstBurstLength 262144
        !           202:   #MaxBurstLength 1048576
        !           203:   #MaxRecvDataSegmentLength 262144
        !           204:   #InitialR2T Yes
        !           205:   #ImmediateData Yes
        !           206:   #DataPDUInOrder Yes
        !           207:   #DataSequenceInOrder Yes
        !           208:   #ErrorRecoveryLevel 0
        !           209: 
        !           210:   # LogicalVolume for this unit on LUN0
        !           211:   # for file extent
        !           212:   LUN0 Storage /tank/iscsi/istgt-disk1 10GB
        !           213:   # for raw device extent
        !           214:   #LUN0 Storage /dev/ad4 Auto
        !           215:   # for ZFS volume extent
        !           216:   #LUN0 Storage /dev/zvol/tank/istgt-vol1 Auto
        !           217:   # override the serial of LUN0 specified with UnitInquiry
        !           218:   #LUN0 Option Serial "10000001"
        !           219: 
        !           220:   # for 3.5inch, 7200rpm HDD
        !           221:   # RPM 0=not reported, 1=non-rotating(SSD), n>1024 rpm
        !           222:   LUN0 Option RPM 7200
        !           223:   # FormFactor 0=not reported, 1=5.25, 2=3.5, 3=2.5, 4=1.8, 5=less 1.8 inch
        !           224:   LUN0 Option FormFactor 2
        !           225: 
        !           226:   # for 2.5inch, SSD
        !           227:   #LUN0 Option RPM 1
        !           228:   #LUN0 Option FormFactor 3
        !           229: 
        !           230:   # for future use (enabled by default)
        !           231:   #LUN0 Option ReadCache Disable
        !           232:   #LUN0 Option WriteCache Disable
        !           233: 
        !           234:   #LUN1 Storage /tank/iscsi/istgt-disk1.1 10GB
        !           235:   #LUN1 Option Serial "10000001L1"
        !           236:   LUN2 Storage /tank/iscsi/istgt-disk1.2 10GB
        !           237:   #LUN2 Option Serial "10000001L2"
        !           238: 
        !           239: [LogicalUnit2]
        !           240:   Comment "Hard Disk Sample"
        !           241:   #TargetName disk2
        !           242:   TargetName iqn.1994-04.org.netbsd.iscsi-target:target11
        !           243:   TargetAlias "iSCSI Boot Disk"
        !           244:   # use portal group tag1/2/3 for initiator tag5
        !           245:   Mapping PortalGroup1 InitiatorGroup5
        !           246:   Mapping PortalGroup2 InitiatorGroup5
        !           247:   Mapping PortalGroup3 InitiatorGroup5
        !           248:   AuthMethod Auto
        !           249:   AuthGroup None
        !           250:   #AuthMethod CHAP Mutual
        !           251:   #UseDigest Header Data
        !           252:   UseDigest Auto
        !           253:   ReadOnly No
        !           254:   UnitType Disk
        !           255:   UnitOnline Yes
        !           256:   # you can specify one of '+' or '-' value
        !           257:   LUN0 Storage /tank/iscsi/istgt-disk2 20GB-1MB
        !           258:   # 2PB-1MB is maximum for current windows GUI manager
        !           259:   #LUN1 Storage /tank/iscsi/istgt-disk2.1 2PB-1MB
        !           260:   # probably 8EB is seek limit on FreeBSD
        !           261:   #LUN2 Storage /tank/iscsi/istgt-disk2.2 8EB-1
        !           262: 
        !           263: [LogicalUnit3]
        !           264:   Comment "DVD ROM sample"
        !           265:   TargetName dvd1
        !           266:   #TargetName iqn.1994-04.org.netbsd.iscsi-target:target44
        !           267:   TargetAlias "DVD ROM Drive1"
        !           268:   Mapping PortalGroup3 InitiatorGroup4
        !           269:   AuthMethod Auto
        !           270:   UseDigest Auto
        !           271:   ReadOnly Yes
        !           272:   UnitType DVD
        !           273:   UnitOnline Yes
        !           274:   #UnitInquiry "NetBSD" "iSCSI DVDROM" "0"
        !           275:   #UnitInquiry "FreeBSD" "iSCSI DVDROM" "0001" "10000003"
        !           276:   # auto size is depend on actual file size
        !           277:   LUN0 Removable ro /tank/iscsi/dvds/dvd1.iso auto
        !           278: 
        !           279: [LogicalUnit4]
        !           280:   Comment "DLT sample"
        !           281:   TargetName tape1
        !           282:   TargetAlias "Tape Drive1"
        !           283:   Mapping PortalGroup3 InitiatorGroup4
        !           284:   AuthMethod Auto
        !           285:   UseDigest Auto
        !           286:   ReadOnly No
        !           287:   UnitType Tape
        !           288:   UnitOnline Yes
        !           289:   #UnitInquiry "QUANTUM" "DLT8000" "C001" "CX10000001"
        !           290:   LUN0 Removable "rw" /tank/iscsi/tapes/tape1.vt 1GB
        !           291:   # extend file size if EOM reached
        !           292:   #LUN1 Removable "rw,extend" /tank/iscsi/tapes/tape1.vt 1GB
        !           293:   # file size grow and shrink automatically by EOF (ignore specified size)
        !           294:   #LUN2 Removable "rw,dynamic" /tank/iscsi/tapes/tape1.vt auto
        !           295: 
        !           296: [LogicalUnit10]
        !           297:   Comment "Hard Disk Sample"
        !           298:   TargetName disk3
        !           299:   Mapping PortalGroup3 InitiatorGroup6
        !           300:   UnitType Disk
        !           301:   # currently zvol is slow due to ZIL commit
        !           302:   LUN0 Storage /dev/zvol/tank/istgt-vol1 20GB
        !           303: 
        !           304: [LogicalUnit11]
        !           305:   Comment "Hard Disk Sample"
        !           306:   TargetName disk4
        !           307:   Mapping PortalGroup10 InitiatorGroup5
        !           308:   UnitType Disk
        !           309:   LUN0 Storage /tank/iscsi/istgt-disk4 16GB
        !           310: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>