Go to main content

Creating and Administering Oracle® Solaris 11.4 Boot Environments

Exit Print View

Updated: November 2019

Creating Custom Names for Boot Environments

The beadm rename command enables you to rename an existing BE for a more meaningful identity. For example, you could rename a BE to specify how you customized that environment. The BEs dataset name is also changed to conform to the new BE name.

Renaming a BE does not affect zones or zone dataset names. Likewise, the change does not affect the relationships between the zones and their related boot environments.

An active BE cannot be renamed. Only inactive BEs can be renamed. Further, you cannot rename the BE that is currently booted. Activate a different BE first and boot to that environment. Then can rename the first BE. The command syntax is as follows:

beadm rename BeFMRI newBeFMRI

The command fails if the new name already exists.