Changing the Name of a Boot Environment

Renaming a boot environment is often useful when you upgrade the boot environment from one Solaris release to another release. For example, following an operating system upgrade, you might rename the boot environment solaris8 to solaris10.

Use the lurename command to change the inactive boot environment's name.

x86 only - Starting with the Solaris 10 1/06 release, the GRUB menu is automatically updated when you use the Rename menu or lurename command. The updated GRUB menu displays the boot environment's name in the list of boot entries. For more information about the GRUB menu, see Booting Multiple Boot Environments.

To determine the location of the GRUB menu's menu.lst file, see Chapter 13, Managing the Oracle Solaris Boot Archives (Tasks), in System Administration Guide: Basic Administration.

Table 7-2 Limitations for Naming a Boot Environment

Limitation	For Instructions
The name must not exceed 30 characters in length.
The name can consist only of alphanumeric characters and other ASCII characters that are not special to the UNIX shell.	See the “Quoting” section of `sh`(1).
The name can contain only single-byte, 8-bit characters.
The name must be unique on the system.
A boot environment must have the status “complete” before you rename it.	See Displaying the Status of All Boot Environments to determine a boot environment's status.
You cannot rename a boot environment that has file systems mounted with `lumount` or `mount`.

To Change the Name of an Inactive Boot Environment

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.
Type:
```
# lurename -e  BE_name -n  new_name
```
-e BE_name

Specifies the inactive boot environment name to be changed

-n new_name

Specifies the new name of the inactive boot environment

In this example, second_disk is renamed to third_disk.
```
# lurename -e  second_disk -n  third_disk
```

Skip Navigation Links
Exit Print View
	Oracle Solaris 10 9/10 Installation Guide: Solaris Live Upgrade and Upgrade Planning