Attach SAN device


  sanhook [--drive <drive>] [--no-describe] <uri> [<uri>...]


Attach an iSCSI target


Attach a multipath iSCSI target

  sanhook \

Attach two independent iSCSI targets

  sanhook --drive 0x80
  sanhook --drive 0x81

Check ability to attach a SAN target

  sanhook ${root-path} && sanunhook || echo Could not attach ${root-path}

Attach a SAN target and then boot an installer held on another target

  sanhook --drive 0x81 ${root-path}
  sanboot --no-describe


Attach the specified SAN target URIs as the specified SAN drive. If no SAN drive is explicitly specified then the default SAN drive (0x80) will be used.

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.

Command status

Success The SAN target was successfully attached
Failure The SAN target was not successfully attached

See also


You can create a multipath SAN device by specifying multiple SAN target URIs. iPXE will use whichever SAN target responds first, and will retry all URIs if the original SAN target fails for any reason. You must ensure that all SAN URIs in a multipath SAN device point to the same underlying SAN drive.

If you wish to attach to multiple independent SAN drives, then you must use the sanhook command once for each independent SAN drive.

cmd/sanhook.txt ยท Last modified: 2017/03/26 13:38 by mcb30
Recent changes RSS feed CC Attribution-Share Alike 4.0 International 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.