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)

Task Map: Upgrading a Boot Environment

Upgrading a Boot Environment

Guidelines for Upgrading

Upgrading a System With Packages or Patches

To Upgrade a Network Installation Image on a Boot Environment

To Upgrade a Network Installation Image From Multiple CDs

To Add Packages to a Network Installation Image on a Boot Environment

To Add Patches to a Network Installation Image on a Boot Environment

To Obtain Information on Packages Installed on a Boot Environment

Upgrading by Using a JumpStart Profile

To Create a Profile to be Used by Solaris Live Upgrade

To Test a Profile to Be Used by Solaris Live Upgrade

To Upgrade With a Profile by Using Solaris Live Upgrade

Installing Solaris Flash Archives on a Boot Environment

To Install a Solaris Flash Archive on a Boot Environment

To Install a Solaris Flash Archive With a Profile

To Install a Solaris Flash Archive With a Profile Keyword

Activating a Boot Environment

Requirements and Limitations for Activating a Boot Environment

To Activate a Boot Environment

To Activate a Boot Environment and Synchronize Files

x86: Activating a Boot Environment With the GRUB Menu

x86: To Activate a Boot Environment With the GRUB Menu

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

7.  Maintaining Solaris Live Upgrade Boot Environments (Tasks)

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

Activating a Boot Environment

Activating a boot environment makes it bootable on the next reboot of the system. You can also switch back quickly to the original boot environment if a failure occurs on booting the newly active boot environment. See Chapter 6, Failure Recovery: Falling Back to the Original Boot Environment (Tasks).

Description
For More Information
Use this procedure to activate a boot environment with the luactivate command.

Note - The first time you activate a boot environment, the luactivate command must be used.


Use this procedure to activate a boot environment and force a synchronization of files.

Note - Files are synchronized with the first activation. If you switch boot environments after the first activation, files are not synchronized.


x86: Use this procedure to activate a boot environment with the GRUB menu.

Note - A GRUB menu can facilitate switching from one boot environment to another. A boot environment appears in the GRUB menu after the first activation.


Requirements and Limitations for Activating a Boot Environment

To successfully activate a boot environment, that boot environment must meet the following conditions:

Description
For More Information
The boot environment must have a status of “complete.”
If the boot environment is not the current boot environment, you cannot have mounted the partitions of that boot environment by using the luumount or mount commands.
To view man pages, see lumount(1M) or mount(1M)
The boot environment that you want to activate cannot be involved in a comparison operation.
For procedures, see Comparing Boot Environments
If you want to reconfigure swap, make this change prior to booting the inactive boot environment. By default, all boot environments share the same swap devices.

x86 only - If you have an x86 based system, you can also activate with the GRUB menu. Note the following exceptions:

See x86: Activating a Boot Environment With the GRUB Menu.


To Activate a Boot Environment

The following procedure switches a new boot environment to become the currently running boot environment.


x86 only - If you have an x86 based system, you can also activate with the GRUB menu. Note the following exceptions:

See x86: Activating a Boot Environment With the GRUB Menu.


  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. To activate the boot environment, type:
    # /sbin/luactivate BE_name
    BE_name

    Specifies the name of the boot environment that is to be activated

  3. Reboot.
    # init 6

    Caution

    Caution - Use only the init or shutdown commands to reboot. If you use the reboot, halt, or uadmin commands, the system does not switch boot environments. The last-active boot environment is booted again.


Example 5-14 Activating a Boot Environment

In this example, the second_disk boot environment is activated at the next reboot.

# /sbin/luactivate second_disk
# init 6

To Activate a Boot Environment and Synchronize Files

The first time you boot from a newly created boot environment, Solaris Live Upgrade software synchronizes the new boot environment with the boot environment that was last active. “Synchronize” means that certain critical system files and directories are copied from the last-active boot environment to the boot environment being booted. Solaris Live Upgrade does not perform this synchronization after the initial boot, unless you force synchronization with the luactivate command and the -s option.


x86 only - When you switch between boot environments with the GRUB menu, files also are not synchronized. You must use the following procedure to synchronize files.


