Solaris 8 (Intel Platform Edition) Installation Guide

Chapter 4 Upgrading a System

This chapter describes how to upgrade an existing Solaris Intel Platform Edition system.

Note -

Before using Solaris Web Start to update or upgrade a system, refer to the Solaris 8 (Intel Platform Edition) Release Notes and Solaris 8 Installation Supplement.

Ways to Upgrade a System

When you install a new version of Solaris software on an existing Solaris system, you can choose one of the following ways to upgrade the Solaris operating environment:

Upgrade - This option merges the new version of the Solaris operating environment with the existing files on the system's disks. It saves as many modifications as possible that you have made to the previous version of the Solaris operating environment.
Initial - This option overwrites the system's disk with the new version of the Solaris operating environment. You must back up any local modifications that you have made to the previous version of the Solaris operating environment before you begin the installation and restore the local modifications after the installation is finished.

Frequently Asked Questions About Upgrading

Can I use the upgrade option on my system?

You cannot use Solaris Web Start to upgrade to Solaris 8 from Solaris 7 or earlier versions of the Solaris operating environment because it uses a different method to install Solaris software (a separate 10-Mbyte IA boot partition). You can, however, upgrade from Solaris 8 to a Solaris 8 Update or a Solaris 8 Maintenance Update.

To upgrade to Solaris 8 from an earlier version of Solaris, you must instead use the Solaris 8 Interactive Installation Program, which is described in "Using the Solaris 8 Interactive Installation Program" in Solaris 8 Advanced Installation Guide.

To determine the version of the Solaris operating environment your system is running, type:
$ uname -a

How do I know I can upgrade my system?

You can upgrade a system provided there is a separate 10-Mbyte IA boot partition on the disk. Solaris Web Start creates an IA boot partition automatically. The Solaris 8 Interactive Installation Program does not.

You also need a slice on the disk that isn't needed to upgrade that disk. swap is preferred, but any slice will suffice as long as it is not located in any of the "upgradeable" root slices listed in /etc/vfstab. The size of this slice must also exceed or equal the minimum required size, which is dynamic.

The minimum required sizes for the Solaris 8 Installation English Intel Platform Edition and Solaris 8 Installation Multilingual Intel Platform Edition CDs are shown in Table 4-1:

Table 4-1 Minimum Required Sizes for Slices


	64 Mbytes Memory	128 Mbytes Memory	256 Mbytes or More Memory
Solaris 8 Installation English Intel Platform Edition CD	256 Mbytes	256 Mbytes	256 Mbytes
Solaris 8 Installation Multilingual Intel Platform Edition CD	404 Mbytes	340 Mbytes	308 Mbytes

Do I have to back out patches before I use the upgrade option?

No, backing out packages is not required.
What if Solaris Web Start doesn't provide the upgrade option, but the system can be upgraded?

See Chapter 6, Troubleshooting for information.
What if the system's file systems don't have enough space for the upgrade?

You can reallocate disk space with Solaris Web Start if the current file systems don't have enough space for the upgrade. Solaris Web Start attempts to determine how to reallocate the disk space so the upgrade can succeed. If Solaris Web Start cannot determine how to reallocate disk space, you must manually modify the layout of the file systems.
Can I automatically upgrade to another software group?

No. For example, if you previously installed the End User System Support software group on your system, you cannot use the upgrade option to upgrade to the Developer System Support software group. However, you can always add software to the system during the upgrade that is not part of the currently installed software group.
Where does Solaris Web Start describe the local modifications that could not be preserved?
- Before the system reboots: /a/var/sadm/system/data/upgrade_cleanup
- After the system reboots: /var/sadm/system/data/upgrade_cleanup
Where does the installation program place upgrade log files?
- Before the system reboots: /a/var/sadm/system/logs/upgrade_log
- After the system reboots: /var/sadm/system/logs/upgrade_log

Upgrading Your System

To Get Started

Check the documentation:

Check the Solaris 8 (Intel Platform Edition) Release Notes and vendor release notes to ensure that the software you use is still supported in the new release.
Check the Solaris 8 (Intel Platform Edition) Hardware Compatibility List to make sure your hardware is still supported.
See the documentation that came with your system to make sure your system and devices are still supported by the new release.
Check for all the available patches you might need. The most recent patch list is provided at http://sunsolve.sun.com.

