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"
Configure the iSCSI initiator name in the Microsoft DHCP server
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.
If you are using the Microsoft DHCP server, then you may need to add a new predefined option via IPv4 → Set Predefined Options → Add:
