Installing Oracle VM Server for SPARC Software on a New System

Oracle's Sun platforms that support the Oracle VM Server for SPARC software come preinstalled with the Oracle Solaris 10 OS. Initially, the platform appears as a single system hosting only one operating system. After the Oracle Solaris OS, system firmware, and Logical Domains Manager have been installed, the original system and instance of the Oracle Solaris OS become the control domain. That first domain of the platform is named primary, and you cannot change that name or destroy that domain. From there, the platform can be reconfigured to have multiple domains hosting different instances of the Oracle Solaris OS.

Updating the Oracle Solaris OS

On a brand new system, you might want to reinstall the factory-installed OS to conform to your installation policy. See Required and Recommended Oracle Solaris OS in Oracle VM Server for SPARC 2.1 Release Notes. For complete Oracle Solaris OS installation instructions, see the Oracle Solaris 10 9/10 Release and Installation documentation. You can tailor the installation to the requirements of your system.

If your system is already installed with the Oracle Solaris OS, you must upgrade it to the OS version that is associated with the Oracle VM Server for SPARC 2.1 software. See Required Software and Patches in Oracle VM Server for SPARC 2.1 Release Notes. For complete Oracle Solaris OS upgrade instructions, see the Oracle Solaris 10 9/10 Release and Installation documentation.

Upgrading the System Firmware

The following tasks describe how to upgrade system firmware by using the Integrated Lights Out Manager (ILOM) software.

For information about upgrading the system firmware by using the ILOM software, see “Update the Firmware” in Sun SPARC Enterprise T5120 and T5220 Servers Topic Set and “Updating ILOM Firmware” in the Sun Integrated Lights Out Manager (ILOM) 3.0 CLI Procedures Guide.

Upgrade System Firmware

You can find system firmware for your platform at http://www.oracle.com/technetwork/systems/patches/firmware/index.html.

For information about the required system firmware for the supported servers, see Required and Recommended System Firmware Patches in Oracle VM Server for SPARC 2.1 Release Notes.

To upgrade the system firmware from the control domain, refer to your system firmware release notes.

Refer to the administration guides or product notes for the supported servers for more information about installing and upgrading the system firmware for these servers.

You can also use the ILOM web interface to upgrade system firmware, see “Updating ILOM Firmware” in the Sun Integrated Lights Out Manager (ILOM) 3.0 Web Interface Procedures Guide.

1. Download the system firmware image to another system that is running the tftp service.
   1. Ensure that the tftp service is online on the server.

      # svcs tftp/udp6
      STATE          STIME    FMRI
      online         Mar_26   svc:/network/tftp/udp6:default

   2. Enable the tftp service if it is not in the online state.

      # svcadm enable tftp/udp6

   3. Download the system firmware image to the /tftpboot directory.
2. Ensure that the ILOM service processor network management port is configured.

   This configuration is required to access the new flash image over the network. See “To Configure the Service Processor Network Management Port” in Sun SPARC Enterprise T5120 and T5220 Servers Topic Set and “Updating ILOM Firmware” in the Sun Integrated Lights Out Manager (ILOM) 3.0 CLI Procedures Guide.

3. Open an SSH session to connect to the service processor.

   $ ssh root@system-name
   ...
   Are you sure you want to continue connecting (yes/no)? yes
   ...
   Password: password
   ...
   ->

4. Verify that the host is powered off.
   1. Type the following command:

      -> show /SYS power_state

   2. If the host is not powered off, type the following command:

      -> stop /SYS

5. Verify that the keyswitch_state parameter is set to normal.
   1. Type the following command:

      -> show /SYS keyswitch_state

   2. If the value is other than normal, set it by using the following command:

      -> set /SYS keyswitch_state=normal

6. Upgrade the service processor flash image and the host firmware.

   -> load -source \ tftp://IP-addr/pathname/Sun_System_Firmware-x_x_x_build_nn-server-name.pkg

   The -source option specifies the IP address and full path name (URL) to the system firmware flash image.

   • IP-addr is the IP address of a tftp server on the network that can access the flash image.

   • pathname is the full path name to the flash image on the tftp server.

   • x_x_x is the version number of the system firmware

   • nn is the build number that applies to this release.

   • server-name is the name of your server.

     For example, for the SPARC Enterprise T5440 server, server-name is SPARC_Enterprise_T5440.

   For example, the -source tftp://192.168.1.1/Sun_System_Firmware-7_3_0-SPARC_Enterprise_T5440.pkg option points to the /tftpboot/Sun_System_Firmware-7_3_0-SPARC_Enterprise_T5440.pkg file on the server with the 192.168.1.1 IP address.

   After the flash image has been upgraded, the system automatically resets.

   The service processor resets, runs diagnostics, and returns to the login prompt (on the serial console).

Downloading the Logical Domains Manager

Download the Software

1. Download the zip file (OVM_Server_SPARC-2_1.zip).

   You can find the software at http://www.oracle.com/virtualization/index.html.

2. Unzip the zip file.

   $ unzip OVM_Server_SPARC-2_1.zip

   See Location of Oracle VM Server for SPARC 2.1 Software in Oracle VM Server for SPARC 2.1 Release Notes for details about the structure of the file and what it includes.

Installing the Logical Domains Manager

There are three methods of installing the Logical Domains Manager software:

