# nodesetboot(8) - Check or set next boot device for noderange

## SYNOPSIS

`nodesetboot [options] <noderange> [default|cd|network|setup|hd|usb|floppy]`

## DESCRIPTION

Requests that the next boot occur from the specified device. Unless otherwise specified, this is a one time boot option, and does not change the normal boot behavior of the system. This is useful for taking a system that normally boots to the hard drive and starting a network install, or to go into the firmware setup menu without having to hit a keystroke at the correct time on the console.

Generally, it's a bit more convenient and direct to use the nodeboot(8) command, which will follow up the boot device with an immediate power directive to take effect. The `nodesetboot` command is still useful, particularly if you want to use `nodesetboot <noderange> setup` and then initiate a reboot from within the operating system with ssh or similar rather than using the remote hardware control.

Running the command with no target queries the current setting.

## OPTIONS

- `-b`, `--bios`: For a system that supports both BIOS and UEFI style boot, request BIOS style boot if supported (some platforms will UEFI boot with this flag anyway).
- `-p`, `--persist`: For a system that supports it, mark the boot override to persist rather than be a one time change. Many systems do not support this functionality.
- `-u`, `--uefi`: This flag does nothing, it is for command compatibility with xCAT's rsetboot
- `-m MAXNODES`, `--maxnodes=MAXNODES`: Specify a maximum number of nodes to modify next boot device, prompting if over the threshold
- `-h`, `--help`: Show help message and exit
- `default`: Request a normal default boot with no particular device override
- `cd`: Request boot from media. Note that this can include physical CD, remote media mounted as CD/DVD, and detachable hard disks drives such as usb key devices.
- `floppy`: Request boot from floppy. Generally speaking firmware uses this to mean a USB flash drive or similar (whether virtual or physical).
- `usb`: Request boot from usb. Generally speaking firmware uses this to mean a USB flash drive or similar (whether virtual or physical).
- `network`: Request boot to network
- `setup`: Request to enter the firmware configuration menu (e.g. F1 setup) on next boot.
- `hd`: Boot straight to hard disk drive

## EXAMPLES

- Set next boot to setup for four nodes: `# nodesetboot n1-n4 setup`  
  `n1: setup`  
  `n3: setup`  
  `n2: setup`  
  `n4: setup`
- Check boot override settings on four nodes: `# nodesetboot n1-n4`  
  `n1: setup`  
  `n2: setup`  
  `n3: setup`  
  `n4: setup`

## SEE ALSO

nodeboot(8)
