====== SAN filename setting ======

===== Name =====

    san-filename

===== Details =====

^ Type                | [[:cfgtype:string|String]]            |
^ DHCP option number  | 175.188                               |
^ ISC dhcpd syntax    | ''option ipxe.san-filename''          |

===== Examples =====

=== Configure the iSCSI initiator name in ISC dhcpd ===

    # in /etc/dhcpd.conf
    option space ipxe;
    option ipxe-encap-opts code 175 = encapsulate ipxe;
    option ipxe.san-filename code 188 = string;
    
    option ipxe.san-filename "\\efi\\redhat\\grub.efi"

===== Description =====

Specifies the filename for the bootloader within a SAN target.

If no SAN filename is explicitly specified, then iPXE will use the appropriate default filename for the platform.  For example, on an x86_64 UEFI platform, the default filename will be ''\EFI\BOOT\BOOTX64.EFI''.

===== See also =====

  * ''[[:cmd:sanboot]]'' command
  * [[:cfg|List of all iPXE settings]]

===== Notes =====

Some older operating systems (e.g. RHEL6) will install the bootloader with a non-default filename.  You can use either the ''san-filename'' setting (or the ''[[:cmd:sanboot]] %%--filename%%'' option) to specify the correct bootloader filename.  For example:

    option ipxe.san-filename "\\efi\\redhat\\grub.efi"
    option root-path "iscsi:192.168.0.1::::iqn.2010-04.org.ipxe.demo:rhel6";