• Using the installation script to install the packages and patches. This automatically installs the Logical Domains Manager software. See Installing the Logical Domains Manager Software Automatically.

• Using JumpStart to install the packages as part of an Oracle Solaris network installation. See Using JumpStart to Install the Oracle VM Server for SPARC 2.1 Software.

• Installing the package manually. See Installing the Logical Domains Manager Software Manually.

Installing the Logical Domains Manager Software Automatically

If you use the install-ldm installation script, you have several choices to specify how you want the script to run. Each choice is described in the procedures that follow.

• Using the install-ldm script with no options does the following automatically:

  • Checks that the Oracle Solaris OS release is Oracle Solaris 10 9/10 OS at a minimum

  • Verifies that the package subdirectories SUNWldm/ and SUNWldmp2v/ are present

  • Verifies that the prerequisite Logical Domains driver packages, SUNWldomr and SUNWldomu, are present

  • Verifies that the SUNWldm and SUNWldmp2v packages have not been installed

  • Installs the Oracle VM Server for SPARC 2.1 software

  • Verifies that all packages are installed

  • If the SST (SUNWjass) is already installed, you are prompted to harden the Oracle Solaris OS on the control domain.

  • Determine whether to use the Oracle VM Server for SPARC Configuration Assistant (ldmconfig) to perform the installation.

• Using the install-ldm script with the -c option automatically runs the Oracle VM Server for SPARC Configuration Assistant after the software is installed.

• Using the install-ldm script with the -s option skips the running of the Oracle VM Server for SPARC Configuration Assistant.

• Using the install-ldm script and the following options with the SST software enables you to do the following:

  • install-ldm -d. Allows you to specify a SST driver other than a driver ending with -secure.driver. This option automatically performs all the functions listed in the preceding choice and hardens the Oracle Solaris OS on the control domain with the SST customized driver that you specify; for example, the server-secure-myname.driver.

  • install-ldm -d none. Specifies that you do not want to harden the Oracle Solaris OS running on your control domain by using the SST. This option automatically performs all the functions except hardening listed in the preceding choices. Bypassing the use of the SST is not suggested and should only be done when you intend to harden your control domain using an alternate process.

  • install-ldm -p. Specifies that you only want to perform the post-installation actions of enabling the Logical Domains Manager daemon (ldmd) and running the SST. For example, you would use this option if the SUNWldm and SUNWjass packages are preinstalled on your server.

Using JumpStart to Install the Oracle VM Server for SPARC 2.1 Software

See JumpStart Technology: Effective Use in the Solaris Operating Environment for complete information about using JumpStart.

Set Up a JumpStart Server

If you have not already set up a JumpStart server, you must do so. See the Oracle Solaris 10 9/10 Installation Guide: Custom JumpStart and Advanced Installations for complete information about this procedure.

1. Refer to the Oracle Solaris 10 9/10 Installation Guide: Custom JumpStart and Advanced Installations.

   Perform the following steps:

   1. See Task Map: Preparing Custom JumpStart Installations in Oracle Solaris 10 9/10 Installation Guide: Custom JumpStart and Advanced Installations.
   2. Set up networked systems with the procedures in “Creating a Profile Server for Network Systems.”
   3. Create a profile with the procedure in “Creating a Profile,” and add a line to the profile to install the SUNWldm.v package by using the package profile keyword.

      For example, add the following line to your profile to install the SUNWldm.v package from the extra directory from the HTTP server 192.168.254.255.

      package        SUNWldm.v http://192.168.254.255/extra timeout 5

   4. Create the rules file with the procedure in “Creating the rules File.”
2. Validate the rules file with the procedure in “Validating the rules File.”

Installing the Logical Domains Manager Software Manually

Install the Oracle VM Server for SPARC 2.1 Software Manually

Before You Begin

Download the Oracle VM Server for SPARC 2.1 software (the SUNWldm and SUNWldmp2v packages). See Download the Software for specific instructions.

1. Use the pkgadd command to install the SUNWldm.v and SUNWldmp2v packages.

   For more information about the pkgadd command, see the pkgadd(1M) man page.

   The -G option installs the package in the global zone only and the -d option specifies the path to the directory that contains the SUNWldm.v and SUNWldmp2v packages.

   # pkgadd -Gd . SUNWldm.v SUNWldmp2v

2. Answer y for yes to all questions in the interactive prompts.
3. Use the pkginfo command to verify that the Oracle VM Server for SPARC 2.1 packages, SUNWldm and SUNWldmp2v, are installed.

   For more information about the pkginfo command, see the pkginfo(1) man page.

   The revision (REV) information shown below is an example.

   # pkginfo -l SUNWldm | grep VERSION
   VERSION=2.1,REV=2011.03.03.10.20

Enabling the Logical Domains Manager Daemon

The install-ldm installation script automatically enables the Logical Domains Manager daemon (ldmd). The ldmd daemon is also automatically enabled when the SUNWldm package is installed. When enabled, you can create, modify, and control the logical domains.

Enable the Logical Domains Manager Daemon

Use this procedure to enable the ldmd daemon if it has been disabled.

1. Use the svcadm command to enable the Logical Domains Manager daemon, ldmd.

   For more information about the svcadm command, see the svcadm(1M) man page.

   # svcadm enable ldmd

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

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