Solaris 9 Installation Guide

Installing Web Start Flash Archives on a Boot Environment

This section provides the procedure for using Solaris Live Upgrade to install Web Start Flash archives that are stored on the following:

HTTP server
FTP server - Use this path from the command line only
NFS server
Local file
Local tape
Local device, including DVD or CD

Note -

For examples of the correct syntax for paths that are associated with archive storage, see "archive_location Keyword".

Installing a Web Start Flash archive overwrites all files on the new boot environment except for shared files.

To use the Web Start Flash installation feature, you need to have installed the master system and to have created the Web Start Flash archive. For more information about Web Start Flash, see Chapter 16, Web Start Flash Installation Feature (Topics).

Upgrading Metadevices and Volumes

To upgrade or install a flash archive on a new boot environment, the device must be a physical slice. If you have a boot environment that has a file system that is mounted either on a Solaris Volume Manager metadevice or a Veritas file system (VxFS) volume, the upgrade or installation of a flash archive fails. To upgrade or install a flash archive on such a boot environment, you must manually change the boot environment so that all slices are physical disk slices. You could use the lucreate command to create another boot environment or you could tear down the metadevices or volumes.

To use the lucreate command to make a copy of the boot environment, you would place the boot environment copy on physical disk slices. For example, suppose your current boot environment's disk configuration is the following:

root (`/`)	Mounted on /dev/md/dsk/d10
`/usr`	Mounted on /dev/md/dsk/d20
`/var`	Mounted on /dev/dsk/c0t3d0s0
Free slice	c0t4d0s0
Free slice	c0t4d0s3
Free slice	c0t4d0s4

You could then use the following lucreate command to copy the boot environment on physical disk slices. The boot environment could then be upgraded or be installed with a flash archive. In this example, the current boot environment is named currentBE and the new boot environment is named nextBE.

# lucreate -s currentBE -n nextBE -m /:/dev/dsk/c0t4d0s0:ufs \
-m /usr:/dev/dsk/c0t4d0s3:ufs -m /var:/dev/dsk/c0t4d0s4:ufs

You would then be able to upgrade or install a flash archive on the new boot environment, activate it, and then re-mirror or encapsulate it manually.

If you choose to manually tear down the metadevice or volume, you would need to do the following:

Manually mount the boot environment
Edit the /etc/vfstab file to change all metadevices or volumes to physical disk slices
Use the Solaris Volume Manager or Veritas software to tear down the metadevices or volumes
Unmount the boot environment

The boot environment could then be upgraded or be installed with a flash archive.

To Install Web Start Flash Archives on a Boot Environment (Character Interface)

From the Solaris Live Upgrade main menu, select Flash.

The Flash an Inactive Boot Environment menu is displayed.

Type the name of the boot environment where you want to install the Web Start Flash archive and the location of the installation media:
Name of Boot Environment: solaris_9 Package media: /net/install-svr/export/s9/latest

Press F1 to add an archive.

An Archive Selection submenu displays an empty list, the name of a single archive, or a list of a number of archives. If more than one archive is listed, you have layered archives. For an explanation of layered archives, see "Installing Layered Web Start Flash Archives".

You can add and remove archives from the list. The following example shows an empty list.

Location            - Retrieval Method
<No Archives added> - Select ADD to add archives

To install the list with no changes, proceed to Step 4.
If the Web Start Flash archives list is empty or contains an archive that you do not want to install, proceed to Step a.

You can add or remove archives.
- Press F1 to add an archive to the list. Proceed to Step b.
  
  Note -
  If you have a list of more than one archive, you have layered archives. For more information, see "Installing Layered Web Start Flash Archives".
  
  A Select Retrieval Method submenu is displayed.
  HTTP NFS Local File Local Tape Local Device
- Press F2 to remove an archive from the list. Proceed to Step e.

On the Select Retrieval Method menu, select the location of the Web Start Flash archive.

Media Selected	Prompt
HTTP	Specify the URL and proxy information that is needed to access the Web Start Flash archive.
NFS	Specify the path to the network file system where the Web Start Flash archive is located. You can also specify the archive file name.
Local file	Specify the path to the local file system where the Web Start Flash archive is located.
Local tape	Specify the local tape device and the position on the tape where the Web Start Flash archive is located.
Local device	Specify the local device, the path to the Web Start Flash archive, and the type of file system on which the Web Start Flash archive is located.

A Retrieval submenu is displayed, similar to the following example, which depends on the media you selected.

NFS Location:

Type the path to the archive, as in the following example.
NFS Location: host:/path/to archive.flar

Press F3 to add the archive to the list.

When the list contains the archives that you want to install, press F6 to exit.

Press F3 to install the archive or layered archives.

The Web Start Flash archive or layered archives are installed on the boot environment. All files on the boot environment are overwritten, except for shareable files.

The boot environment is ready for activation. See "To Activate a Boot Environment (Character Interface)".

To Install Web Start Flash Archives on a Boot Environment (Command-Line Interface)

Type:

# luupgrade -f -n BE_name -s os_image_path -J 'profile'

You must specify one of these options: -a, -j, or -J.

`-f`	Indicates to upgrade an operating system from a flash archive.
`-n` `BE_name`	Specifies the name of the boot environment that is to be upgraded.
`-s` `os_image_path`	Specifies the path name of a directory that contains an operating system image. This directory can be on an installation medium, such as a DVD-ROM, CD-ROM, or it can be an NFS or UFS directory.
`-J` '`profile`'	Entry from a JumpStart profile that is configured for a flash installation. See pfinstall(1M) and Chapter 21, Custom JumpStart Installation (Topics) for information on the JumpStart software. You must specify one of `-a`, `-j`, or `-J`.
`-j` `profile_path`	Path to a JumpStart profile that is configured for a flash installation. See pfinstall(1M) and Chapter 21, Custom JumpStart Installation (Topics) for information on the JumpStart software. You must specify one of `-a`, `-j`, or `-J`.
`-a` `archive`	Path to the flash archive when the archive is available on the local file system. You must specify one of `-a`, `-j`, or `-J`.

Example 33-3 Installing Web Start Flash Archives on a Boot Environment (Command-Line Interface)

In this example, a flash archive is installed on the second_disk boot environment. The -J option is used to retrieve the archives. All files are overwritten on second_disk except shareable files.

# luupgrade -f -n second_disk \
-s /net/installmachine/export/solarisX/OS_image \
-J 'archive_location http://example.com/myflash.flar'