JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris 10 9/10 Installation Guide: Solaris Live Upgrade and Upgrade Planning
search filter icon
search icon

Document Information

Preface

Part I Upgrading With Solaris Live Upgrade

1.  Where to Find Solaris Installation Planning Information

2.  Solaris Live Upgrade (Overview)

3.  Solaris Live Upgrade (Planning)

4.  Using Solaris Live Upgrade to Create a Boot Environment (Tasks)

5.  Upgrading With Solaris Live Upgrade (Tasks)

6.  Failure Recovery: Falling Back to the Original Boot Environment (Tasks)

7.  Maintaining Solaris Live Upgrade Boot Environments (Tasks)

Overview of Solaris Live Upgrade Maintenance

Displaying the Status of All Boot Environments

To Display the Status of All Boot Environments

Updating a Previously Configured Boot Environment

To Update a Previously Configured Boot Environment

Canceling a Scheduled Create, Upgrade, or Copy Job

To Cancel a Scheduled Create, Upgrade, or Copy Job

Comparing Boot Environments

To Compare Boot Environments

Deleting an Inactive Boot Environment

To Delete an Inactive Boot Environment

Displaying the Name of the Active Boot Environment

To Display the Name of the Active Boot Environment

Changing the Name of a Boot Environment

To Change the Name of an Inactive Boot Environment

Adding or Changing a Description Associated With a Boot Environment Name

To Add or Change a Description for a Boot Environment Name With Text

To Add or Change a Description for a Boot Environment Name With a File

To Determine a Boot Environment Name From a Text Description

To Determine a Boot Environment Name From a Description in a File

To Determine a Boot Environment Description From a Name

Viewing the Configuration of a Boot Environment

To View the Configuration of a Boot Environment

8.  Upgrading the Solaris OS on a System With Non-Global Zones Installed

9.  Solaris Live Upgrade (Examples)

10.  Solaris Live Upgrade (Command Reference)

Part II Upgrading and Migrating With Solaris Live Upgrade to a ZFS Root Pool

11.  Solaris Live Upgrade and ZFS (Overview)

12.  Solaris Live Upgrade for ZFS (Planning)

13.  Creating a Boot Environment for ZFS Root Pools

14.  Solaris Live Upgrade For ZFS With Non-Global Zones Installed

Part III Appendices

A.  Troubleshooting (Tasks)

B.  Additional SVR4 Packaging Requirements (Reference)

C.  Using the Patch Analyzer When Upgrading (Tasks)

Glossary

Index

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

  1. 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.

  2. 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