Check Table 4-2 for known problems. This list is not complete. Always check vendor and third-party software documentation for additional upgrade instructions.

Table 4-2 Software That Requires Changes Before Upgrading


Software	Problem Summary
Prestoserve	If you start the upgrade process by shutting down the system using `init 0`, you can lose data. See the Prestoserve documentation for shutdown instructions.

Determine the language you want to use to upgrade Solaris. If you use the CD labeled:
- Solaris 8 Installation English Intel Platform Edition--all prompts, messages, and other upgrade information are displayed in English only.
- Solaris 8 Installation Multilingual Intel Platform Edition--you can select one of the following languages in which to display all prompts, messages, and other upgrade information:
  - English
  - French
  - German
  - Italian
  - Japanese
  - Korean
  - Spanish
  - Swedish
  - Simplified Chinese
  - Traditional Chinese

Make sure you have at least the following CDs:
- Solaris 8 Installation English Intel Platform Edition or Solaris 8 Installation Multilingual Intel Platform Edition
- Solaris 8 Software 1 of 2 Intel Platform Edition and Solaris 8 Software 2 of 2 Intel Platform Edition
- Solaris 8 Languages Intel Platform Edition (if you use the Multilingual CD)

To Back Up a System

Caution -

Back up existing file systems before upgrading the Solaris operating environment. Copying them to removable media (such as tape) safeguards data against loss, damage, or corruption.

You can use the Solaris Web Start Specify Backup Media dialog box to back up a system on a local disk, local tape, or remote file system.

If you do not have a backup procedure in place, follow these steps to perform a full backup of file systems on tape. Backing up a system and setting up scheduled backups are described in more detail in System Administration Guide, Volume I.

Become superuser.

Shut down the system:
# init 0

Boot the system in single-user mode:
ok boot -s

Do you want to check the file systems for consistency?

Note -
Checking the file systems for consistency ensures you back up uncorrupted data. A power failure, for example, can leave files in an inconsistent state.
- If no, go to the next step.
- If yes, use the fsck command with the -m option:
  # fsck -m /dev/rdsk/device-name

Do you intend to back up the file systems onto a remote tape drive?
- If no, go to the next step.
- If yes:
1. Add the following entry to the ./rhosts file of the system that is initiating the backup:
  host root
2. Verify that the host name added to the /.rhosts file above is accessible via the local /etc/inet/hosts file or available through an NIS or NIS+ name server.

Identify the device name of the tape drive.

The default tape drive is /dev/rmt/0.

Insert a tape that is not write-protected into the tape drive.

Back up file systems using one of the ufsdump commands listed in Table 4-3.

Table 4-3 Full Backup Commands


To make a full backup on a	Use this command
Local cartridge tape drive	`ufsdump9ucf` `/dev/rmt` `files_to_backup`
Remote cartridge tape drive	`ufsdump0ucf` `remote_host`:/ `files_to_backup`

When prompted, remove the tape and replace it with the next volume.

Label each tape with the volume number, level, date, system name, and file system.

Press Control-D.

The system is returned to run level 3.

Verify that you successfully backed up the system:
# ufsrestore -t

To Plan for Upgrading

Use this decision table to determine what to do first.

If you intend to upgrade from a

Then go to

CD-ROM drive attached to your system
The next step.

Remote CD-ROM drive on a network

Solaris 8 Advanced Installation Guide.

If you intend to upgrade from a	Then go to
CD-ROM drive attached to your system	The next step.
Remote CD-ROM drive on a network	Solaris 8 Advanced Installation Guide.

If your system is attached to a network, gather the following information about the system that contains the Solaris operating environment you intend to upgrade.

