beadm quick reference

Updated 25 Apr 2011 Read time 1 min 3 sec(s) (903 views). Solaris

The beadm command, /usr/sbin/beadm, enables users to manage their boot environments.

The following table summarizes the subcommands and options for the beadm utility.

Table 1 — Common beadm commands
Sub commands	Description
beadm	Display command usage
beadm activate `beName`	Makes `beName` the active boot environment on next reboot
beadm create `beName`	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.
beadm create `beName@snapshot`	Create a snapshot of the existing boot environment named `beName`
beadm destroy `beName`	Destroys the boot environment named `beName`. Prompts for confirmation before destroying the boot environment.
beadm destroy `beName@snapshot`	Destroys an existing snapshot `beName@snapshot` of a boot environment. Prompts for confirmation before destroying the boot environment.
beadm list	List information for all boot environments
beadm list `beName`	Lists information about the existing boot environment `beName`
beadm mount `beName` `<mountpoint>`	Mounts a boot environment named `beName`at mount point `<mountpoint>`. Note: The mountpoint must already exist and be an empty directory
beadm rename `beName` `newBeName`	Renames the boot environment named `beName` to `newBeName`
beadm unmount `beName`	Unmounts the boot environment named `beName`

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