Oracle VM Template for Solaris 10 10/09 Readme =============================================== This document is applicable to Oracle VM templates for Solaris 10 on x86/x64 platforms. File Template Version -------------------- ---------------- OVM_SOLARIS10U8.tgz 1.0 This document contains: 1. Introduction 2. Prerequisites 3. Importing the Template 3.1 Importing from an Oracle VM Server 3.2 Importing from an HTTP or FTP Server 4. Creating a Virtual Machine from the Template 4.1 create virtual machine using Oracle VM manager 4.2 Create virtual machine from Oracle VM Server command line 5. Virtual Machine Configuration 6. Known Issues 1. Introduction ====================== The template is a standard default installation of the Solaris 10 10/09 OS on x86/x64 platforms. Notes for Oracle VM Template for Solaris 10 10/09 ------------------------------------------------- 1) The Solaris 10 template supports both i386 and x86_64 architecture. Running in 32-bit or 64-bit mode is decided at boot time. If Oracle VM Server hypervisor is 32-bit, the Solaris virtual machine will boot into 32-bit, if Oracle VM Server hypervisor is 64bit, the Solaris virtual machine will boot into 64-bit. To check if Solaris is running in 32 bit mode or 64 bit from command line run the following: #/usr/bin/isainfo -kv If the system is running in 32-bit mode, you will see the following output: 32-bit i386 kernel modules On a 64-bit Solaris system, you'll see: 64-bit amd64 kernel modules 2) The root file system is ZFS. 3) Solaris 10 OS runs as a hardware virtual machine (HVM) which requires HVM support (Intel VT or AMD-V) on the underlying hardware platform, but Solaris 10 OS has the paravirtualized (PV) drivers as part of the OS installed by default. 4) Applied patch 144452-01 2. Prerequisites ================ 2.1 Hardware prerequisites 1) 18GB free space on Oracle VM Server storage pool. 2) 512MB free memory size on Oracle VM Server. 3) The server has the HVM support. To check if the server is HVM capable, you can run xm info command from the dom0 of the Oracle VM server to verify if hvm is listed as the attribute of virt_caps. # xm info virt_caps : hvm 2.2 Software prerequisites Oracle VM 2.2 or above 3. Importing an Oracle VM Template into Oracle VM Manager ========================================================= There are two ways to import an Oracle VM template into Oracle VM Manager: - Import from the Oracle VM Server hard disk - Import from a remote site using HTTP or FTP 3.1 Importing from an Oracle VM Server -------------------------------------- To import an Oracle VM template into Oracle VM Manager from an Oracle VM Server: 1) Download the Oracle VM template .zip file to an Oracle VM Server and place it in the /OVS/seed_pool directory. 2) Use unzip tool to uncompress the file. For example: # cd /OVS/seed_pool # unzip V1111-1.zip 3) Extract the .tgz file. This step creates a directory with the name of the template. This directory contains the files for the template. For example: # tar -xzvf OVM_SOLARIS10U8.tgz This will create the following: /OVS/seed_pool/OVM_SOLARIS10U8 | |- System.img (OS image file) |- vm.cfg (VM configuration file) |- README 4) Log into Oracle VM Manager and navigate to the Resources tab. The Virtual Machine Templates screen is displayed. Click Import. The Source screen is displayed. 5) Choose Select from Server Pool (Discover and register) and click Next. The General Information screen is displayed. 6) Enter or select the following: Server Pool Name: Select the server pool on which the virtual machine will be located. Virtual Machine Template Name: Select the Oracle VM template to be imported. Operating System: Select the operating system of the virtual machine. Virtual Machine System Username: Enter the username used to log into the virtual machine. Virtual Machine System Password: Enter the password used to log into the virtual machine. Description: Enter a description of the virtual machine. Click Next. The Confirm Information screen is displayed. 7) Click Confirm. The Virtual Machine Template screen is displayed with a message to confirm the template is imported. 8) To make the virtual machine template available for use, select the virtual machine template and click Approve. The View Virtual Machine Template screen is displayed. Click Approve. The Oracle VM template is imported and ready for use in Oracle VM Manager. 3.2 Importing the Template ---------------------------------------- To import an Oracle VM template from an HTTP or FTP server: 1) Download the Oracle VM template .zip file to an HTTP or FTP server. 2) Use unzip tool to uncompress the file. For example: # cd /OVS/seed_pool # unzip V1111-1.zip 3) Extract the .tgz file. This step creates a directory with the name of the template. This directory contains the files for the template. For example: # cd /OVS/seed_pool # tar xzf OVM_SOLARIS10U8.tgz This will create the following: /OVS/seed_pool/OVM_SOLARIS10U8 | |- System.img (OS image file) |- vm.cfg (VM configuration file) |- README 4) Log into Oracle VM Manager and navigate to the Resources tab. The Virtual Machine Templates screen is displayed. Click Import. The Source screen is displayed. 5) Select Download from External Source (HTTP or FTP) and click Next. The General Information screen is displayed. 6) Enter or select the following general information: Server Pool Name: Select the server pool on which the virtual machine will be located. Virtual Machine Template Name: Select the Oracle VM template to be imported. Operating System: Select the operating system of the virtual machine. Virtual Machine System Username: Enter the username used to log in to the virtual machine. Virtual Machine System Password: Enter the password used to log in to the virtual machine. Description: Enter a description of the virtual machine. Click Next. The Import Information screen is displayed. 7) Enter the URL of the Oracle VM template, for example http://host/OVM_SOLARIS10U8 ftp://username:password@host/vm If you use a proxy server to connect to your HTTP or FTP server, select Use Proxy and enter the address of the proxy server. Click Next. The Confirm Information screen is displayed. 8) Click Confirm. The Virtual Machine Template screen is displayed with a message to confirm the template is imported. 9) To make the Oracle VM template available for use, select the virtual machine template and click Approve. The View Virtual Machine Template screen is displayed. Click Approve. The Oracle VM template is imported and ready for use in Oracle VM Manager. 4. Creating a Virtual Machine from the Template ====================================================== 4.1 create virtual machine using Oracle VM manager -------------------------------------------------- 1) Follow the steps in section "2. Importing an Oracle VM Template into Oracle VM Manager" to import the virtual machine template into Oracle VM Manager. 2) Log in to Oracle VM Manager and navigate to the Virtual Machines tab. Click Create Virtual Machine. The Creation Method screen is displayed. 3) Select Create virtual machine based on virtual machine template. Click Next. The Server Pool screen is displayed. 4) Select the Server Pool on which to create the virtual machine. Select an option from the Preferred Server dropdown. Click Next. The Source screen is displayed. 5) Select the template you imported in Step 1, and click Next. The Virtual Machine Information screen is displayed. 6) Enter the virtual machine name in the Virtual Machine Name field. Enter the console password in the Console Password field. Confirm the console password by entering it again in the Confirm Console Password field. Select the network Interface Card. Click Next. The Confirm Information screen is displayed. 7) Confirm the virtual machine information, and click Confirm. The Virtual Machine screen is displayed with the message "Creating Virtual Machine". 8) When the virtual machine is created, the Status changes from Creating to Powered Off. To power on the virtual machine, click Power On. 9) When the virtual machine status is changed from Initializing to Running, select the running virtual machine, and then click Console to connect the virtual machine console and enter the data required for network configuration as described in section 5. 4.2 Create virtual machine from Oracle VM Server command line ------------------------------------------------------------- 1) Log in Oracle VM Server as root, follow the step 1) ~ step 3) in section "3.1 Importing from an Oracle VM Server" to download and uncompress the template files 2) Change directory to where the virtual machine files are located # cd /OVS/seed_pool/OVM_SOLARIS10U8 3) Run the following python command to generate a new MAC address # PYTHONPATH=/opt/ovs-agent-2.3 python -c \ "from OVSCommons import randomMAC; print randomMAC()" 4) Edit the vm.cfg file and change the line starting with 'vif' to vif = [ 'type=netfront, mac=00:16:3E:xx:xx:xx', ] where 00:16:3E:xx:xx:xx is the MAC address generated in the previous step. 5) Create and boot the virtual machine from the Oracle VM Server command line. # xm create vm.cfg 6) Connect to the virtual machine's console via VNC a) find out the VNC port number by running the following on the Oracle VM Server: # xm list -l OVM_SOLARIS10U8 | grep location This will display the port number assigned to the virtual machine's VNC console. There may be more than one line, but there should be a line that looks like this: (location 0.0.0.0:5901) Use this port number (5901 in this example) when connecting from the VNC Viewer. b) Connect to the virtual machine using any VNC Viewer from a desktop machine. For example, on Linux you can run: # vncviewer : is the port number found out in step a) c) Complete the Virtual Machine configuration as described in section 5. 5. Virtual Machine Configuration ================================ When you connect to the virtual machine console, you will see the virtual machine boots up and prompt you to configure virtual machine. The following data will be required to input. - Keyboard layout - Network - Secure policy - Name service - Timezone/Country/Region/Time - Root password 6. Known Issues =============== 1) Bug [8652099] "xm suspend" command failure When do the xm suspend for a solaris guest in ovm server, may hit following issue: # xm suspend OVM_SOLARIS10U8 Error: Timeout waiting for domain 54 to suspend Usage: xm suspend Suspend a Xend managed domain # xm suspend OVM_SOLARIS10U8 Error: /usr/lib/xen/bin/xc_save 55 54 0 0 4 failed Usage: xm suspend Suspend a Xend managed domain