Annotation of embedaddon/istgt/etc/istgt.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 %%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>