JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle VM Server for SPARC 2.2 Administration Guide     Oracle VM Server for SPARC
search filter icon
search icon

Document Information

Preface

Part I Oracle VM Server for SPARC 2.2 Software

1.  Overview of the Oracle VM Server for SPARC Software

2.  Installing and Enabling Software

Installing Oracle VM Server for SPARC Software on a New System

Updating the Oracle Solaris OS

Upgrading the System Firmware

Downloading the Logical Domains Manager

How to Download the Logical Domains Manager Software (Oracle Solaris 10)

Installing the Logical Domains Manager

(Oracle Solaris 10) Automatically Installing the Logical Domains Manager Software

Manually Installing the Logical Domains Manager Software

Enabling the Logical Domains Manager Daemon

How to Enable the Logical Domains Manager Daemon

Upgrading a System That Is Already Using Oracle VM Server for SPARC

Upgrading the Oracle Solaris OS

Saving and Restoring Autosave Configuration Directories

Saving and Restoring the Logical Domains Constraints Database File

Preserving the Logical Domains Constraints Database File When Using the Oracle Solaris 10 Live Upgrade Feature

Upgrading the Logical Domains Manager and the System Firmware

How to Stop All Domains Running on the Platform, Except the Control Domain

Upgrading to Oracle VM Server for SPARC 2.2 Software

How to Upgrade to the Oracle VM Server for SPARC 2.2 Software (Oracle Solaris 10)

How to Upgrade to the Oracle VM Server for SPARC 2.2 Software (Oracle Solaris 11)

Factory Default Configuration and Disabling Logical Domains

How to Remove All Guest Domains

How to Remove All Logical Domains Configurations

How to Restore the Factory Default Configuration

How to Disable the Logical Domains Manager

How to Remove the Logical Domains Manager

How to Restore the Factory Default Configuration From the Service Processor

3.  Oracle VM Server for SPARC Security

4.  Setting Up Services and the Control Domain

5.  Setting Up Guest Domains

6.  Setting Up I/O Domains

7.  Using Virtual Disks

8.  Using Virtual Networks

9.  Migrating Domains

10.  Managing Resources

11.  Managing Domain Configurations

12.  Performing Other Administration Tasks

Part II Optional Oracle VM Server for SPARC Software

13.  Oracle VM Server for SPARC Physical-to-Virtual Conversion Tool

14.  Oracle VM Server for SPARC Configuration Assistant (Oracle Solaris 10)

15.  Using the Oracle VM Server for SPARC Management Information Base Software

16.  Logical Domains Manager Discovery

17.  Using the XML Interface With the Logical Domains Manager

Glossary

Index

Upgrading a System That Is Already Using Oracle VM Server for SPARC

This section describes the process of upgrading the Oracle Solaris OS, firmware, and Logical Domains Manager components on a system that is already using the Oracle VM Server for SPARC software.

If your system is already configured with the Oracle VM Server for SPARC software, upgrade the control domain and the existing domains. Such an upgrade enables the use of all the Oracle VM Server for SPARC 2.2 features on those domains.


Note - Before you upgrade the Oracle VM Server for SPARC software, perform the following steps:


Upgrading the Oracle Solaris OS

Refer to Required Software and Patches in Oracle VM Server for SPARC 2.2 Release Notes to find the Oracle Solaris 10 or Oracle Solaris 11 OS that you should use for this version of the Oracle VM Server for SPARC software, and the required and recommended patches for the different domains. Refer to the Oracle Solaris 10 and Oracle Solaris 11 installation guides for complete instructions on upgrading the Oracle Solaris OS.

When reinstalling the Oracle Solaris OS in the control domain, you must save and restore the Logical Domains autosave configuration data and the constraints database file, as described in this section.

Saving and Restoring Autosave Configuration Directories

You can save and restore autosave configuration directories prior to reinstalling the operating system on the control domain. Whenever you reinstall the operating system on the control domain, you must save and restore the Logical Domains autosave configuration data, which is found in the /var/opt/SUNWldm/autosave-autosave-name directories.

You can use the tar or cpio command to save and restore the entire contents of the directories.


Note - Each autosave directory includes a timestamp for the last SP configuration update for the related configuration. If you restore the autosave files, the timestamp might be out of sync. In this case, the restored autosave configurations are shown in their previous state, either [newer] or up to date.


For more information about autosave configurations, see Managing Logical Domains Configurations.

How to Save and Restore Autosave Directories

This procedure shows how to save and restore the autosave directories.

  1. Save the autosave directories.
    # cd /
    # tar -cvpf autosave.tar var/opt/SUNWldm/autosave-*
  2. (Optional) Remove the existing autosave directories to ensure a clean restore operation.

    Sometimes an autosave directory might include extraneous files, perhaps left over from a previous configuration, that might corrupt the configuration that was downloaded to the SP. In such cases, clean the autosave directory prior to the restore operation as shown in this example:

    # cd /
    # rm -rf var/opt/SUNWldm/autosave-*
  3. Restore the autosave directories.

    These commands restore the files and directories in the /var/opt/SUNWldm directory.

    # cd /
    # tar -xvpf autosave.tar

Saving and Restoring the Logical Domains Constraints Database File

Whenever you upgrade the operating system on the control domain, you must save and restore the Logical Domains constraints database file that can be found in /var/opt/SUNWldm/ldom-db.xml.


