SPARC: How to List Available Bootable Datasets Within a ZFS Root Pool

On SPARC based systems, the menu.lst file contains the following two GRUB commands:

• title – Provides a title for a boot environment (BE)

• bootfs – Specifies the full name of the bootable dataset

To display a list of the bootable datasets within a ZFS pool, choose from the following methods:

• Use the lustatus command. This command lists all of the BEs in a given ZFS pool.

  Note that the lustatus command can also be used on x86 based systems.

• Use the boot -L command. This command displays a list of the available BEs in a given ZFS pool and provides instructions for booting the system.

The following procedure describes how to use the boot -L command to list available BEs on a system. To boot a specified BE after running this command, follow the instructions that are printed on the screen.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Bring the system to the ok PROM prompt.

   # init 0

3. List the available BEs in a ZFS pool:

   ok boot device-specifier -L

4. To boot one of the entries that is displayed, type the number that corresponds to the entry.

5. Boot the specified BE by following the directions that are printed on the screen.

   For instructions, see SPARC: How to Boot From a Specified ZFS Root File System.

Example 12–5 SPARC: Displaying a List of Available BEs on a System by Using boot -L

# init 0
# svc.startd: The system is coming down. Please wait.
svc.startd: 94 system services are now being stopped.
svc.startd: The system is down.
syncing file systems... done
Program terminated
ok boot -L
.
.
.
Boot device: /pci@1f,0/pci@1/scsi@8/disk@0,0 File and args: -L
zfs-file-system
Loading: /platformsun4u/bootlst
1.s10s_nbu6wos
2 zfs2BE
Select environment to boot: [ 1 - 2 ]: 2

to boot the selected entry, invoke:
boot [<root-device] -Z rpool/ROOT/zfs2BE

See Also

For more information, see Chapter 5, Installing and Booting an Oracle Solaris ZFS Root File System, in Oracle Solaris ZFS Administration Guide.