Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
cmd:sanboot [2017/03/26 13:35] mcb30 |
cmd:sanboot [2017/04/12 15:26] mcb30 |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| ===== Synopsis ===== | ===== Synopsis ===== | ||
| - | sanboot [--drive <drive>] [--no-describe] [--keep] [<uri>] [<uri>...] | + | sanboot [--drive <drive>] [--filename <filename>] [--no-describe] |
| + | [--keep] [<uri>] [<uri>...] | ||
| ===== Examples ===== | ===== Examples ===== | ||
| Line 15: | Line 16: | ||
| sanboot iscsi:192.168.0.101::::iqn.2010-04.org.ipxe.squirrel:storage \ | sanboot iscsi:192.168.0.101::::iqn.2010-04.org.ipxe.squirrel:storage \ | ||
| iscsi:192.168.0.102::::iqn.2010-04.org.ipxe.squirrel:storage | iscsi:192.168.0.102::::iqn.2010-04.org.ipxe.squirrel:storage | ||
| + | |||
| + | === Boot from an iSCSI target with a non-default filename === | ||
| + | |||
| + | sanboot --filename \EFI\redhat\grub.efi \ | ||
| + | iscsi:192.168.0.2::::iqn.2010-04.org.ipxe.chipmunk:rhel6 | ||
| === Boot from an HTTP target === | === Boot from an HTTP target === | ||
| Line 34: | Line 40: | ||
| The SAN drive will be described via an appropriate mechanism (such as an iBFT for an iSCSI drive) unless the ''%%--no-describe%%'' option is specified. | The SAN drive will be described via an appropriate mechanism (such as an iBFT for an iSCSI drive) unless the ''%%--no-describe%%'' option is specified. | ||
| + | |||
| + | On some platforms (e.g. UEFI), the ''%%--filename%%'' option may be used to specify the path to the bootloader within the specified SAN drive. | ||
| ===== Command status ===== | ===== Command status ===== | ||
| Line 57: | Line 65: | ||
| If you wish to attach to multiple independent SAN drives, then you must use the ''[[:cmd:sanhook]]'' command to attach each non-boot drive individually. | If you wish to attach to multiple independent SAN drives, then you must use the ''[[:cmd:sanhook]]'' command to attach each non-boot drive individually. | ||
| + | |||
| + | On a UEFI platform, some older operating systems (e.g. RHEL6) will install the bootloader with a non-default filename. You can use the ''%%--filename%%'' option (or the ''[[:cfg:san-filename]]'' setting) to specify the correct bootloader filename. For example: | ||
| + | |||
| + | sanboot --filename \EFI\redhat\grub.efi \ | ||
| + | iscsi:192.168.0.2::::iqn.2010-04.org.ipxe.chipmunk:rhel6 | ||
| For the sake of backwards compatibility, you can use the ''[[:cfg:keep-san]]'' setting to prevent iPXE from detaching a SAN drive, and you can use the ''[[:cfg:skip-san-boot]]'' setting to prevent iPXE from booting from a SAN drive. The combination of both of these settings provides functionality which is approximately equivalent to the ''[[:cmd:sanhook]]'' command. | For the sake of backwards compatibility, you can use the ''[[:cfg:keep-san]]'' setting to prevent iPXE from detaching a SAN drive, and you can use the ''[[:cfg:skip-san-boot]]'' setting to prevent iPXE from booting from a SAN drive. The combination of both of these settings provides functionality which is approximately equivalent to the ''[[:cmd:sanhook]]'' command. | ||
