Annotation of embedaddon/istgt/etc/istgt.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 %%MEDIADIR%%
                     29: 
                     30:   # syslog facility
                     31:   LogFacility "local7"
                     32: 
                     33:   # socket I/O timeout sec. (polling is infinity)
                     34:   Timeout 30
                     35:   # NOPIN sending interval sec.
                     36:   NopInInterval 20
                     37: 
                     38:   # authentication information for discovery session
                     39:   DiscoveryAuthMethod Auto
                     40:   #DiscoveryAuthGroup AuthGroup9999
                     41: 
                     42:   # reserved maximum connections and sessions
                     43:   # NOTE: iSCSI boot is 2 or more sessions required
                     44:   MaxSessions 16
                     45:   MaxConnections 4
                     46: 
                     47:   # maximum number of sending R2T in each connection
                     48:   # actual number is limited to QueueDepth and MaxCmdSN and ExpCmdSN
                     49:   # 0=disabled, 1-256=improves large writing
                     50:   MaxR2T 32
                     51: 
                     52:   # iSCSI initial parameters negotiate with initiators
                     53:   # NOTE: incorrect values might crash
                     54:   MaxOutstandingR2T 16
                     55:   DefaultTime2Wait 2
                     56:   DefaultTime2Retain 60
                     57:   FirstBurstLength 262144
                     58:   MaxBurstLength 1048576
                     59:   MaxRecvDataSegmentLength 262144
                     60: 
                     61:   # NOTE: not supported
                     62:   InitialR2T Yes
                     63:   ImmediateData Yes
                     64:   DataPDUInOrder Yes
                     65:   DataSequenceInOrder Yes
                     66:   ErrorRecoveryLevel 0
                     67: 
                     68: [UnitControl]
                     69:   Comment "Internal Logical Unit Controller"
                     70:   #AuthMethod Auto
                     71:   AuthMethod CHAP Mutual
                     72:   AuthGroup AuthGroup10000
                     73:   # this portal is only used as controller (by istgtcontrol)
                     74:   # if it's not necessary, no portal is valid
                     75:   #Portal UC1 [::1]:3261
                     76:   Portal UC1 127.0.0.1:3261
                     77:   # accept IP netmask
                     78:   #Netmask [::1]
                     79:   Netmask 127.0.0.1
                     80: 
                     81: # You should set IPs in /etc/rc.conf for physical I/F
                     82: [PortalGroup1]
                     83:   Comment "SINGLE PORT TEST"
                     84:   # Portal Label(not used) IP(IPv6 or IPv4):Port
                     85:   #Portal DA1 [2001:03e0:06cf:0003:021b:21ff:fe04:f405]:3260
                     86:   Portal DA1 192.168.2.36:3260
                     87: 
                     88: # wildcard address you may need if use DHCP
                     89: # DO NOT USE WITH OTHER PORTALS
                     90: #[PortalGroup1]
                     91: #  Comment "ANY IP"
                     92: #  # Portal Label(not used) IP(IPv6 or IPv4):Port
                     93: #  #Portal DA1 [::]:3260
                     94: #  Portal DA1 0.0.0.0:3260
                     95: 
                     96: [InitiatorGroup1]
                     97:   Comment "Initiator Group1"
                     98:   # name with ! deny login/discovery
                     99:   #InitiatorName "!iqn.1991-05.com.microsoft:moon"
                    100:   # spetified name allow login/discovery
                    101:   #InitiatorName "iqn.1991-05.com.microsoft:saturn"
                    102:   # special word "ALL" match all of initiators
                    103:   InitiatorName "ALL"
                    104:   Netmask 192.168.2.0/24
                    105: 
                    106: # TargetName, Mapping, UnitType, LUN0 are minimum required
                    107: [LogicalUnit1]
                    108:   Comment "Hard Disk Sample"
                    109:   # full specified iqn (same as below)
                    110:   #TargetName iqn.2007-09.jp.ne.peach.istgt:disk1
                    111:   # short specified non iqn (will add NodeBase)
                    112:   TargetName disk1
                    113:   TargetAlias "Data Disk1"
                    114:   # use initiators in tag1 via portals in tag1
                    115:   Mapping PortalGroup1 InitiatorGroup1
                    116:   # accept both CHAP and None
                    117:   AuthMethod Auto
                    118:   AuthGroup AuthGroup1
                    119:   #UseDigest Header Data
                    120:   UseDigest Auto
                    121:   UnitType Disk
                    122:   # SCSI INQUIRY - Vendor(8) Product(16) Revision(4) Serial(16)
                    123:   #UnitInquiry "FreeBSD" "iSCSI Disk" "0123" "10000001"
                    124:   # Queuing 0=disabled, 1-255=enabled with specified depth.
                    125:   #QueueDepth 32
                    126: 
                    127:   # override global setting if need
                    128:   #MaxOutstandingR2T 16
                    129:   #DefaultTime2Wait 2
                    130:   #DefaultTime2Retain 60
                    131:   #FirstBurstLength 262144
                    132:   #MaxBurstLength 1048576
                    133:   #MaxRecvDataSegmentLength 262144
                    134:   #InitialR2T Yes
                    135:   #ImmediateData Yes
                    136:   #DataPDUInOrder Yes
                    137:   #DataSequenceInOrder Yes
                    138:   #ErrorRecoveryLevel 0
                    139: 
                    140:   # LogicalVolume for this unit on LUN0
                    141:   # for file extent
                    142:   LUN0 Storage /tank/iscsi/istgt-disk1 10GB
                    143:   # for raw device extent
                    144:   #LUN0 Storage /dev/ad4 Auto
                    145:   # for ZFS volume extent
                    146:   #LUN0 Storage /dev/zvol/tank/istgt-vol1 Auto
                    147: 
                    148:   # override the serial of LUN0 specified with UnitInquiry
                    149:   #LUN0 Option Serial "10000001"
                    150: 
                    151:   # for 3.5inch, 7200rpm HDD
                    152:   # RPM 0=not reported, 1=non-rotating(SSD), n>1024 rpm
                    153:   #LUN0 Option RPM 7200
                    154:   # FormFactor 0=not reported, 1=5.25, 2=3.5, 3=2.5, 4=1.8, 5=less 1.8 inch
                    155:   #LUN0 Option FormFactor 2
                    156: 
                    157:   # for 2.5inch, SSD
                    158:   #LUN0 Option RPM 1
                    159:   #LUN0 Option FormFactor 3
                    160: 
                    161:   # for future use (enabled by default)
                    162:   #LUN0 Option ReadCache Disable
                    163:   #LUN0 Option WriteCache Disable
                    164: 
                    165: #[LogicalUnit2]
                    166: #  # SCSI commands pass through to SCSI device by CAM
                    167: #  Comment "Pass-through Disk Sample"
                    168: #  TargetName pass-disk1
                    169: #  TargetAlias "Pass Through Disk1"
                    170: #  Mapping PortalGroup1 InitiatorGroup1
                    171: #  AuthMethod Auto
                    172: #  AuthGroup AuthGroup1
                    173: #  UnitType Pass
                    174: #  # DO NOT SPECIFY PARTITION, PASS-THROUGH USE ENTIRE LOGICAL UNIT
                    175: #  LUN0 Device /dev/da0

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