Annotation of embedaddon/istgt/etc/istgt.large.conf.in, revision 1.1.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>