.

Installing and Configuring Logical Domains (LDoms)

for the SolarisTM 10 OS

Vijay Shankar Upreti

March 2009

A BigAdmin Community-Submitted Article

Copyright © 2009 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. Use is subject to license terms. This distribution may include materials developed by third parties.

Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and in other countries, exclusively licensed through X/Open Company, Ltd. X/Open is a registered trademark of X/Open Company, Ltd.

All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the United States and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc.

Sun, Sun Microsystems, the Sun logo, BluePrints, JumpStart, OpenBoot, Solaris, Sun Fire, and SunSolve are trademarks or registered trademarks of Sun Microsystems, Inc. or its subsidiaries in the United States and other countries.

This product is covered and controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited.

DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 2

Table of ContentsIntroduction................................................................................................................................................4Procedure...................................................................................................................................................4For More Information..............................................................................................................................13Licensing Information..............................................................................................................................14

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 3

IntroductionThis article provides a procedure for installing and configuring Logical Domains (LDoms) and LDoms Manager 1.0.3 software on systems that use UltraSPARC® T1 or UltraSPARC T2 processors.

Note: This procedure has been tested on the Solaris™ 10 5/08 Operating System.

Procedure1. Download LDoms Manager 1.0.3 from http://www.sun.com/ldoms.

2. Make sure the hypervisor and OpenBoot™ PROM (OBP) versions are at the minimum required version: System Firmware version 6.5 for an UltraSPARC T1 processor-based platform or System Firmware version 7.0 for an UltraSPARC T2 processor-based platform.

Figure 1: Checking the Hypervisor and OpenBoot PROM Version

3. Add any patches recommended in the Logical Domains (LDoms) 1.0.3 Release Notes (http://dlc.sun.com/pdf/820-4895-10/820-4895-10.pdf). Refer to the “Required and Recommended Software” section to find the Solaris 10 OS that you should use for version 1.0.3 of the LDoms software.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 4

Figure 2: Determining the Required Software Version

4. Unzip the downloaded software.

Figure 3: Unzipping Downloaded Software

5. Run the installation script with the -d none option to specify not to harden your system using a Solaris Security Toolkit driver. This action is done intentionally to avoid any issues with Solaris JumpStart™ software. A security driver can be applied after the guest domain OS is installed using the control domain as the JumpStart server.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 5

Figure 4: Running the Installation Script

Figure 5: Installation Script Completed Successfully

Figure 5 shows that the security toolkit is installed but not applied.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 6

6. Make sure the ldmd daemon is running by using the ps -ef | grep ldmd command. If it is not, run the following command:

svcadm enable ldmd

7. Now perform the initial LDoms configuration:

a) Set the following environment variables:

$ PATH=$PATH:/opt/SUNWldm/bin; export PATH (for Bourne or K shell)$ MANPATH=$MANPATH:/opt/SUNWldm/man; export MANPATH

b) Create a virtual disk server (vds) to allow importing virtual disks into a logical domain.

c) Create a virtual console concentrator service (vcc) for use by the virtual network terminal server daemon (vntsd) and as a concentrator for all logical domain consoles.

Figure 6: Performing Initial LDoms Configuration

8. Determine the MAC address of the primary interface (or whichever interface will be used for setting up the LDoms configuration), and create a virtual switch service (vsw) to enable networking between the virtual network (vnet) devices in the logical domains.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 7

Figure 7: Creating a Virtual Switch Service

9. To set up the control domain, assign resources (mau, memory, and cpu) to the control domain.

Figure 8: Setting up the Control Domain

Figure 8 shows that the factory-default configuration set is currently being used and the initial configuration set will be used once you reboot.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 8

10. Create the /reconfigure file to force the system to reconfigure and then reboot.

Figure 9: Making a Reconfiguration Boot to the Host

11. Configure vsw0 as a primary interface to the network and subsequently enable the Virtual Network Terminal Server Daemon, vntsd.

Figure 10: Configuring the Primary Interface

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 9

Figure 11: Enabling the Virtual Network Terminal Server Daemon

12. Now configure the LDoms guest domain as follows (see Figure 12):