For more information about synchronization, see Synchronizing Files Between Boot Environments.

  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. To activate the boot environment, type:
    # /sbin/luactivate -s BE_name
    -s

    Forces a synchronization of files between the last-active boot environment and the new boot environment. The first time that a boot environment is activated, the files between the boot environment are synchronized With subsequent activations, the files are not synchronized unless you use the -s option.


    Caution

    Caution - Use this option with great care, because you might not be aware of or in control of changes that might have occurred in the last-active boot environment. For example, if you were running Solaris 10 9/10 software on your current boot environment and booted back to a Solaris 9 release with a forced synchronization, files could be changed on the Solaris 9 release. Because files are dependent on the release of the OS, the boot to the Solaris 9 release could fail because the Solaris 10 9/10 files might not be compatible with the Solaris 9 files.


    BE_name

    Specifies the name of the boot environment that is to be activated.

  3. Reboot.
    # init 6

Example 5-15 Activating a Boot Environment

In this example, the second_disk boot environment is activated at the next reboot and the files are synchronized.

# /sbin/luactivate -s second_disk
# init 6

x86: Activating a Boot Environment With the GRUB Menu

A GRUB menu provides an optional method of switching between boot environments. The GRUB menu is an alternative to activating (booting) with the luactivate command. The table below notes cautions and limitations when using the GRUB menu.

Table 5-3 x86: Activating With the GRUB Menu Summary

Task
Description
For More Information
Caution
After you have activated a boot environment, do not change the disk order in the BIOS. Changing the order might cause the GRUB menu to become invalid. If this problem occurs, changing the disk order back to the original state fixes the GRUB menu.
Activating a boot environment for the first time
The first time you activate a boot environment, you must use the luactivate command. The next time you boot, that boot environment's name is displayed in the GRUB main menu. You can thereafter switch to this boot environment by selecting the appropriate entry in the GRUB menu.
Synchronizing files
The first time you activate a boot environment, files are synchronized between the current boot environment and the new boot environment. With subsequent activations, files are not synchronized. When you switch between boot environments with the GRUB menu, files also are not synchronized. You can force a synchronization when using the luactivate command with the -s option.
Boot environments created before the Solaris 10 1/06 release
If a boot environment was created with the Solaris 8, 9, or 10 3/05 release, the boot environment must always be activated with the luactivate command. These older boot environments do not display on the GRUB menu.
Editing or customizing the GRUB menu entries
The menu.lst file contains the information that is displayed in the GRUB menu. You can revise this file for the following reasons:
  • To add to the GRUB menu entries for operating systems other than the Solaris OS.

  • To customize booting behavior. For example, you could change booting to verbose mode or change the default time that automatically boots the OS.


Note - If you want to change the GRUB menu, you need to locate the menu.lst file. For step-by-step instructions, see Chapter 13, Managing the Oracle Solaris Boot Archives (Tasks), in System Administration Guide: Basic Administration.



Caution

Caution - Do not use the GRUB menu.lst file to modify Solaris Live Upgrade entries. Modifications could cause Solaris Live Upgrade to fail. Although you can use the menu.lst file to customize booting behavior, the preferred method for customization is to use the eeprom command. If you use the menu.lst file to customize, the Solaris OS entries might be modified during a software upgrade. Changes to the file could be lost.


x86: To Activate a Boot Environment With the GRUB Menu

You can switch between two boot environments with the GRUB menu. Note the following limitations:

  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. Reboot the system.
    # init 6

    The GRUB main menu is displayed. The two operating systems are listed, Solaris and second_disk, which is a Solaris Live Upgrade boot environment. The failsafe entries are for recovery, if for some reason the primary OS does not boot.

    GNU GRUB version 0.95 (616K lower / 4127168K upper memory)
    +-------------------------------------------------------------------+
    |Solaris                                                            |
    |Solaris  failsafe                                                  |
    |second_disk                                                        |
    |second_disk failsafe                                               |
    +-------------------------------------------------------------------+
    Use the ^ and v keys to select which entry is highlighted. Press
    enter to boot the selected OS, 'e' to edit the commands before
    booting, or 'c' for a command-line.
  3. To activate a boot environment, use the arrow key to select the desired boot environment and press Return.

    The selected boot environment is booted and becomes the active boot environment.