test

Solaris 10 11/06 Installation Guide: Solaris Live Upgrade and Upgrade Planning

Installing Solaris Flash Archives on a Boot Environment

This section provides the procedure for using Solaris Live Upgrade to install Solaris Flash archives. Installing a Solaris Flash archive overwrites all files on the new boot environment except for shared files. Archives are stored on the following media:

Note the following issues with installing and creating a Solaris Flash archive.

Description 

Example 
Caution – Caution –

When you install the Solaris OS with a Solaris Flash archive, the archive and the installation media must contain identical OS versions. If the OS versions do not match, the installation on the target system fails. Identical operating systems are necessary when you use the following keyword or command:

  • archive_location keyword in a profile

  • luupgrade command with -s, -a, -j, and -J options

For example, if the archive is the Solaris 10 operating system and you are using DVD media, then you must use Solaris 10 DVD media to install the archive.  
Caution – Caution –

A Solaris Flash archive cannot be properly created when a non-global zone is installed. The Solaris Flash feature is not compatible with the Solaris Zones feature. If you create a Solaris Flash archive in a non-global zone or create an archive in a global zone that has non-global zones installed, the resulting archive does not install properly when the archive is deployed.

 

Description 

For More Information 

For examples of the correct syntax for paths that are associated with archive storage. 

See archive_location Keyword in Solaris 10 11/06 Installation Guide: Custom JumpStart and Advanced Installations.

To use the Solaris Flash installation feature, you install a master system and create the Solaris Flash archive.  

For more information about creating an archive, see Chapter 3, Creating Solaris Flash Archives (Tasks), in Solaris 10 11/06 Installation Guide: Solaris Flash Archives (Creation and Installation).

ProcedureTo Install a Solaris Flash Archive on a Boot Environment (Character User Interface)

  1. Install the Solaris Live Upgrade SUNWlur and SUNWluu packages on your system. These packages must be from the release you are upgrading to. For step-by-step procedures, see To Install Solaris Live Upgrade With the pkgadd Command.

  2. From the Solaris Live Upgrade main menu, select Flash.

    The Flash an Inactive Boot Environment menu is displayed.

  3. Type the name of the boot environment where you want to install the Solaris Flash archive and the location of the installation media:


    Name of Boot Environment: Solaris_10
Package media: /net/install-svr/export/Solaris_10/latest

  4. Press F1 to add an archive.

    An Archive Selection submenu is displayed.


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

    This menu enables you to build a list of archives. To add or remove archives, proceed with the following steps.

    1. To add an archive to the menu, press F1.

      A Select Retrieval Method submenu is displayed.


      HTTP
NFS
Local File
Local Tape
Local Device

    2. On the Select Retrieval Method menu, select the location of the Solaris Flash archive.

      Media Selected 

      Prompt 

      HTTP 

      Specify the URL and proxy information that is needed to access the Solaris Flash archive. 

      NFS 

      Specify the path to the network file system where the Solaris Flash archive is located. You can also specify the archive file name. 

      Local file 

      Specify the path to the local file system where the Solaris Flash archive is located. 

      Local tape 

      Specify the local tape device and the position on the tape where the Solaris Flash archive is located. 

      Local device 

      Specify the local device, the path to the Solaris Flash archive, and the type of file system on which the Solaris Flash archive is located.  

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


      NFS Location:

    3. Type the path to the archive, as in the following example.


      NFS Location: host:/path/to archive.flar

    4. Press F3 to add the archive to the list.

    5. (Optional) To remove an archive from the menu, press F2.

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

  5. Press F3 to install one or more archives.

    The Solaris Flash archive is 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 User Interface).

ProcedureTo Install a Solaris Flash Archive on a Boot Environment (Command-Line Interface)

  1. Install the Solaris Live Upgrade SUNWlur and SUNWluu packages on your system. These packages must be from the release you are upgrading to. For step-by-step procedures, see To Install Solaris Live Upgrade With the pkgadd Command.

  2. 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.

  3. Type:


    # luupgrade -f -n BE_name -s os_image_path -a archive
    -f

    Indicates to install an operating system from a Solaris Flash archive.

    -n BE_name

    Specifies the name of the boot environment that is to be installed with an archive.

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

    -a archive

    Path to the Solaris Flash archive when the archive is available on the local file system. The operating system image versions that are specified with the -s option and the -a option must be identical.

