Go to main content

Booting and Shutting Down Oracle® Solaris 11.4 Systems

Exit Print View

Updated: November 2020
 
 

os-root-device Variable

The os-root-device NVRAM variable defines devices and root file systems for root pools. To view this variable use the printenv command at the OpenBoot prompt or the eeprom command at a shell prompt. This variable is automatically maintained and normally should not need manual intervention. You can use the following keywords to define root pools stored on a firmware-inaccessible storage device:

  • osroot-path
  • osroot-type
  • osroot-iscsi-initiator-id
  • osroot-iscsi-target-ip
  • osroot-iscsi-port
  • osroot-iscsi-partition
  • osroot-iscsi-lun
  • osroot-iscsi-target-name
  • osroot-iscsi-target-name
  • osroot-subnet-mask
  • osroot-host-ip

When you use os-root-device to set a system to boot from a firmware-inaccessible storage device, that system will continue to use that configuration. To boot the system using another device, clear the current os-root-device setting, then assign a new value. For example:

$ eeprom os-root-device=
$ eeprom os-root-device=new-value

To display current os-root-device settings, use the following command. The output in this example has been reformatted for readability.

$ eeprom os-root-device
os-root-device=osroot-type=ZFS/iSCSI/IPv4/IPoIB;
osroot-iscsi-port=3260;
osroot-iscsi-target-ip=168.168.1.2;
osroot-iscsi-partition=a;
osroot-iscsi-initiator-id=iqn.1986-03.com.sun:01:0010e05db261.550b268b;
osroot-iscsi-lun=5;
osroot-iscsi-target-name=iqn.1986-03.com.sun:02:fb3685b9-883d-460a-b817-8ea0d8c023dc;
osroot-subnet-mask=255.255.255.0;osroot-host-ip=168.168.1.156;
osroot-path=/pci@314/pci@1/pciex15b3,1003@0:port=1,pkey=FFFF,protocol=ip