Booting and Shutting Down Oracle^® Solaris 11.4 Systems

Using the change-entry Command

The change-entry subcommand sets certain boot attributes for one or more boot entries in the GRUB menu. If multiple entries have the same title, all of the entries are affected.

A special attribute, set-default, sets the default entry to boot from when the timer expires. This attribute has the same function as the set-menu default=value subcommand. See Example 1, Changing the Default Boot Entry in the GRUB Menu.

Use the following command syntax:

$ bootadm change-entry [-P pool] {[entry-title[,entry-title...]}]
| -i entry-number[,entry-number]...]} { key=value [ key=value ...]
| set-default }

Example 4  Setting the Title for a Boot Entry in the GRUB Menu

This example shows how to set the title for a specified boot entry. If multiple entries have the same title, all of the entries are affected.

$ bootadm change-entry -i 1 title="Oracle Solaris 11-backup1"

$ bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 45
0 Oracle Solaris 11/11
1 Oracle Solaris 11-backup1
2 Oracle Solaris 11.4

Example 5  Changing a Boot Entry by Specifying Kernel Arguments

Kernel boot settings for a menu entry are set through the kargs argument. Specify multiple settings inside quotes.

This example sets boot entry number 2 both to boot in single-user mode and to display messages in verbose mode.

$ bootadm change-entry -i 2 kargs="-v -s"
$ bootadm list-menu -i 2
The location of the boot loader configuration files is: /rpool/boot/grub
     title: Oracle Solaris 11.4
     kernel: /platform/i86pc/kernel/$ISADIR/unix
     kernel arguments: -v -s
     boot archive: /platform/i86pc/$ISADIR/boot_archive
     ZFS root pool: rpool

Example 6  Removing Kernel Arguments From a Boot Entry

This example assigns a null value to kargs to remove the previous settings:

$ bootadm change-entry -i 1 kargs=
$ bootadm list-menu -i 1
the location of the boot loader configuration files is: /rpool/boot/grub
title: Oracle Solaris 11-backup1
kernel: /platform/i86pc/kernel/amd64/unix
kernel arguments:
boot archive: /platform/i86pc/amd64/boot_archive
ZFS root pool: rpool/ROOT/s11.3.backup