JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Managing Boot Environments With Oracle Solaris 11 Express     Oracle Solaris 11 Express 11/10
search filter icon
search icon

Document Information

1.  Introduction to Boot Environments

2.  Using beadm Utility (Tasks)

3.  beadm Zones Support

4.  Appendix: beadm Reference

beadm Command Reference

beadm Command Reference

Table 4-1 beadm Command

Displays command usage.
beadm activate
Makes beName the active boot environment on next reboot.

Syntax: beadm activate beName

beadm create
Creates a new boot environment name, beName. Unless the -e option is provided, the new boot environment is created as a clone of the currently running boot environment.

Syntax: beadm create [-a] [-d description] [-e non-activeBeName | beName@snapshot] [-o property=value] beName

  • -a – Activate the newly created boot environment upon creation. The default is to not activate the newly created boot environment.

  • -d description – Use this description as the title in the x86 GRUB menu or the SPARC boot menu that describes this new boot environment. If this option is not used, beName is used for the title.

  • -e non-activeBeName – Create a new boot environment from an existing, inactive boot environment. The default is to create the boot environment from the active boot environment.

  • -e beName@snapshot – Create a new boot environment from an existing snapshot of the boot environment named beName.

  • -o property=value – Create the datasets for new boot environment with specific ZFS properties. Multiple -o options can be specified. See zfs(1M) for more information on the -o option.

  • beName – Name of the boot environment to create.

  • beName@snapshot – Name of an existing snapshot of the boot environment named beName.

beadm create beName@snapshot
Creates a snapshot of the existing boot environment named beName.

Syntax: beadm create beName@snapshot

beName@snapshot – The snapshot name must use the format, beName@snapshotdescription, where beName is the name of an existing boot environment that you want to make a snapshot from. Enter a custom snapshotdescription to identify the date or purpose of the snapshot.

beadm destroy
Destroys the boot environment named beName or destroys an existing snapshot, beName@snapshot, of a boot environment. Prompts for confirmation before destroying the boot environment.

Syntax: beadm destroy [-fF] beName | beName@snapshot

  • -f – Forces destruction of the boot environment even if it is mounted.

  • -F – Forces destruction of the boot environment without prompting for confirmation.

beadm list
Lists information about the existing boot environment, which is beName, or lists information for all boot environments if beName is not provided. The default is to list boot environments without any additional information.

Syntax: beadm list [-a | [-ds] [-H] [beName]

  • -a – Lists all available information about the boot environment. This information includes subordinate datasets and snapshots.

  • -d – Lists information about all subordinate datasets hat belong to the boot environment.

  • -s – Lists information about the snapshots of the boot environment.

  • -H – Prevents listing header information. Each field in the output is separated by a semicolon.

    The example is displayed without a header:


    Without header information, the display information is identified by the following delimiters:

    • ; – Delimits boot environments, datasets, zones, and snapshots.

    • : – Delimits attributes for boot environments, datasets, zones, and snapshots.

    • , – Delimits multiple datasets, zones, and snapshots.

    • Multiple boot environments are delimited with a return, a blank line.

    Note - The -p option can be combined with the other options.

  • beName – If beName is not provided, the command results display information for all boot environments.

beadm mount
Mounts a boot environment named beName at mount point. The mount point must be an already existing, empty directory.

Syntax: beadm mount beName mountpoint

Note - Unmount the boot environment before rebooting.

beadm rename
Renames the boot environment named beName to newBeName.

Syntax: beadm rename beName newBeName

beadm unmount
Unmounts the boot environment named beName.

Syntax: beadm unmount [-f] beName

-f – Forcefully unmounts the boot environment even if it is currently busy.

For detailed instructions about the beadm utility, see the beadm(1M) man page.