BEADM(1M) | Maintenance Commands | BEADM(1M) |
beadm create [-a] [-d description] [-e non-activeBeName | beName@snapshot] [-o property=value] ... [-p zpool] [-v] beName
beadm create [-v] beName@snapshot
beadm destroy [-fFsv] beName | beName@snapshot
beadm list [-a | -ds] [-H] [-k|-K date | name | space] [-v] [beName]
beadm mount [-s ro|rw] [-v] beName mountpoint
beadm unmount [-fv] beName | mountpoint
beadm rename [-v] beName newBeName
beadm activate [-v] beName
beadm rollback [-v] beName snapshot
beadm rollback [-v] beName@snapshot
The beadm command supports the following operations:
beadm
beadm create [-a] [-d description] [-e non-activeBeName | beName@snapshot] [-o property=value] ... [-p zpool] [-v] beName
-a
-d description
-e non-activeBeName
-e beName@snapshot
-o property=value
-p zpool
-v
beadm create [-v] beName@snapshot
-v
beadm destroy [-fFsv] beName | beName@snapshot
-f
-F
-s
-v
beadm list [-a | -ds] [-H] [-k|-K date | name | space] [-v] [beName]
Each line in the machine parsable output has the boot environment name as the first field. The 'Space' field is displayed in bytes and the 'Created' field is displayed in UTC format. The -H option used with no other options gives the boot environment's uuid in the second field. This field will be blank if the boot environment does not have a uuid. See the EXAMPLES section. In non-global zones, this field shows the uuid of the parent BE.
-a
-d
-s
-H
-k date
-k name
-k space
-K date | name | space
-v
beadm mount [-s ro|rw] [-v] beName mountpoint
-s ro|rw
-v
beadm unmount [-fv] beName | mountpoint
-f
-v
beadm rename [-v] beName newBeName
-v
beadm rollback [-v] beName snapshot | beName@snapshot
-v
beadm activate [-v] beName
-v
# beadm create BE1
Example 2: Create a new BE named BE2, by cloning the existing inactive BE named BE1.
# beadm create -e BE1 BE2
Example 3: Create a snapshot named now of the existing BE named BE1.
# beadm create BE1@now
Example 4: Create a new BE named BE3, by cloning an existing snapshot of BE1.
# beadm create -e BE1@now BE3
Example 5: Create a new BE named BE4 based on the currently running BE. Create the new BE in rpool2.
# beadm create -p rpool2 BE4
Example 6: Create a new BE named BE5 based on the currently running BE. Create the new BE in rpool2, and create its datasets with compression turned on.
# beadm create -p rpool2 -o compression=on BE5
Example 7: Create a new BE named BE6 based on the currently running BE and provide a description for it.
# beadm create -d "BE6 used as test environment" BE6
Example 8: Activate an existing, inactive BE named BE3.
# beadm activate BE3
Example 9: Mount the BE named BE3 at /mnt.
# beadm mount BE3 /mnt
Example 10: Unmount the mounted BE named BE3.
# beadm unmount BE3
Example 11: Destroy the BE named BE3 without verification.
# beadm destroy -f BE3
Example 12: Destroy the snapshot named now of BE1.
# beadm destroy BE1@now
Example 13: Rename the existing, inactive BE named BE1 to BE3.
# beadm rename BE1 BE3
Example 14: Roll back the BE named BE1 to snapshot BE1@now.
# beadm rollback BE1 BE1@now
Example 15: List all existing boot environments.
# beadm list BE Active Mountpoint Space Policy Created -- ------ ---------- ----- ------ ------- BE2 - - 72.0K static 2008-05-21 12:26 BE3 - - 332.0K static 2008-08-26 10:28 BE4 - - 15.78M static 2008-09-05 18:20 BE5 NR / 7.25G static 2008-09-09 16:53
Example 16: List all existing boot environmets and list all dataset and snapshot information about those bootenvironments.
# beadm list -d -s BE/Dataset/Snapshot Active Mountpoint Space Policy Created ------------------- ------ ---------- ----- ------ ------- BE2 p/ROOT/BE2 - - 36.0K static 2008-05-21 12:26 p/ROOT/BE2/opt - - 18.0K static 2008-05-21 16:26 p/ROOT/BE2/opt@now - - 0 static 2008-09-08 22:43 p/ROOT/BE2@now - - 0 static 2008-09-08 22:43 BE3 p/ROOT/BE3 - - 192.0K static 2008-08-26 10:28 p/ROOT/BE3/opt - - 86.0K static 2008-08-26 10:28 p/ROOT/BE3/opt/local - - 36.0K static 2008-08-28 10:58 BE4 p/ROOT/BE4 - - 15.78M static 2008-09-05 18:20 BE5 p/ROOT/BE5 NR / 6.10G static 2008-09-09 16:53 p/ROOT/BE5/opt - /opt 24.55M static 2008-09-09 16:53 p/ROOT/BE5/opt@bar - - 18.38M static 2008-09-10 00:59 p/ROOT/BE5/opt@foo - - 18.38M static 2008-06-10 16:37 p/ROOT/BE5@bar - - 139.44M static 2008-09-10 00:59 p/ROOT/BE5@foo - - 912.85M static 2008-06-10 16:37
Example 17: List all dataset and snapshot information about BE5
# beadm list -a BE5 BE/Dataset/Snapshot Active Mountpoint Space Policy Created ------------------- ------ ---------- ----- ------ ------- BE5 p/ROOT/BE5 NR / 6.10G static 2008-09-09 16:53 p/ROOT/BE5/opt - /opt 24.55M static 2008-09-09 16:53 p/ROOT/BE5/opt@bar - - 18.38M static 2008-09-10 00:59 p/ROOT/BE5/opt@foo - - 18.38M static 2008-06-10 16:37 p/ROOT/BE5@bar - - 139.44M static 2008-09-10 00:59 p/ROOT/BE5@foo - - 912.85M static 2008-06-10 16:37
Example 18: List machine parsable information about all boot environments.
# beadm list -H BE2;;;;55296;static;1211397974 BE3;;;;339968;static;1219771706 BE4;;;;16541696;static;1220664051 BE5;215b8387-4968-627c-d2d0-f4a011414bab;NR;/;7786206208;static;1221004384
0
>0
yyyymmdd_hhmmss - 20071130_140558 yy - year; 2007 mm - month; 11 dd - day; 30 hh - hour; 14 mm - minute; 05 ss - second; 58
/etc/default/be
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Interface Stability | Uncommitted |
February 21, 2016 |