DragonFly On-Line Manual Pages

Search: Section:  

ISCSI.CONF(5)            DragonFly File Formats Manual           ISCSI.CONF(5)


NAME

     iscsi.conf -- key options to be negotiated in an iSCSI session


DESCRIPTION

     The file iscsi.conf, is read by the iscontrol(8) program.  It contains
     declarations and parameter/key-options.  The syntax is very simple,
           variable = value;
     and they can be grouped via a block declaration:

             # this is a comment
             target_1 { # nickname
                variable = value;
                ...
             } # this must be on a line by itself.

     The following are specified in the iSCSI RFC 3720, for a full description
     see sections 11/12 of the RFC.

     AuthMethod      currently only supported authentication method is CHAP,
                     with digest either MD5 or SHA.  Default is none.

     HeaderDigest    a digest is calculated on the header of all iSCSI PDUs,
                     and checked.  Only CRC32C is implemented.  Default is
                     none.

     DataDigest      same as for HeaderDigest, but on the data part of the
                     iSCSI PDU.

     MaxConnections  is the number of simultaneous connections per session,
                     currently only 1.

     TargetName      is the name by which the target is known, not to be con-
                     fused with target address, either obtained via the target
                     administrator, or from a discovery session.

     InitiatorName   if not specified, defaults to iqn.2005-01.il.ac.huji.cs:
                     <hostname>.

     TargetAlias / InitiatorAlias
                     not implemented.

     TargetAddress   is of the form domainname[:port][,portal-group-tag] to
                     quote the RFC:
                     The domainname can be specified as either a DNS host
                     name, a dotted-decimal IPv4 address, or a bracketed IPv6
                     address as specified in RFC 2732.
                     Note: portal-group-tag is unused at the moment.

     TargetPortalGroupTag
                     not implemented yet.

     InitialR2T      not implemented yet.

     ImmediateData   not implemented yet.

     MaxRecvDataSegmentLength
                     the maximum data segment length in bytes it can receive
                     in an iSCSI PDU, default is 8192.

     MaxBurstLength  not implemented yet.

     FirstBurstLength
                     not implemented yet.

     DefaultTime2Wait
                     not implemented yet.

     DefaultTime2Retain
                     not implemented yet.

     MaxOutstandingR2T
                     is used to calculate/negotiate the tag opening, can be
                     overridden by the tag option.

     DataPDUInOrder  not implemented yet.

     DataSequenceInOrder
                     not implemented yet.

     ErrorRecoveryLevel
                     Only level 0 is supported.

     SessionType     either Discovery or Normal, default is Normal, see the -d
                     flag of iscontrol.

     The following are not specified in the RFC 3720

     port         The iSCSI port used by the iSCSI protocol, defaults to 3260.

     tags         Sets the tag opening to the value specified.

     maxluns      overrides the compiled value of luns, see
                  iscsi_initiator(4).  This value can only be reduced.

     sockbufsize  sets the receiver and transmitter socket buffer size to
                  size, in kilobytes.  The default is 128.

     If AuthMethod is set to CHAP, then the following must also be set:

     chapSecret  this shared-secret.  Can be either an ASCII string (e.g.
                 hello world), a hex string (e.g 0xababcd0987654321...), or
                 base64 string (eg 0b...)

     chapIName   the chap-name, defaults to hostname.

     chapDigest  can be MD5 or SHA1.

     tgtChapSecret/tgtChapName
                 same as the none tgt counterpart, but to authenticate the
                 target.


FILES

     /etc/iscsi.conf


EXAMPLES

     #
     # Globals
     #
     port = 3260
     #
     myiscsi { # nickname
        targetaddress        = iscsi1
        targetname           = iqn.1900.com.com:sn.123456
     }
     chaptest {
        targetaddress= 10.0.0.1;
        targetname   = iqn.1900.com.com:sn.123456
        initiatorname= iqn.2005-01.il.ac.huji.cs:nobody
        authmethod = CHAP; chapDigest = SHA1;
        chapsecret = 0x3713c3336d9a224c2791c873d3d2b174
        tags         = 256
     }


SEE ALSO

     iscsi_initiator(4), iscontrol(8)


STANDARDS

     ISCSI RFC 3720


BUGS

     Some options have not been implemented, either they were found to be
     unnecessary, or not understood, this can change in the future.

     The tags opening value is difficult to calculate, use wisely.

     The parsing is very primitive, so do not expect - at the moment - any
     error messages.

DragonFly 3.5                   August 24, 2009                  DragonFly 3.5

Search: Section: