test

Solaris 9 Installation Guide

Chapter 35 Solaris Live Upgrade (Examples)

This chapter provides examples of creating a boot environment, then upgrading and activating it by using either a character user interface (CUI) or a command-line interface (CLI). Examples of switching back to the original boot environment are also provided.

Example of Upgrading With Solaris Live Upgrade (Command-Line Interface)

In this example, a new boot environment is created by using the lucreate command on a system that is running the Solaris 2.6 release. The new boot environment is upgraded to the Solaris 9 release by using the luupgrade command. The upgraded boot environment is activated by using the luactivate command. An example of falling back to the original boot environment is also given.

Install Live Upgrade on the Active Boot Environment

  1. Insert the Solaris 9 DVD or Solaris 9 Software 2 of 2 CD.

  2. Follow the step for the media you are using.

    • If you are using the Solaris 9 DVD, change directories to the installer and run the installer.


      # cd /cdrom/cdrom0/Solaris_9/Tools/Installers
# ./liveupgrade20

      The Solaris Web Start installer is displayed.

    • If you are using the Solaris 9 Software 2 of 2 CD, run the installer. 


      % ./installer

      The Solaris Web Start installer is displayed.

  3. From the Select Type of Install panel, click Custom.

  4. On the Locale Selection panel, click the language to be installed.

  5. Choose the software to install.

    • For DVD, on the Component Selection panel, click Next to install the packages.

    • For CD, On the Product Selection panel, click Default Install for Solaris Live Upgrade and click on the other software choices to deselect them.

  6. Follow the directions on the Solaris Web Start installer panels to install the software.

Create a Boot Environment

The source boot environment is named c0t4d0s0 by using the -c option. Naming the source boot environment is not required and is only used when the first boot environment is created. For more information on naming using the -c option, see the description in Step 2.

The new boot environment is named c0t15d0s0. The -A option creates a description that is associated with the boot environment name.

The root (/) file system is copied to the new boot environment. Also, a new swap slice is created rather than sharing the source boot environment's swap slice.


# lucreate -A 'BE_description' -c c0t4d0s0 -m /:/dev/dsk/c0t15d0s0:ufs \
-m -:/dev/dsk/c0t15d0s1:swap -n c0t15d0s0

Upgrade the Inactive Boot Environment

The inactive boot environment is named c0t15d0s0. The operating system image to be used for the upgrade is taken from the network.


# luupgrade -n c0t15d0s0 -u -s /net/ins3-svr/export/s9/combined.s9s_wos

Check If Boot Environment Is Bootable

The lustatus command reports if the boot environment creation is complete. lustatus also shows if the boot environment is bootable.


# lustatus
boot environment   Is        Active  Active     Can	    Copy
Name               Complete  Now	 OnReboot   Delete	 Status
------------------------------------------------------------------------
c0t4d0s0           yes       yes      yes      no      -
c0t15d0s0          yes       no       no       yes     -

Activate the Inactive Boot Environment

The c0t15d0s0 boot environment is made bootable with the luactivate command. The system is then rebooted and c0t15d0s0 becomes the active boot environment. The c0t4d0s0 boot environment is now inactive.


# luactivate c0t15d0s0
# init 6

Fall Back to the Source Boot Environment

Three procedures for falling back depend on your new boot environment activation situation:

Example 35–1 To Fall Back Despite Successful Boot Environment Creation

In this example, the original c0t4d0s0 boot environment is reinstated as the active boot environment although it was activated successfully. The device name is first_disk. 


# /usr/sbin/luactivate first_disk 
# init 6
Example 35–2 SPARC: To Fall Back From a Failed Boot Environment Activation

In this example, the new boot environment was not bootable. You must return to the OK prompt before booting from the original boot environment, c0t4d0s0, in single-user mode. 


OK boot net -s
# /sbin/luactivate first_disk
Do you want to fallback to activate boot environment c0t4d0s0 
(yes or no)? yes
# init 6

The original boot environment, c0t4d0s0, becomes the active boot environment.

Example 35–3 SPARC: To Fall Back to the Original Boot Environment by Using a DVD, CD, or Net Installation Image

In this example, the new boot environment was not bootable. You cannot boot from the original boot environment and must use media or a net installation image. The device is /dev/dsk/c0t4d0s0. The original boot environment, c0t4d0s0, becomes the active boot environment.


OK boot net -s
# fsck /dev/dsk/c0t4d0s0
# mount /dev/dsk/c0t4d0s0 /mnt 
# /mnt/sbin/luactivate
Do you want to fallback to activate boot environment c0t4d0s0 
(yes or no)? yes
# umount /mnt 
# init 6

Example of Detaching and Upgrading One Side of a Mirror

This example shows you how to do the following tasks:

Figure 35–1 shows the current boot environment that contains three physical disks.

Figure 35–1 Detaching and Upgrading One Side of a RAID-1 Volume (Mirror) (continued)

The context describes the illustration.

  1. Create a new boot environment, second_disk, that contains a mirror.

    The following command performs these tasks.

    • lucreate configures a UFS file system for the mount point root (/). A mirror, d10, is created. This mirror is the receptacle for the current boot environment's root (/) file system that is copied to the mirror d10. All data on the mirror d10 is overwritten.

    • Two slices, c0t1d0s0 and c0t2d0s0, are specified to be used as submirrors. These two submirrors are attached to mirror d10. 


    # lucreate -c first_disk -n second_disk \
