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

Document Information

Preface

Part I Upgrading With Live Upgrade

1.  Where to Find Oracle Solaris Installation Planning Information

2.  Live Upgrade (Overview)

3.  Live Upgrade (Planning)

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

5.  Upgrading With Live Upgrade (Tasks)

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

7.  Maintaining Live Upgrade Boot Environments (Tasks)

Overview of 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 Oracle Solaris OS on a System With Non-Global Zones Installed

9.  Live Upgrade (Examples)

10.  Live Upgrade (Command Reference)

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

11.  Live Upgrade and ZFS (Overview)

12.  Live Upgrade for ZFS (Planning)

13.  Creating a Boot Environment for ZFS Root Pools

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

Adding or Changing a Description Associated With a Boot Environment Name

You can associate a description with a boot environment name. The description never replaces the name. Although a boot environment name is restricted in length and characters, the description can be of any length and of any content. The description can be simple text or as complex as a gif file. You can create this description at these times:

For more information about using the -A option with lucreate
For more information about creating the description after the boot environment has been created

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

  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:
    # /usr/sbin/ludesc -n  BE_name 'BE_description'
    -n BE_name 'BE_description'

    Specifies the boot environment name and the new description to be associated with the name

Example 7-5 Adding a Description to a Boot Environment Name With Text

In this example, a boot environment description is added to a boot environment that is named second_disk. The description is text that is enclosed in single quotes.

# /usr/sbin/ludesc -n second_disk 'Oracle Solaris 10 8/11 test build'

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

  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:
    # /usr/sbin/ludesc -n BE_name -f file_name
    -n BE_name

    Specifies the boot environment name

    file_name

    Specifies the file to be associated with a boot environment name

Example 7-6 Adding a Description to a Boot Environment Name With a File

In this example, a boot environment description is added to a boot environment that is named second_disk. The description is contained in a gif file.

# /usr/sbin/ludesc -n second_disk -f rose.gif

To Determine a Boot Environment Name From a Text Description

The following command returns the name of the boot environment associated with the specified description.

  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:
    # /usr/sbin/ludesc -A 'BE_description'
    -A 'BE_description'

    Specifies the description to be associated with the boot environment name.

Example 7-7 Determining a Boot Environment Name From a Description

In this example, the name of the boot environment, second_disk, is determined by using the -A option with the description.

# /usr/sbin/ludesc -A 'Oracle Solaris 10 8/11 test build'
 second_disk

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

The following command displays the boot environment's name that is associated with a file. The file contains the description of the 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:
    # /usr/sbin/ludesc -f  file_name
    -f file_name

    Specifies the name of the file that contains the description of the boot environment.

Example 7-8 Determining a Boot Environment Name From a Description in a File

In this example, the name of the boot environment, second_disk, is determined by using the -f option and the name of the file that contains the description.

# /usr/sbin/ludesc -f rose.gif
second_disk

To Determine a Boot Environment Description From a Name

This procedure displays the description of the boot environment that is named in the command.

  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:
    # /usr/sbin/ludesc -n BE_name
    -n BE_name

    Specifies the boot environment name.

Example 7-9 Determining a Boot Environment Description From a Name

In this example, the description is determined by using the -n option with the boot environment name.

# /usr/sbin/ludesc -n second_disk 
Oracle Solaris 10 8/11 test build