a. Create an empty block file of 15 Gbytes under /export/home as LDG1 to make a device for the guest domain:

mkfile 15G /export/home/LDG1

b. Set up the guest domain name (ldg1).c. Allocate virtual CPU. d. Allocate memory.e. Configure the virtual network. f. Configure the virtual disk.g. Configure OpenBoot PROM settings.h. Bind the guest domain.i. Start the guest domain.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 10

Figure 12: Configuring the LDoms Guest Domain

13. After the guest domain configuration is done, run telnet localhost 5000 to connect to the ok> prompt of the guest domain.

Figure 13: Connecting to the Guest Domain Prompt

14. Type the command boot vnet1 (as shown in Figure 13) and get the ethernet address it looks for when booting from the network. Then add the same ethernet address to the Solaris JumpStart server setup on the control domain, as shown in Figure 14.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 11

Figure 14: Adding the Ethernet Address

15. Make sure entries for ldg1 are under the /etc/hosts file and corresponding the IP address is assigned for the host name ldg1. Verify that all Solaris JumpStart configuration parameters and files are in place.

Figure 15: Verifying All Solaris JumpStart Configuration Parameters and Files

16. Install the Solaris OS in the guest domain (ldg1) using the Solaris JumpStart server (shown in Figure 16).

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 12

Figure 16: Installing the Solaris OS

17. After the installation is complete, run the following command to apply the security driver:

/opt/SUNWjass/bin/jass-execute -d secure.driver

Alternatively, you can use install/install-ldm -p.

For More InformationHere are some additional resources:

● Logical Domains (LDoms) 1.0.3 Administration Guide

http://dlc.sun.com/pdf/820-4894-10/820-4894-10.pdf

● Logical Domains (LDoms) 1.0.3 Release Notes

http://dlc.sun.com/pdf/820-4895-10/820-4895-10.pdf

● Other product documentation at http://docs.sun.com

or Documentation Center: http://www.sun.com/documentation/

● Logical Domains (LDoms) 1.1 Software for Sun's CoolThreads (CMT) Servers

http://www.sun.com/servers/coolthreads/ldoms/index.jsp

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 13

● Logical Domains (LDoms) Resources for System Administrators on BigAdmin: http://www.sun.com/bigadmin/hubs/ldoms/

Virtualization Resources for System Administrators on BigAdmin: http://www.sun.com/bigadmin/topics/virtualization/

● Sun Firmware Releases for SPARC Systems (including OpenBoot)

http://www.sun.com/bigadmin/patches/firmware/naming.jsp

● Sun download site: http://www.sun.com/download/

● Sun training courses at http://www.sun.com/training/, for example:

● Sun Virtualization: Solaris 10 Logical Domains Administration (SA-345-S10)

● LDom Installation and Configuration for UltraSPARC T1-Based Systems (WET-6343)

● Forums such as:

● Sun forums: http://forums.sun.com/index.jspa

● BigAdmin Discussions collection: http://www.sun.com/bigadmin/discussions/

● Sun wikis such as:

● Sun BluePrints™ wiki: http://wikis.sun.com/display/BluePrints/Main

● BigAdmin wiki: http://wikis.sun.com/display/BigAdmin/Home

● Support:

● Sun resources:

● Register your Sun gear: https://inventory.sun.com/inventory/

● Services: http://www.sun.com/service

● SunSolveSM: http://sunsolve.sun.com

● Community system administration experts: http://www.sun.com/bigadmin/content/communityexperts

● Events of interest to users of Sun products:

● Worldwide Developer Events and Sun Tech Days: http://developers.sun.com/events/

● Current Events: http://www.sun.com/events/index.jsp

Licensing InformationUnless otherwise specified, the use of this software is authorized pursuant to the terms of the license found at http://www.sun.com/bigadmin/common/berkeley_license.html.

This content is submitted by a BigAdmin user. It has not been reviewed for technical accuracy by Sun Microsystems, though it may have been lightly edited to improve readability. If you find an error or would like to comment on the article, please contact the submitter or use the comment link at the bottom of the article landing page.

Installing and Configuring Logical Domains (LDoms) for the Solaris 10 OS 14