-m /:/dev/md/dsk/d10:ufs,mirror \
-m /:/dev/dsk/c0t1d0s0:attach \
-m /:/dev/dsk/c0t2d0s0:attach

  2. Activate the second_disk boot environment.


    # /usr/sbin/luactivate second_disk
# init 6

  3. Create another boot environment, third_disk.

    The following command performs these tasks.

    • lucreate configures a UFS file system for the mount point root (/). A mirror, d20, is created.

    • Slice c0t1d0s0 is removed from its current mirror and is added to mirror d20. The contents of the submirror, the root (/) file system, are preserved and no copy occurs. 


    # lucreate -n third_disk \
-m /:/dev/md/dsk/d20:ufs,mirror \
-m /:/dev/dsk/c0t1d0s0:detach,attach,preserve

  4. Upgrade the new boot environment, third_disk, by installing a Solaris Flash archive. The archive is located on the local system. The operating systems versions for the -s and -a options are both Solaris 9 releases. All files are overwritten on third_disk except shareable files.


    # luupgrade -f -n third_disk \
-s /net/installmachine/export/solaris9/OS_image \
-a /net/server/archive/solaris9

  5. Activate the third_disk boot environment to make this boot environment the currently running system.


    # /usr/sbin/luactivate third_disk
# init 6

  6. Delete the boot environment second_disk. 


    # ludelete second_disk

  7. The following commands perform these tasks.

    • Clear mirror d10.

    • Check for the number for the concatenation of c0t2d0s0.

    • Attach the concatenation that is found by the metastat command to the mirror d20. The metattach command synchronizes the newly attached concatenation with the concatenation in mirror d20. All data on the concatenation is overwritten.


    # metaclear d10
metastat -p | grep c0t2d0s0
dnum 1 1 c0t2d0s0
metattach d20 dnum
    num

    Is the number found in the metastat command for the concatenation

The new boot environment, third_disk, has been upgraded and is the currently running system. third_disk contains the root (/) file system that is mirrored.

Figure 35–2 shows the entire process of detaching a mirror and upgrading the mirror by using the commands in the above example.

Figure 35–2 Detaching and Upgrading One Side of a RAID-1 Volume (Mirror) (continued)

The context describes the illustration.

Example of Upgrading Using Solaris Live Upgrade (Character Interface)

In this example, a new boot environment is created on a system that is running the Solaris 2.6 release. The new boot environment is upgraded to the Solaris 9 release. The upgraded boot environment is then activated.

Install Live Upgrade on the Active Boot Environment

  1. Insert the Solaris 9 DVD or Solaris 9 Software 2 of 2 CD.

  2. Run the installer for the media you are using.

    • If you are using the Solaris 9 DVD, change directories to the installer and run the installer.


      # cd /cdrom/cdrom0/Solaris_9/Tools/Installers
# ./liveupgrade20

      The Solaris Web Start installer is displayed.

    • If you are using the Solaris 9 Software 2 of 2 CD, run the installer. 


      % ./installer

      The Solaris Web Start installer displays.

  3. From the Select Type of Install panel, click Custom.

  4. On the Locale Selection panel, click the language to be installed.

  5. Choose the software to install.

    • For DVD, on the Component Selection panel, click Next to install the packages.

    • For CD, On the Product Selection panel, click Default Install for Solaris Live Upgrade and click on the other software choices to deselect them.

  6. Follow the directions on the Solaris Web Start installer panels to install the software.

Create a Boot Environment

In this example, the source boot environment is named c0t4d0s0. The root (/) file system is copied to the new boot environment. Also, a new swap slice is created rather than sharing the source boot environment's swap slice.

  1. Display the character interface:


    # /usr/sbin/lu
    Figure 35–3 Solaris Live Upgrade Main Menu

    The screen capture shows Solaris Live Upgrade tasks and the Enter and Help keys.

  2. From the main menu, select Create.


    Name of Current Boot Environment:    c0t4d0s0
Name of New Boot Environment:   c0t15d0s0

  3. Press F3.

    Figure 35–4 Solaris Live Upgrade Configuration Menu

    The screen capture lists file systems on two boot environments and shows the keys to perform tasks.

  4. From the Configuration menu, press F2 to display the Choices menu.

  5. Choose slice 0 from disk c0t15d0 for root (/).

  6. From the configuration menu, create a new slice for swap on c0t15d0 by selecting a swap slice to be split.

  7. Press F2 to display the Choices menu.

  8. Select slice 1 from disk c0t15d0 for the new swap slice.

  9. Press F3 to create the new boot environment.

Upgrade the Inactive Boot Environment

The operating system image is taken from the network for the upgrade.

  1. From the main menu, select Upgrade.


    Name of New Boot Environment:   c0t15d0s0 
Package Media: /net/ins3-svr/export/s9/combined.s9s_wos

  2. Press F3.

Activate the Inactive Boot Environment

The c0t15d0s0 boot environment is made bootable. The system is then rebooted and c0t15d0s0 becomes the active boot environment. The c0t4d0s0 boot environment is now inactive.

  1. From the main menu, select Activate.


    Name of Boot Environment: c0t15d0s0
Do you want to force a Live Upgrade sync operations: no

  2. Press F3.

  3. Press Return.

  4. Type: 


    # init 6

If a fallback is necessary, use the command-line procedures in the previous example: Fall Back to the Source Boot Environment.