Example 5–11 Installing Solaris Flash Archives on a Boot Environment (Command-Line Interface)

In this example, an archive is installed on the second_disk boot environment. The archive is located on the local system. The operating system versions for the -s and -a options are both Solaris10 11/06 releases. All files are overwritten on second_disk except shareable files. The pkgadd command adds the Solaris Live upgrade packages from the release you are upgrading to.


# pkgadd -d /server/packages SUNWlur SUNWluu
# luupgrade -f -n second_disk \ 
-s /net/installmachine/export/Solaris_10/OS_image \ 
-a /net/server/archive/10

The boot environment is ready to be activated.

ProcedureTo Install a Solaris Flash Archive With a Profile (Command-Line Interface)

This procedure provides the steps to install a Solaris Flash archive or differential archive by using a profile.

If you added locales to the profile, make sure that you have created a boot environment with additional disk space.

  1. Install the Solaris Live Upgrade SUNWlur and SUNWluu packages on your system. These packages must be from the release you are upgrading to. For step-by-step procedures, see To Install Solaris Live Upgrade With the pkgadd Command.

  2. 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.

  3. Create a profile.

    See To Create a Profile to be Used by Solaris Live Upgrade for a list of keywords that can be used in a Solaris Live Upgrade profile.

  4. Type:


    # luupgrade -f -n BE_name -s os_image_path -j profile_path
    -f

    Indicates to install an operating system from a Solaris 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_path

    Path to a JumpStart profile that is configured for a flash installation. The profile must be in a directory on the local machine. The -s option's operating system version and the Solaris Flash archive operating system version must be identical.

    The boot environment is ready to be activated.

Example 5–12 Install a Solaris Flash archive on a Boot Environment With a Profile (Command-Line Interface)

In this example, a profile provides the location of the archive to be installed. 

# profile keywords         profile values
# ----------------         -------------------
 install_type              flash_install
 archive_location          nfs installserver:/export/solaris/flasharchive/solarisarchive

After creating the profile, you can run the luupgrade command and install the archive. The -j option is used to access the profile. The pkgadd command adds the Solaris Live Upgrade packages from the release you are upgrading to.


# pkgadd -d /server/packages SUNWlur SUNWluu
# luupgrade -f -n second_disk \ 
-s /net/installmachine/export/solarisX/OS_image \ 
-j /var/tmp/profile

The boot environment is then ready to be activated. To create a profile, see To Create a Profile to be Used by Solaris Live Upgrade.

ProcedureTo Install a Solaris Flash Archive With a Profile Keyword (Command-Line Interface)

This procedure enables you to install a Solaris Flash archive and use the archive_location keyword at the command line rather than from a profile file. You can quickly retrieve an archive without the use of a profile file.

  1. Install the Solaris Live Upgrade SUNWlur and SUNWluu packages on your system. These packages must be from the release you are upgrading to. For step-by-step procedures, see To Install Solaris Live Upgrade With the pkgadd Command.

  2. 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.

  3. Type:


    # luupgrade -f -n BE_name -s os_image_path -J 'archive_location path-to-profile'
    -f

    Specifies to upgrade an operating system from a Solaris 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 'archive_location path-to-profile'

    Specifies the archive_location profile keyword and the path to the JumpStart profile. The -s option's operating system version and the Solaris Flash archive operating system version must be identical. For the keyword values, see archive_location Keyword in Solaris 10 11/06 Installation Guide: Custom JumpStart and Advanced Installations.

    The boot environment is ready to be activated.

Example 5–13 Installing a Solaris Flash Archive By Using a Profile Keyword (Command-Line Interface)

In this example, an archive is installed on the second_disk boot environment. The -J option and the archive_location keywords are used to retrieve the archive. All files are overwritten on second_disk except shareable files. The pkgadd command adds the Solaris Live Upgrade packages from the release you are upgrading to.


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