iSCSI initiator name setting




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


Set the iSCSI initiator name manually

  iPXE> set initiator-iqn

Set the iSCSI initiator name based on the MAC address

  iPXE> set initiator-iqn${mac:hexhyp}

Configure the iSCSI initiator name in ISC dhcpd

  # in /etc/dhcpd.conf
  option iscsi-initiator-iqn ""


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, then the default iSCSI initiator name will be

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

See also


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
References to "iPXE" may not be altered or removed.