os-root-device Variable - Booting and Shutting Down Oracle® Solaris 11.3 Systems

Language:

`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-subnet-mask
osroot-host-ip

Example 46 Showing os-root-device Variable Keyword Data

This example shows data associated with the os-root-device ariable. The output is displayed with one keyword pair per line to make the text more readable. Normally the output is one long string.

# 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

How to Enable Normal Booting

After a system has been configured to boot from a firmware-inaccessible storage device, the stem will continue to boot in that configuration. If you want to boot using another device, change the os-root-device variable.

Check the os-root-device property.
```
# eeprom os-root-device
```
Clear the os-root-device property.
```
# eeprom os-root-device=
```
Verify that the property has been changed.
```
# eeprom os-root-device
```

Next Steps

If you need to reboot the system from a firmware-inaccessible storage device, boot the system from the boot pool. The os-root-device variable will automatically be updated during the boot process so that from then on the system will continue to boot using the iSCSI device.