iSCSI initiator name setting

Name

  initiator-iqn

Details

Type String
DHCP option number 203
ISC dhcpd syntax option iscsi-initiator-iqn

Examples

Set the iSCSI initiator name manually

  iPXE> set initiator-iqn iqn.2010-04.org.ipxe:client123

Set the iSCSI initiator name based on the MAC address

  iPXE> set initiator-iqn iqn.2010-04.org.ipxe:${mac:hexhyp}

Configure the iSCSI initiator name in ISC dhcpd

  # in /etc/dhcpd.conf
  option iscsi-initiator-iqn "iqn.2010-04.org.ipxe:client123"

Description

Specifies the iSCSI initiator name used when connecting to an iSCSI target.

If no iSCSI initiator name is explicitly specified, then iPXE will construct a default iSCSI initiator name based upon the hostname (if a hostname exists) or the uuid. For example, if the hostname is set to client.example.com, then the default iSCSI initiator name will be

  iqn.2010-04.org.ipxe:client.example.com

and if no hostname is defined, then the default iSCSI initiator will be constructed from the system uuid:

  iqn.2010-04.org.ipxe:7e10b6af-344b-41d7-802e-24f0e68a174d

See also

Notes

The iSCSI initiator name is often used within access control lists (ACLs) on iSCSI targets. You may wish to specify an explicit iSCSI initiator name to make your access control lists more manageable.

If you are using ISC dhcpd as your DHCP server, then you may need to add the line

  option iscsi-initiator-iqn code 203 = string;

to the start of your /etc/dhcpd.conf file.

 
cfg/initiator-iqn.txt · Last modified: 2011/03/24 13:59 by mcb30
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
All uses of this content must include an attribution to the iPXE project and the URL http://ipxe.org
References to "iPXE" may not be altered or removed.