Information	Example	To find the information (with Solaris installed), use
Host name	`crater`	`uname -n`
Host IP address	`129.221.2.1`	`ypmatch` `system_name` `hosts` or `nismatch` `system_name` `hosts.org_dir`
Subnet mask	`255.255.255.0`	`more /etc/netmasks`
Type of name service (DNS, NIS, or NIS+)	passwd: files nis group: files nis hosts: xfn nis [NOTFOUND=return] files networks: nis [NOTFOUND=return] files protocols: nis [NOTFOUND=return] files rpc: nis [NOTFOUND=return] files ethers: nis [NOTFOUND=return] files netmasks: nis [NOTFOUND=return] files bootparams: nis [NOTFOUND=return] files publickey: nis [NOTFOUND=return] files netgroup: nis automount: files nis aliases: files nis services: files nis sendmailvars: files	`cat /etc/nsswitch.conf`
Domain name	`lbloom.West.Arp.COM`	`domainname`
Host name of name server	`thor75`	`ypwhich`
Host IP address of name server	`129.153.75.20`	`ypmatch` `nameserver_name` `hosts` or `nismatch` `nameserver_name` `hosts.org_dir`

To Set Up for Upgrading

Do you intend to install the Solaris software through a tip(1) line?
- If no, go to the next step.
- If yes, make sure your window display is at least 80 columns wide and 24 rows long.
  
  Note -
  To determine the current dimensions of your tip window, use the stty(1) command.

Is your system capable of booting from a CD?
- If yes, ensure that the capability is turned on by using your system's BIOS setup tool.
- If no, insert the diskette labeled Solaris 8 Device Configuration Assistant Intel Platform Edition into the system's diskette drive.
  
  Note -
  You can also download the Solaris 8 Device Configuration Assistant from the Solaris Driver Connection at http://soldc.sun.com/support/drivers.

Insert the CD labeled Solaris 8 Installation English Intel Platform Edition or Solaris 8 Installation Multilingual Intel Platform Edition into the system's CD-ROM drive.

CD-ROM Drive - Tray Version	CD-ROM Drive - Caddy Version
Press the eject button on the front panel of the CD-ROM drive. A tray slides out. Insert the CD labeled Solaris 8 Installation English Intel Platform Edition or Solaris 8 Installation Multilingual Intel Platform Edition (logo facing up) into the tray. Push the tray into the CD-ROM drive.	To open the caddy, pinch the corners while lifting the lid at the center. Insert the CD labeled Solaris 8 Installation English Intel Platform Edition or Solaris 8 Installation Multilingual Intel Platform Edition (logo facing up) and close the caddy. With the arrow on the caddy pointing toward the CD-ROM drive, insert the caddy.

Boot the system by shutting it down and then turning it off and on.

A memory test and hardware detection are executed. The screen refreshes.
- If you're using the diskette labeled Solaris 8 Device Configuration Assistant Intel Platform Edition, the message:
  Solaris Boot Sector Version 1
  is displayed at the top of your screen. Then, information similar to this is displayed:
  Solaris for x86 - Generic DCB Version 1.234 loading /solaris/boot.bin
  The screen refreshes and information similar to this is displayed:
  SunOS Secondary Boot version 3.00 Solaris Intel Platform Edition Booting System Running Configuration Assistant...
- If you're using only the CD labeled Solaris 8 Installation English Intel Platform Edition or Solaris 8 Installation Multilingual Intel Platform Edition, the message:
  SunOS - Intel Platform Edition Primary Boot Subsystem, vsn 2.0
  is displayed at the top of the screen. Then, information similar to this is displayed:
  SunOS Secondary Boot version 3.00 Solaris Intel Platform Edition Booting System Running Configuration Assistant...

When the Solaris Device Configuration Assistant screen is displayed, press F2_Continue.

The Bus Enumeration screen is displayed with the message:
Determining bus types and gathering hardware configuration data ...
The Scanning Devices screen is then displayed. System devices are scanned. When scanning is complete, the Identified Devices screen is displayed.

Press F2_Continue.

The Loading screen is displayed with messages about drivers that are loaded to boot your system. After a few seconds, the Boot Solaris screen is displayed.

On the Boot Solaris screen, select CD and press F2_Continue.

If you're using the CD labeled Solaris 8 Installation English Intel Platform Edition, the Running Driver screen is displayed briefly, followed by information similar to this:

                        <<< Current Boot Parameters >>>
