Return to istgt.conf.in CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / istgt / etc

20121028

# istgt configuration file
#
# Please do not write parameters excluding ASCII.
# The parameter must be quoted if space or separator include.
#
# The section of PortalGroup, InitiatorGroup and LogicalUnit can be
# reloaded by sending SIGHUP to the istgt process.
#
# configuration syntax:
# spaces at head of line are deleted, other spaces are as separator
# starting with '#' is comment line, not evaluate
# ending with '\' is concatenating next line
# bracket key is section key grouping following keys
# group number of section key is used as tag number
# (group number might not be continuous value)
# 1st string is key may appear multiple times
# 2nd and more are value associated the key
# Comment key is placed for human readable like user interface
#
[Global]
  Comment "Global section"
  # node name (not include optional part)
  NodeBase "iqn.2007-09.jp.ne.peach.istgt"

  # files
  PidFile /var/run/istgt.pid
  AuthFile %%CONFIGDIR%%/auth.conf

  # directories
  # for removable media (virtual DVD/virtual Tape)
  MediaDirectory %%MEDIADIR%%

  # syslog facility
  LogFacility "local7"

  # socket I/O timeout sec. (polling is infinity)
  Timeout 30
  # NOPIN sending interval sec.
  NopInInterval 20

  # authentication information for discovery session
  DiscoveryAuthMethod Auto
  #DiscoveryAuthGroup AuthGroup9999

  # reserved maximum connections and sessions
  # NOTE: iSCSI boot is 2 or more sessions required
  MaxSessions 16
  MaxConnections 4

  # maximum number of sending R2T in each connection
  # actual number is limited to QueueDepth and MaxCmdSN and ExpCmdSN
  # 0=disabled, 1-256=improves large writing
  MaxR2T 32

  # iSCSI initial parameters negotiate with initiators
  # NOTE: incorrect values might crash
  MaxOutstandingR2T 16
  DefaultTime2Wait 2
  DefaultTime2Retain 60
  FirstBurstLength 262144
  MaxBurstLength 1048576
  MaxRecvDataSegmentLength 262144

  # NOTE: not supported
  InitialR2T Yes
  ImmediateData Yes
  DataPDUInOrder Yes
  DataSequenceInOrder Yes
  ErrorRecoveryLevel 0

[UnitControl]
  Comment "Internal Logical Unit Controller"
  #AuthMethod Auto
  AuthMethod CHAP Mutual
  AuthGroup AuthGroup10000
  # this portal is only used as controller (by istgtcontrol)
  # if it's not necessary, no portal is valid
  #Portal UC1 [::1]:3261
  Portal UC1 127.0.0.1:3261
  # accept IP netmask
  #Netmask [::1]
  Netmask 127.0.0.1

# You should set IPs in /etc/rc.conf for physical I/F
[PortalGroup1]
  Comment "SINGLE PORT TEST"
  # Portal Label(not used) IP(IPv6 or IPv4):Port
  #Portal DA1 [2001:03e0:06cf:0003:021b:21ff:fe04:f405]:3260
  Portal DA1 192.168.2.36:3260

# wildcard address you may need if use DHCP
# DO NOT USE WITH OTHER PORTALS
#[PortalGroup1]
#  Comment "ANY IP"
#  # Portal Label(not used) IP(IPv6 or IPv4):Port
#  #Portal DA1 [::]:3260
#  Portal DA1 0.0.0.0:3260

[InitiatorGroup1]
  Comment "Initiator Group1"
  # name with ! deny login/discovery
  #InitiatorName "!iqn.1991-05.com.microsoft:moon"
  # spetified name allow login/discovery
  #InitiatorName "iqn.1991-05.com.microsoft:saturn"
  # special word "ALL" match all of initiators
  InitiatorName "ALL"
  Netmask 192.168.2.0/24

# TargetName, Mapping, UnitType, LUN0 are minimum required
[LogicalUnit1]
  Comment "Hard Disk Sample"
  # full specified iqn (same as below)
  #TargetName iqn.2007-09.jp.ne.peach.istgt:disk1
  # short specified non iqn (will add NodeBase)
  TargetName disk1
  TargetAlias "Data Disk1"
  # use initiators in tag1 via portals in tag1
  Mapping PortalGroup1 InitiatorGroup1
  # accept both CHAP and None
  AuthMethod Auto
  AuthGroup AuthGroup1
  #UseDigest Header Data
  UseDigest Auto
  UnitType Disk
  # SCSI INQUIRY - Vendor(8) Product(16) Revision(4) Serial(16)
  #UnitInquiry "FreeBSD" "iSCSI Disk" "0123" "10000001"
  # Queuing 0=disabled, 1-255=enabled with specified depth.
  #QueueDepth 32

  # override global setting if need
  #MaxOutstandingR2T 16
  #DefaultTime2Wait 2
  #DefaultTime2Retain 60
  #FirstBurstLength 262144
  #MaxBurstLength 1048576
  #MaxRecvDataSegmentLength 262144
  #InitialR2T Yes
  #ImmediateData Yes
  #DataPDUInOrder Yes
  #DataSequenceInOrder Yes
  #ErrorRecoveryLevel 0

  # LogicalVolume for this unit on LUN0
  # for file extent
  LUN0 Storage /tank/iscsi/istgt-disk1 10GB
  # for raw device extent
  #LUN0 Storage /dev/ad4 Auto
  # for ZFS volume extent
  #LUN0 Storage /dev/zvol/tank/istgt-vol1 Auto

  # override the serial of LUN0 specified with UnitInquiry
  #LUN0 Option Serial "10000001"

  # for 3.5inch, 7200rpm HDD
  # RPM 0=not reported, 1=non-rotating(SSD), n>1024 rpm
  #LUN0 Option RPM 7200
  # FormFactor 0=not reported, 1=5.25, 2=3.5, 3=2.5, 4=1.8, 5=less 1.8 inch
  #LUN0 Option FormFactor 2

  # for 2.5inch, SSD
  #LUN0 Option RPM 1
  #LUN0 Option FormFactor 3

  # for future use (enabled by default)
  #LUN0 Option ReadCache Disable

  # control WCE(mode page 8) and O_FSYNC/O_SYNC on the backing store (enabled by default)
  #LUN0 Option WriteCache Disable

#[LogicalUnit2]
#  # SCSI commands pass through to SCSI device by CAM
#  Comment "Pass-through Disk Sample"
#  TargetName pass-disk1
#  TargetAlias "Pass Through Disk1"
#  Mapping PortalGroup1 InitiatorGroup1
#  AuthMethod Auto
#  AuthGroup AuthGroup1
#  UnitType Pass
#  # DO NOT SPECIFY PARTITION, PASS-THROUGH USE ENTIRE LOGICAL UNIT
#  LUN0 Device /dev/da0