Note - Also, save and restore the /var/opt/SUNWldm/ldom-db.xml file when you perform any other operation that is destructive to the control domain's file data, such as a disk swap.


Preserving the Logical Domains Constraints Database File When Using the Oracle Solaris 10 Live Upgrade Feature

If you are using the Oracle Solaris 10 Live Upgrade feature on the control domain, consider adding the following line to the /etc/lu/synclist file:

/var/opt/SUNWldm/ldom-db.xml     OVERWRITE

This line causes the database to be copied automatically from the active boot environment to the new boot environment when you switch boot environments. For more information about /etc/lu/synclist and synchronizing files between boot environments, refer to Synchronizing Files Between Boot Environments in Oracle Solaris 10 8/11 Installation Guide: Live Upgrade and Upgrade Planning.

Upgrading the Logical Domains Manager and the System Firmware

This section shows how to upgrade to Oracle VM Server for SPARC 2.2 software.

First download the Logical Domains Manager to the control domain. See Downloading the Logical Domains Manager.

Then stop all domains (except the control domain) running on the platform:

How to Stop All Domains Running on the Platform, Except the Control Domain

Perform this task only if you plan to perform a power cycle of the system or upgrade the firmware. Performing this task is not required if you only upgrade the Logical Domains Manager software.

  1. Bring down each domain to the ok prompt.
  2. Stop all domains by using the -a option.
    primary# ldm stop-domain -a
  3. Issue the unbind-domain subcommand from the control domain for each domain.
    primary# ldm unbind-domain ldom

Upgrading to Oracle VM Server for SPARC 2.2 Software

This section explains how to upgrade to the Oracle VM Server for SPARC 2.2 software.

How to Upgrade to the Oracle VM Server for SPARC 2.2 Software (Oracle Solaris 10)

  1. Perform a flash upgrade of the system firmware.
  2. Disable the Logical Domains Manager daemon (ldmd).
    # svcadm disable ldmd
  3. Remove the old SUNWldm package.
    # pkgrm SUNWldm
  4. Add the new SUNWldm package.
    # pkgadd -Gd . SUNWldm.v

    Specifying the -d option indicates that the package is in the current directory.

  5. Use the ldm list command to verify that the Logical Domains Manager is running.

    The ldm list command should list all domains that are currently defined on the system. In particular, the primary domain should be listed and be in the active state. The following sample output shows that only the primary domain is defined on the system.

    # ldm list
    NAME             STATE    FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
    primary          active   ---c-   SP      32    3264M    0.3%  19d 9m

How to Upgrade to the Oracle VM Server for SPARC 2.2 Software (Oracle Solaris 11)

  1. Prepare your domain for a Logical Domains Manager upgrade.

    Performing the following steps enables you to “roll back” to a boot environment (BE) that runs the Oracle VM Server for SPARC 2.1 software, if necessary.

    1. Save your configuration to the SP.
      # ldm add-config config-name

      The following example saves the configuration called ldoms-2.1-config:

      # ldm add-config ldoms-2.1-config
    2. Create a snapshot of your existing BE.
      # beadm create snapshot-name

      The following example creates a snapshot called S10811@ldoms-2.1-backup:

      # beadm create S10811@ldoms-2.1-backup
    3. Create a backup BE based on the snapshot.
      # beadm create -e snapshot-name BE-name

      The following example creates a new BE called ldoms-2.1-backup from the snapshot called S10811@ldoms-2.1-backup:

      # beadm create -e S10811@ldoms-2.1-backup ldoms-2.1-backup
  2. Register to use the online software repository.

    See Certificate Generator Online Help.

  3. Install the Oracle VM Server for SPARC 2.2 version of the ldomsmanager package from the online software repository as part of an update to the latest SRU.
    # pkg update
               Packages to install:  1
                Packages to update: 89
           Create boot environment: No
    Create backup boot environment: No
                Services to change:  3
    
    PHASE                                        ACTIONS
    Removal Phase                                517/517
    Install Phase                                806/806
    Update Phase                               5325/5325
    
    PHASE                                          ITEMS
    Package State Update Phase                   179/179
    Package Cache Update Phase                     89/89
    Image State Update Phase                         2/2

    Note - For information about Oracle Solaris 11 SRUs, see Oracle Solaris 11 Support Repository Updates (SRU) Index.


  4. Verify that the package is installed.
    # pkg info ldomsmanager
    Name: system/ldoms/ldomsmanager
    Summary: Logical Domains Manager
    Description: LDoms Manager - Virtualization for SPARC T-Series
    Category: System/Virtualization
    State: Installed
    Publisher: solaris
    Version: 2.2.0.0
    Build Release: 5.11
    Branch: 0.175.0.0.0.1.0
    Packaging Date: Thu Mar 01 23:06:35 2011
    Size: 2.34 MB
    FMRI: pkg://solaris/system/ldoms/ldomsmanager@
    2.2.0.0,5.11-0.175.0.0.0.1.0:20120221T141945Z
  5. Restart the ldmd service.
    # svcadm restart ldmd
  6. Verify that you are running the correct ldm version.
    # ldm -V
  7. Save your configuration to the SP.
    # ldm add-config config-name

    The following example saves the configuration called ldoms-2.2-config:

    # ldm add-config ldoms-2.2-config