Go to main content

Booting and Shutting Down Oracle® Solaris 11.3 Systems

Exit Print View

Updated: October 2017
 
 

x86: Administering the GRUB Configuration by Using the bootadm Command

On systems that support GRUB Legacy, you primarily manage the GRUB configuration and the GRUB menu by editing the menu.lst file. Systems that support GRUB 2 use the grub.cfg file. However, instead of manually editing this file, you use the boot administration interface, bootadm. You can use the bootadm command to administer most of the tasks that you previously did by editing the menu.lst file. These tasks include administering boot loader settings and the GRUB menu, as well as the individual attributes of a particular boot entry.


Note -  Because changes made to the boot loader by using either the bootadm command or the beadm command can overwrite the grub.cfg file , this file should never be directly edited.

The following bootadm subcommands support the administration of the GRUB 2 configuration:

add-entry

Adds a boot entry to the GRUB menu.

change-entry

Changes the attributes of a specified boot entry in the GRUB menu.

generate-menu

Generates a new boot loader configuration file.

install-bootloader

Installs the system boot loader. This subcommand applies to both x86 and SPARC platforms.

list-menu

Displays the current boot entries in the GRUB menu.

The –P option supports displaying boot entries for a specified root pool. The –i option displays information about a specific menu entry identified by an index number. The –t option selects the menu entry by the title.

remove-entry

Removes a boot entry from the GRUB menu.

set-menu

Maintains the GRUB menu. You can use this subcommand to set a particular GRUB menu entry as the default, to add security protection to the GRUB menu, and to set other menu options and boot loader options.

The –P option supports changing menus on multiple root pools.

set-menu-password

Sets a password to prevent the GRUB menu from being seen.

show-entry

Shows a boot entry from the GRUB menu. This subcommand is equivalent to list-menu.


Note -  Because SPARC platforms do not use GRUB, tno boot menu management by using the bootadm command. However, you can use the bootadm command on SPARC based systems to list the contents of the boot archive, to manually update the boot archive, and to install the boot loader. See Managing the Oracle Solaris Boot Archives.

The following procedures describe how to use the bootadm command to manage the GRUB configuration and the GRUB menu. For more complete information, see the bootadm(1M) man page.