JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris 10 1/13 Installation Guide: Live Upgrade and Upgrade Planning     Oracle Solaris 10 1/13 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

Maintenance Activities for Boot Environments

Displaying the Status of All Boot Environments

Updating a Previously Configured Boot Environment

Canceling a Scheduled Create, Upgrade, or Copy Job

Comparing Boot Environments

Deleting an Inactive Boot Environment

Displaying the Name of the Active Boot Environment

Changing the Name of a Boot Environment

Adding or Changing a Description Associated With a Boot Environment Name

Viewing the Configuration of a Boot Environment

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

9.  Live Upgrade Examples

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

10.  Live Upgrade and ZFS (Overview)

11.  Live Upgrade for ZFS (Planning)

12.  Creating a Boot Environment for ZFS Root Pools

13.  Live Upgrade for ZFS With Non-Global Zones Installed

Part III Appendices

A.  Live Upgrade Command Reference

B.  Troubleshooting (Tasks)

C.  Additional SVR4 Packaging Requirements (Reference)

D.  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:

The syntax for the ludesc command is as follows:

# /usr/sbin/ludesc -n  BE-name 'BE-description' -f filename
-n BE-name

Specifies the boot environment name.

BE-description

Specifies the new description to be associated with the name.

filename

Specifies the file to be associated with a boot environment 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'

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

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

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

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

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

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

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

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

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

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

Viewing the Configuration of a Boot Environment

Use the lufslist command to list the configuration of a boot environment. The output contains the disk slice (file system), file system type, and file system size for each boot environment mount point.

The syntax for the lufslist command is as follows:

# lufslist -n BE-name
BE-name

Specifies the name of the boot environment to view file system specifics

The following example displays a list.

Filesystem                fstype       size(MB) Mounted on
------------------------------------------------------------------
/dev/dsk/c0t0d0s1         swap           512.11 -
/dev/dsk/c0t4d0s3         ufs           3738.29 /
/dev/dsk/c0t4d0s4         ufs            510.24 /opt

Note - For an example of a list that contains non-global zones, see To View the Configuration of a Boot Environment's Non-Global Zone File Systems.