Boot path: /pci@0,0/pci-ide@7,1/ide@1/sd@0,0:a
Boot args: kernel/unix


                        <<< Starting Installation >>>

SunOS Release 5.8 Version Generic 32-bit
Copyright 1983-2000 Sun Microsystems, Inc.  All rights reserved.
Configuring /dev and /devices
Using RPC Bootparams for network configuration information.
Solaris Web Start 3.0 installer

English has been selected as the language in which to perform the install.
Starting the Web Start 3.0 Solaris installer

Solaris installer is searching the system's hard disks for a 
location to place the Solaris installer software.

Your system appears to be upgradeable.
Do you want to do a Initial Install or Upgrade?

  1) Initial Install
  2) Upgrade
  Please Enter 1 or 2 >

If you're using the CD labeled Solaris 8 Installation Multilingual Intel Platform Edition, information similar to this is displayed:

                        <<< Current Boot Parameters >>>
Boot path: /pci@0,0/pci-ide@7,1/ide@1/sd@0,0:a
Boot args: kernel/unix


                        <<< Starting Installation >>>

SunOS Release 5.8 Version Generic 32-bit
Copyright 1983-2000 Sun Microsystems, Inc.  All rights reserved.
Configuring /dev and /devices
Using RPC Bootparams for network configuration information.
Solaris Web Start 3.0 installer
The Solaris Installer can be run in English, or any of the following languages:

  1) English           6) Japanese
  2) German            7) Korean
  3) Spanish           8) Swedish
  4) French            9) Simplified_Chinese
  5) Italian          10) Traditional_Chinese
Select the language you want to use to run the installer:

Which installation CD are you using?

If the Solaris 8 Installation English Intel Platform Edition CD, go to the next step.
If the Solaris 8 Installation Multilingual Intel Platform Edition CD, type the number to select the language in which to display prompts, messages, and other installation information.

Information similar to this is displayed (in the language you selected):

language_you_selected has been selected as the language in which to perform the install.
Starting the Web Start 3.0 Solaris installer

Solaris installer is searching the system's hard disks for a 
location to place the Solaris installer software.

Your system appears to be upgradeable.
Do you want to do a Initial Install or Upgrade?

  1) Initial Install
  2) Upgrade
  Please Enter 1 or 2 >

At the prompt, type 2 for upgrade and press Enter.

Solaris Web Start searches the disk for swap slices that meet the minimum size requirements. Information similar to this is then displayed:

Since swap slices are usually erased at each reboot,
the Solaris Installer would prefer to place the Solaris install image
on a slice labeled swap.


The Installer would like to use the disk slice c0d0s1, labeled as swap.

WARNING: All information will be lost.

Can the Solaris Installer use this slice?  [y,n,?,q]

Do you want to use the disk slice shown on your screen?
- If yes, type y and go to Step 18.
- If no, type n and press Enter.
Solaris Web Start searches the disk for slices that meet the minimum size requirements and are not located in any of the "upgradeable" root slices listed in /etc/vfstab, as described in Table 4-1. Information similar to this is displayed:
1) c0d0s1 2) Find Another "Find Another" allows the Solaris Installer to find other slices that may meet the criteria found in the Solaris install guide. Please make a selection. >

Do you want to use the disk slice shown on your screen?

If yes, type 1 and go to Step 18.
If no, type 2 and press Return.

Solaris Web Start continues looking for another disk slice. If another disk slice is not found, the original swap shown on your screen is used by default. If another disk slice is found, information similar to this is displayed:

The following slices were found to meet the 
criteria in the Solaris Install Guide.

WARNING: If one of the listed slices is chosen
         to be used by the Solaris Installer
         all information on the slice will be
         erased

1) c0d0s7 last mounted on /export/home
2) None


"None" will skip these disk slices and present
you with a listing of all disks on the system

Please make a selection from the choices above >

Do you want to use one of the slices shown or None?

Note -

If you select None and a disk identifier, you can no longer upgrade the system. You must perform an initial installation.

If you want to use one of the slices shown, type the number of the slice you want and go to Step 18.
If None, type 2 and press Return.