Skip Headers
Oracle® VM Manager User's Guide
Release 2.2

Part Number E15441-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

6 Managing Virtual Machines

A virtual machine contains a guest operating system and some preinstalled applications. It runs on a Virtual Machine Server.

Before you create a new virtual machine, ensure that the following resources are available:

This Chapter describes how to create and use virtual machines. It includes the following sections:

Note:

As a user with the User role, you can only manage your virtual machines, and cannot manage virtual machines created by other users. Only the Manager or the Administrator can manage all the virtual machines in the server pool.

6.1 Overview of Virtual Machines

Virtual machines in Oracle VM Manager have various types and statuses during the life cycle. This section introduces virtual machine types and statuses and contains:

6.1.1 Virtual Machine Types

This section describes the following types of virtual machines in Oracle VM Manager:

  • Private Virtual Machine: By default, a virtual machine belongs to the user who created it. Only the user who created the virtual machine can view and manage the virtual machine. The My Workspace group contains all the private virtual machines which the user has created.

  • Shared Virtual Machine: You can share virtual machines with members of specific groups. For example, when you deploy a virtual machine, you can grant access rights to members of another group. Such a virtual machine is then known as a shared virtual machine.

  • Public Virtual Machine: Virtual machines that are shared among all users are known as public virtual machines. Everyone can view and deploy public virtual machines.

Note:

Users with the User role and Manager role may be restricted from accessing some specific virtual machines.

6.1.2 Virtual Machine Statuses

The status of a virtual machine reflects the operation process which the virtual machine is undergoing.

The status of a virtual machine can be one of the following:

6.1.2.1 Creating

When the creation of a virtual machine is triggered, its status is set to Creating. This status indicates that the virtual machine is being created, and cannot be used.

6.1.2.2 Initializing and Running

When you start a virtual machine, the status changes from Powered Off to Initializing. Periodically refresh the virtual machine until the status changes from Initializing to Running. Now, you can log on to the running virtual machine, or perform live migration.

6.1.2.3 Pausing, Paused and Unpausing

After you pause a running virtual machine to stop it temporarily, its status changes from Running to Pausing. Periodically refresh the virtual machine until the status changes from Pausing to Paused.

When you unpause the virtual machine, the status changes from Paused to Unpausing. Periodically refresh the virtual machine until the status changes from Unpausing to Running.

6.1.2.4 Suspending, Suspended and Resuming

After you suspend a running virtual machine, its status changes from Running to Suspending. Periodically refresh the virtual machine until the status changes from Suspending to Suspended.

When you resume the suspended virtual machine, the status changes from Suspended to Resuming. Periodically refresh the virtual machine until the status changes from Resuming to Running.

6.1.2.5 Shutting Down and Powered Off

After you shut down a virtual machine, its status changes from Running to Shutting Down. Periodically refresh the virtual machine until the status changes from Shutting Down to Powered Off.

A virtual machine with the Powered Off status is available for deploying, cloning, or starting.

6.1.2.6 Saving

When you save a virtual machine as a template, the status of the original virtual machine is set to Saving. Periodically refresh the virtual machine until the status changes from Saving to Powered Off.

6.1.2.7 Cloning

During the cloning process, the status of the original virtual machine, based on which you clone the virtual machines, is set to the Cloning status. Periodically refresh the virtual machine until the status changes from Cloning to Powered Off.

6.1.2.8 Migrating

When you perform live migration, the status of the virtual machines changes from Running to Migrating. Periodically refresh the virtual machine until the status changes from Migrating to Running.

6.1.2.9 Error

The Error status indicates that there are some errors with the virtual machine, and it cannot be used. To solve the problem:

  1. On the Virtual Machines page, click the Show link of the virtual machine and check the error log information for more details. See Appendix D, "The Status of the Virtual Machine Is Error".

  2. Shut down the virtual machine, and then retry your operation.

  3. If the error persists, delete the virtual machine and create a new one.

Figure 6-1 Virtual Machine Status Mechanism

Description of Figure 6-1 follows
Description of "Figure 6-1 Virtual Machine Status Mechanism"

6.1.3 Life Cycle Management of a Virtual Machine

Typically, the life cycle of a virtual machine consists of the following process:

  1. Creating a Virtual Machine

  2. Starting a Virtual Machine

  3. Connecting to a Virtual Machine's Console (to access the virtual machine itself)

  4. Shutting Down a Virtual Machine (to reduce system resource consumption when the virtual machine is not in use)

  5. Deleting a Virtual Machine (when you no longer require the virtual machine)

The life cycle of a virtual machine created from template is slightly different from the one created from installation media, as shown in Figure 6-2 and Figure 6-3.

Figure 6-2 Life Cycle of a Virtual Machine Created from Template

Description of Figure 6-2 follows
Description of "Figure 6-2 Life Cycle of a Virtual Machine Created from Template"

Figure 6-3 Life Cycle of a Virtual Machine Created from Installation Media

Description of Figure 6-3 follows
Description of "Figure 6-3 Life Cycle of a Virtual Machine Created from Installation Media"

During the life cycle of the virtual machine, the following actions can be taken:

6.1.4 Viewing Virtual Machine Logs

Any standard operational or error messages that may occur when you create or run a virtual machine are logged in Oracle VM Manager. The logs provides you with essential details for troubleshooting.

To view the log information, go to the Virtual Machines page, click the Show link, and click the Log link. The number displayed here reflects the number of log items.

The log information includes:

  • The time the message was generated.

  • The log level of the message:

    • INFO denotes a normal operational message and is informational only.

    • WARNING denotes a more serious message that may require your attention to resolve.

    • ERROR denotes an error occurred.

  • The target, or virtual machine name.

  • The operation that generated the message.

  • The message.

Appendix D, "The Status of the Virtual Machine Is Error" describes the error messages and how to use these to troubleshoot problems.

6.2 Supported Guest Operating Systems

An operating system installed inside a virtual machine is known as a guest operating system. Oracle VM supports a variety of guest operating systems. For information on supported guest operating system, see the Oracle VM Server Release Notes.

6.3 Creating a Virtual Machine

Depending on what resources you have, you can obtain a virtual machine by using one of the following methods:

Before creating a new virtual machine, you must have a server pool that contains a Virtual Machine Server. See Section 3.2, "Creating a Server Pool" for information on creating server pools, and Section 4.1, "Adding a Server" for information on adding more Virtual Machine Servers.

Figure 6-4 shows the basic steps required to create a new virtual machine.

Figure 6-4 Basic Steps to Create a New Virtual Machine

Description of Figure 6-4 follows
Description of "Figure 6-4 Basic Steps to Create a New Virtual Machine"

6.3.1 Creating Virtual Machine From a Template

Typically, a virtual machine template can contain:

  • An operating system

  • The basic configuration, such as the number of virtual CPUs, the amount of memory, the size of disk, and so on

  • Preinstalled applications

You can create a virtual machine template by:

You can create a virtual machine by cloning a template. The virtual machine inherits all the content and configuration from the template.

To create a virtual machine based on a template:

  1. Click Create Virtual Machine on the Virtual Machines page.

  2. Select Create virtual machine based on virtual machine template. Click Next.

  3. Select the server pool from the Server Pool table in which to create the virtual machine.

    Select the preferred server on which to run the virtual machine from the Preferred Server drop down. A preferred server is a Virtual Machine Server that provides resources such as memory, CPUs, virtual network interfaces (VIFs), and disk for the virtual machine. If you select only one Virtual Machine Server as the preferred server, the virtual machine then always starts from and runs on this server. If you select multiple preferred servers, each time the virtual machine starts, it will choose to run on the one with the maximum resources available (including memory and CPU).

    When creating a virtual machine, there are two ways to select a Virtual Machine Server for the virtual machine:

    • Auto: In the Auto mode, when the virtual machine starts, Oracle VM automatically assigns a Virtual Machine Server with the maximum resources available to run the virtual machine. The virtual machine then runs on this Virtual Machine Server temporarily, until it is shut down.

    • Manual: In the Manual mode, you select one or more Virtual Machine Servers as the preferred servers. The virtual machine then starts from and runs on the preferred server with the maximum resources available.

      Note:

      If none of the preferred servers can provide sufficient resources, the virtual machine may fail to start.

    Click Next.

  4. Select the template to be used to create the virtual machine. Click the Show link to display more detailed information about the template, such as the memory size, number of virtual CPUs, virtualization mode, and operating system. Click Next.

  5. Enter the following information for the virtual machine:

    • Virtual Machine Name: Enter a unique name for the virtual machine. The name is used to create the directory under /OVS/running_pool on the Virtual Machine Server, where the files associated with this virtual machine are stored.

      A virtual machine name must consist of alphanumeric characters, and must not contain spaces or special characters, except the underscore (_) or hyphen (-) characters. The maximum name length is 200 characters.

    • Console Password: Set the console password used connect to the virtual machine from VNC. The console password requires at least 8 characters, comprising of at least one letter and one number.

    • Confirm Console Password: Re-enter the console password.

    • High Availability: If you want to enable high availability (HA) for this virtual machine, select this checkbox. For more information about high availability, see Section 3.5, "Enabling High Availability (HA)".

    • To add more virtual network interfaces (NICs), click Add Row in the Network Interface Card table. By default, virtual network interfaces are named VIF0, VIF1, VIF2, and so on. You can rename them after creating the virtual machine. See Section 6.7.2, "Network". Oracle VM automatically assigns a random MAC address to the virtual network interface.

      Select a bridge from the Bridge drop down for the virtual network interface. By default, the number of bridges is the same as that of physical adaptors, and the bridges are named after physical adaptors. For example, if the Virtual Machine Server has several physical adaptors, eth0, eth1, eth2, and so on, the bridges are then named xenbr0, xenbr1, xenbr2, and so on.

      When creating a virtual machine, you can set a maximum of three virtual network interfaces. After the virtual machine is created, you can set a maximum of eight virtual network interfaces. See Section 6.7.2, "Network".

    Click Next.

  6. Confirm the virtual machine information on the Confirm Information page and click Confirm.

  7. The virtual machine is created. Periodically click Refresh, or set the page refresh rate to 30 seconds until the status of the virtual machine changes from Creating to Powered Off.

    If the status is Error, refer to Section 6.1.2.9, "Error" for help troubleshooting the error.

Now you can start and log in to the virtual machine. By default, the virtual machine is private, and only you can access it.

To view detailed information about the virtual machine, click Show in the list of virtual machines in the Virtual Machines table.

Some parameters of the virtual machine, such as the virtual network interface and the boot source, are set by default. You cannot change them during the process of creating the virtual machine. If you want to change them after creating the virtual machine, see Section 6.7, "Editing a Virtual Machine".

6.3.2 Creating a Virtual Machine From Installation Media

If you have ISO files available, you can create a virtual machine from the installation media (ISO file), and manually configure the operating system parameters. To create a virtual machine from installation media:

  1. Click Create Virtual Machine on the Virtual Machines page.

  2. Select Create from installation media. Click Next.

  3. Select the server pool from the Server Pool table in which to create the virtual machine.

    Select the preferred server on which to run the virtual machine from the Preferred Server drop down. Select Auto to automatically assign the virtual machine to a Virtual Machine Server, or select Manual to specify one or more preferred servers manually. For more information on preferred servers, see Step 3 in Section 6.3.1, "Creating Virtual Machine From a Template".

    Click Next.

  4. Select the virtualization method from the Virtualization Method drop down:

    • Fully Virtualized: Enables you to select an ISO file from which to create the virtual machine. For more information on supported guest operating systems, see Oracle VM Server User's Guide.

      If you require more than one ISO file to create the virtual machine, select the first ISO file. After creating the virtual machine, you need to log in to the virtual machine to install the guest operating system. See Section 6.5.2, "Logging In to a Virtual Machine".

      See Also:

      For more information on importing ISO files, refer to Section 5.3.1, "Importing an ISO File".

      Note:

      If you use the Oracle VM Server ISO image to create a virtual machine you cannot start it.

      In the fully virtualized method (also known as a hardware virtualized machine or HVM), the unmodified guest operating system runs on the virtual machine. It traps and emulates every I/O and hardware instruction.

      To apply the fully virtualized mode, you must have either an Intel processor with Virtualization Technology (VT) extension, or an AMD processor with Secure Virtual Machine (SVM) extension (also called AMD-V) available on the host. A complete list of compatible processors is available at:

      http://wiki.xensource.com/xenwiki/HVM_Compatible_Processors
      

      Note:

      Make sure the CPU and operating system support HVM, and you have enabled it in the BIOS. For more information, see Appendix D, "Cannot Create a Virtual Machine from Installation Media".

      If the CPU does not support HVM, use the paravirtualized method to create the virtual machine.

    • Paravirtualized: Enables you to select a location for the mounted ISO file from which to create the virtual machine. Before you create the virtual machine using the paravirtualized method, mount the ISO file on an NFS share, or HTTP or FTP server:

      # mkdir mount-point
      # mount -o loop,ro cd1.iso mount-point
      

      Where mount-point refers to the directory to which you want to mount the files. If you have multiple ISO files, you can mount each ISO file and copy the contents into a single directory, and then mount that directory.

      In the Resource Location field, enter the full path of the mount point. HTTP, FTP, and NFS are supported. For example, enter a path similar to the following:

      http://example.com/EL5-x86
      

      In the paravirtualized method, the guest operating system is recompiled before being installed on a virtual machine. Also, the virtual machine does not need to trap privileged instructions. Trapping is a method used to handle unexpected conditions, or conditions that are not allowed, which is time-consuming and can impact operating system performance. Without trapping privileged instructions, the paravirtualized operating system runs at near native speed.

    Click Next.

  5. Enter the following information for the virtual machine on the Virtual Machine Information page:

    • Virtual Machine Name: Enter a unique name for the virtual machine. The name is used to create the directory under /OVS/running_pool on the Virtual Machine Server, where the files associated with this virtual machine are stored.

      A virtual machine name must consist of alphanumeric characters, and must not contain spaces or special characters, except the underscore (_) or hyphen (-) characters. The maximum name length is 200 characters.

    • Number of Virtual CPUs: Select the number of virtual CPUs for the virtual machine according to the operating system and application consumptions. You can allocate a maximum of 32 virtual CPUs. The larger number you select, the more CPU resources the virtual machine can use.

      If the sum of virtual CPUs on all the running virtual machines exceeds that of physical CPUs, each virtual CPU will get that fraction of CPU time. For example, if the sum of virtual CPUs on all the running virtual machines is 8, and you have 4 physical CPUs on the Virtual Machine Server, then each virtual CPU will get 4/8, namely 50%, of CPU time, given that all the virtual CPUs are fully utilized at the same time.

    • Keyboard Layout: Select the keyboard to use to interact with the virtual machine.

    • Memory Size (MB): Allocate the amount of memory for the virtual machine. Allocate at least 256 MB of memory. When allocating memory, consider the following:

      • Memory consumption of applications that will run on the virtual machine

      • Memory consumption of applications that are running and will run on the Virtual Machine Server

      • Memory resources to be allocated to other virtual machines

    • Virtual Disk Size (MB): Allocate at least 1024 MB of virtual disk. When allocating disk, consider the following:

      • Disk consumption of applications that will run on the virtual machine

      • Disk consumption of applications that are running and will run on the Virtual Machine Server

      • Disk resources to be allocated to other virtual machines

    • Console Password: Set the console password used to connect to the virtual machine using VNC.

    • Confirm Console Password: Re-enter the console password.

    • High Availability: If you want to enable high availability (HA) for this virtual machine, select this checkbox. For more information about high availability, see Section 3.5, "Enabling High Availability (HA)".

    • To add more virtual network interfaces (NICs), click Add Row in the Network Interface Card table. By default, virtual network interfaces are named VIF0, VIF1, VIF2, and so on. You can rename them after creating the virtual machine. See Section 6.7.2, "Network". Oracle VM automatically assigns a random MAC address to the virtual network interface.

      Select a bridge for the virtual network interface. By default, the number of bridges is the same as that of physical adaptors, and the bridges are named after physical adaptors. For example, if the Virtual Machine Server has several physical adaptors, eth0, eth1, eth2, and so on, the bridges are then named xenbr0, xenbr1, xenbr2, and so on.

      When creating a virtual machine, you can set a maximum of three virtual network interfaces. After the virtual machine is created, you can set a maximum of eight virtual network interfaces. See Section 6.7.2, "Network".

    Click Next.

  6. Confirm the virtual machine information on the Confirm Information page and click Confirm.

  7. The virtual machine is created. Periodically click the Refresh, or set the page refresh rate to 30 seconds until the status of the virtual machine changes from Creating to Running.

    If the status is Error, refer to Section 6.1.2.9, "Error" for help troubleshooting the error.

  8. Log in to the virtual machine and install the guest operating system. See Section 6.5, "Connecting to a Virtual Machine's Console". By default, the virtual machine is private, and only you can access it.

In the virtual machine list, click Show to view the detailed information of the virtual machine.

Some parameters of the virtual machine, such as the virtual network interface and the boot mode, are set by default. You cannot change them during the process of creating the virtual machine. If you want to change them after creating the virtual machine, see Section 6.7, "Editing a Virtual Machine".

6.3.3 Creating a Network Bootable (PXE boot) Virtual Machine

You can create a network bootable (PXE boot) virtual machine that has the minimum configuration information, then start the virtual machine through Preboot Execution Environment (PXE) over a network later to install the guest operating system.

To create a network bootable (PXE boot) virtual machine:

  1. Select Create a network bootable virtual machine (pxeboot). Click Next.

  2. Select the server pool from the Server Pool table in which to create the virtual machine.

    Select the preferred server on which to run the virtual machine from the Preferred Server drop down. Select Auto to automatically assign the virtual machine to a Virtual Machine Server, or select Manual to specify one or more preferred servers manually. For more information on preferred servers, see Step 3 in Section 6.3.1, "Creating Virtual Machine From a Template".

    Click Next.

  3. Enter the following information for the virtual machine:

    • Virtual Machine Name: Enter a unique name for the virtual machine. The name is used to create the directory under /OVS/running_pool on the Virtual Machine Server, where the files associated with this virtual machine are stored.

      A virtual machine name must consist of alphanumeric characters, and must not contain spaces or special characters, except the underscore (_) or hyphen (-) characters. The maximum name length is 200 characters.

    • Number of Virtual CPUs: Select the number of virtual CPUs for the virtual machine according to the operating system and application consumptions. You can allocate a maximum of 32 virtual CPUs. The larger number you select, the more CPU resources the virtual machine can use.

      If the sum of virtual CPUs on all the running virtual machines exceeds that of physical CPUs, each virtual CPU will get that fraction of CPU time. For example, if the sum of virtual CPUs on all the running virtual machines is 8, and you have 4 physical CPUs on the Virtual Machine Server, then each virtual CPU will get 4/8, namely 50%, of CPU time, given that all the virtual CPUs are fully utilized at the same time.

    • Keyboard Layout: Select the keyboard to use to interact with the virtual machine.

    • Memory Size (MB): Allocate the amount of memory for the virtual machine. Allocate at least 256 MB of memory. When allocating memory, consider the following:

      • Memory consumption of applications that will run on the virtual machine

      • Memory consumption of applications that are running and will run on the Virtual Machine Server

      • Memory resources to be allocated to other virtual machines

    • Virtual Disk Size (MB): Allocate at least 1024 MB of virtual disk. When allocating disk, consider the following:

      • Disk consumption of applications that will run on the virtual machine

      • Disk consumption of applications that are running and will run on the Virtual Machine Server

      • Disk resources to be allocated to other virtual machines

    • Console Password: Set the console password used to connect to the virtual machine using VNC.

    • Confirm Console Password: Re-enter the console password.

    • High Availability: If you want to enable high availability (HA) for this virtual machine, select this checkbox. For more information about high availability, see Section 3.5, "Enabling High Availability (HA)".

    • To add more virtual network interfaces (NICs), click Add Row in the Network Interface Card table. By default, virtual network interfaces are named VIF0, VIF1, VIF2, and so on. You can rename them after creating the virtual machine. See Section 6.7.2, "Network". Oracle VM automatically assigns a random MAC address to the virtual network interface. You can change the MAC address in the Virtual Network Interface MAC Address column in the Network Interface Card table. The MAC address must begin with 00:16:3E.

      Select a bridge for the virtual network interface. By default, the number of bridges is the same as that of physical adaptors, and the bridges are named after physical adaptors. For example, if the Virtual Machine Server has several physical adaptors, eth0, eth1, eth2, and so on, the bridges are then named xenbr0, xenbr1, xenbr2, and so on.

      When creating a virtual machine, you can set a maximum of three virtual network interfaces. After the virtual machine is created, you can set a maximum of eight virtual network interfaces. See Section 6.7.2, "Network".

    Click Next.

  4. Confirm the virtual machine information on the Confirm Information page and click Confirm.

  5. The virtual machine is created. Periodically click Refresh, or set the page refresh rate to 30 seconds until the status of the virtual machine changes from Creating to Powered Off.

    If the status is Error, refer to Section 6.1.2.9, "Error" for help troubleshooting the error.

Before starting the virtual machine, you need to configure the DHCP and TFTP server first, and then start the virtual machine remotely over the network to install the guest operating system.

By default, the network bootable (PXE boot) virtual machine starts through PXE.

In the virtual machine list, click Show to view the detailed information of the virtual machine.

Some parameters of the virtual machine, such as the virtual network interface and the boot source, are set by default. You cannot change them during the process of creating the virtual machine. If you want to change them after creating the virtual machine, see Section 6.7, "Editing a Virtual Machine".

6.4 Starting and Shutting Down a Virtual Machine

After a virtual machine is created, you can start it or shut it down. When a virtual machine is running, you can pause it or suspend it to stop it temporarily.

6.4.1 Starting a Virtual Machine

Starting a virtual machine is analogous to starting a computer by pressing the Power On button.

Note:

Make sure that the virtual machine status is Powered Off before you start it.

To start a virtual machine:

  1. Click the Virtual Machines tab.

  2. On the Virtual Machines page, select the virtual machine you want to start.

  3. Click the Power On button.

Periodically, click the Refresh button until the virtual machine status changes from Initializing to Running. You can choose to refresh manually, or to refresh every 30 seconds.

6.4.2 Shutting Down a Virtual Machine

When you do not use the virtual machine and log out, shut it down to release system resources.

Note:

Shut down the virtual machine only when the virtual machine status is Running.

To shut down a virtual machine:

  1. Click the Virtual Machines tab.

  2. On the Virtual Machines page, select the virtual machine you want to shut down. The virtual machine status should be Running.

  3. Click Power Off.

Note that if you have enabled high availability for this virtual machine, you need to shut it down by clicking Power Off; otherwise, if you shut down the virtual machine through the guest operating system, high availability takes effect, and the virtual machine will restart instead of shutting down.

6.4.3 Pausing and Unpausing a Virtual Machine

Pausing a virtual machine allows you to save the virtual machine at a certain processing point, and resume it again quickly.

When you pause a virtual machine, the state of the virtual machine is saved, and the running operations will not be restarted as long as they have no persistent communication with other computers. All the settings in the virtual machine, and all the devices, such as CPUs, VIFs, amount of memory, and so on, remain the same. But the processes of the virtual machine are no longer scheduled by Oracle VM Server to be run on any CPU. Therefore if the virtual machine is running a server such as a Web server, it will appear to the clients that the virtual machine is shut down.

Note:

Pause the virtual machine only when the virtual machine status is Running.

To pause a running virtual machine:

  1. Click the Virtual Machines tab.

  2. On the Virtual Machines page, select the virtual machine you want to pause.

  3. Select Pause, and click Go.

To unpause the virtual machine, select Unpause and click Go. Unpausing a virtual machine is much faster than starting a virtual machine.

After unpausing, the applications resume from where they were paused, and the virtual machine content remains unchanged.

6.4.4 Suspending and Resuming a Virtual Machine

Use the Suspend function to save the status information of a running virtual machine to the disk. You can suspend a virtual machine when you need to back up the current status information, and restore it quickly.

After you suspend the virtual machine, all the status information is saved to the disk, and virtual machine is no longer running, thus the memory allocated to the virtual machine will be released for other virtual machines to use. When the virtual machine is suspended, the network connections will no longer be available.

Note:

Suspend the virtual machine only when the virtual machine status is Running.

To suspend a running virtual machine:

  1. Click the Virtual Machines tab.

  2. On the Virtual Machines page, select the virtual machine you want to suspend.

  3. Select Suspend, and click Go.

To resume the virtual machine, select Resume and click Go.

6.4.5 Resetting a Virtual Machine

You can reset a virtual machine that may be having difficulties in starting or stopping, or performing some other action. To reset a virtual machine:

  1. Click the Virtual Machines tab.

  2. On the Virtual Machines page, select the virtual machine you want to reset.

  3. Select Reset, and click Go.

The virtual machine is reset and the status is set to the real status of the virtual machine, for example, Powered Off, Running, or Paused.

6.5 Connecting to a Virtual Machine's Console

If it is the first time you attempt to access a virtual machine, you need to install a plug-in to enable the Console button in Oracle VM Manager. After installing the plug-in, you can log in to the virtual machine.

6.5.1 Installing the Console Plug-In

The plug-ins you need to install vary, depending on which browser and operating system you are using to access Oracle VM Manager.

If you are using a Mozilla Firefox browser on Linux, download the Console Plug-in at: http://oss.oracle.com/oraclevm/manager/RPMS, and install it on the computer where your browser is running.

To install the Console Plug-in:

  1. Install the Console Plug-in using the command:

    # rpm -ivh ovm-console-version.rpm
    

    Where, version refers to the ovm-console version. It can be 1.0.0-2.x86_64 or 1.0.0-2.i386.

  2. If you have no standard installation of Mozilla Firefox, copy files:

    # cp /opt/ovm-console/etc/mozpluggerrc /etc/ 
    # cp /opt/ovm-console/bin/* /usr/bin 
    # cp /opt/ovm-console/lib/mozilla/plugins/ovm-console-mozplugger.so /opt/firefox/plugins 
    

    Where, /opt/firefox/plugins refers to the Firefox plug-in folder.

  3. Restart Mozilla Firefox.

If you are using Internet Explorer on Windows, you need to download and install the TightVNC-Java applet on the Oracle VM Manager host. For information on installing the TightVNC-Java applet, see Oracle VM Manager Installation Guide.

6.5.2 Logging In to a Virtual Machine

The virtual machine is now running, and the Console Plug-in has been installed, and you can log in to it by using the Console.

To log in to the virtual machine:

  1. On the Virtual Machines page, select the running virtual machine, and then click Console.

  2. A VNC Authentication is displayed. Enter the console password, and click OK.

    Figure 6-5 VNC Authentication

    Description of Figure 6-5 follows
    Description of "Figure 6-5 VNC Authentication"

  3. Enter the user name and password of the guest operating system to log in to the virtual machine.

After the VNC authentication, you may need to continue with some further tasks before you can use the virtual machine, depending on the method by which you created the virtual machine.

  • If you created this virtual machine based on a template, you can directly use the guest operating system and applications installed in advance, without any further configurations.

  • If you created this virtual machine using the fully virtualized method, the installation of the guest operating system is triggered after your first login. Follow the installation wizard to install the guest operating system.

    If you need more ISO files to complete the installation, select the next ISO file and then click Change CD to continue the installation, as shown in Figure 6-6, "Changing CD". Repeat this step until all the ISO files are installed.

    For information on the supported guest operating systems, see Oracle VM Server User's Guide.

    For more information on creating virtual machines using the fully virtualized method, refer to Section 6.3.2, "Creating a Virtual Machine From Installation Media".

6.6 Viewing Virtual Machine Details

To view more details of the virtual machine:

  1. Click the Virtual Machines tab.

  2. In the Details column of the Virtual Machines table, click the Show link.

    Figure 6-7 View Virtual Machine Details

    Description of Figure 6-7 follows
    Description of "Figure 6-7 View Virtual Machine Details"

    You can see information such as, memory size, operating system, virtualization method, number of virtual CPUs, VNC port, creation time, power-on time, and a link to the log file.

    If the virtual machine is running or shutting down, you can click the link of the VNC port number to open the VNC Authentication window and log in.

    You can also click the link of the log number to view error log information. For more information about the error log, see Appendix D, "The Status of the Virtual Machine Is Error".

To view more detailed information or edit the virtual machine, see Section 6.7, "Editing a Virtual Machine".

6.7 Editing a Virtual Machine

When creating a virtual machine, you can configure some of the parameters, such as the number of virtual CPUs, the size of memory, and so on; while the other parameters, such as boot source and the type of virtual network interfaces (VIFs), are assigned default settings by Oracle VM Manager, and you cannot configure them when creating the virtual machine. If needed, you can configure such parameters after the virtual machine is created.

To edit a virtual machine:

  1. Click the Virtual Machines tab.

  2. In the Virtual Machines table:

    • Select the virtual machine you want to configure, and click Configure.

    • Click the name of the virtual machine.

On the Virtual Machine Configure page, you can modify the following information:

Some parameters, including the increased memory size, and the modified network information and virtual disk, can take effect immediately without restarting the virtual machine; for the other modified parameters to take effect, you need to restart the virtual machine.

6.7.1 General

On the General Information page, you can modify the general parameters of the virtual machine, including:

  • Virtual Machine Name: Enter a new name for the virtual machine.

    A virtual machine name must consist of alphanumeric characters, and must not contain spaces or special characters, except the underscore (_) or hyphen (-) characters. The maximum name length is 200 characters.

  • Group Name: Select the group to which the virtual machine belongs.

  • Maximum Memory Size (MB): Enter the maximum size of memory that the virtual machine can consume. The default maximum size of memory is the same as the size you allocated when creating the virtual machine.

    Change the maximum memory size only when the status of the virtual machine is Powered Off.

  • Memory Size (MB): Increase or decrease the memory size of the virtual machine. Allocate at least 256 MB memory.

    Increased memory takes effect immediately without restarting the virtual machine. If you decrease the size of memory, you need to restart the virtual machine for the change to take effect.

  • Description: A description of the virtual machine.

Click Save to save the configurations you have modified.

There is some other information you can view on this page, as shown in Table 6-1.

Table 6-1 General Information

Item Description

Created By

The user who now owns this virtual machine

Status

The current status of the virtual machine. For more information on the status, see Section 6.1.2, "Virtual Machine Statuses".

Server Pool Name

The server pool in which the virtual machine is located

PVDriver Initialized

Whether PVDriver is initialized on the hardware virtualized machine (HVM) or not. Paravirtualized virtual machines (PV) do not have this parameter.

The status can be one of the following:

  • True: PVDriver is installed on this hardware virtualized machine (HVM).

  • False: PVDriver is not installed on this hardware virtualized machine (HVM); or it is installed but not initialized.

  • Unknown: The virtual machine is shut down; Oracle VM Manager cannot detect the status of PVDriver; or you need to upgrade Oracle VM Agent to support this feature.

Creation Time

The time when the virtual machine was created

Running Time

How long the virtual machine has been running

Size (MB)

The total size of the virtual machine


Figure 6-8 General Information

Description of Figure 6-8 follows
Description of "Figure 6-8 General Information"

6.7.2 Network

On the Network page, you can add, edit, or delete virtual network interfaces. You can set a maximum of eight virtual network interfaces.

Select Virtual Machine Type

If the virtual machine is a fully virtualized (hardware virtualized) machine, you can configure the virtual network interface (VIF) type to be either:

  • Fully Virtualized

  • Paravirtualized

The paravirtualized driver, also known as the netfront driver, can be used with either a paravirtualized machine, or a fully virtualized machine. The fully virtualized driver, also known as the ioemu driver, can only be used with a fully virtualized machine. Both drivers contain the BIOS and device emulation code to support fully virtualized machines.

For fully virtualized machines, the type can be either Fully Virtualized (ioemu) or Paravirtualized (netfront), and the default is Fully Virtualized (ioemu). For paravirtualized machines, the default is Paravirtualized (netfront), and this cannot be changed.

After you configure the virtual network interface type for one virtual network interface, all the virtual network interfaces in the virtual machine will be set to the same type.

Add a Virtual Network Interface (VIF)

To add a VIF:

  1. Click Add.

  2. Enter a name in the Virtual Network Interface Name field. Select a bridge type from the Bridge drop down.

  3. All virtual network interfaces (VIFs) share the physical network interface card (NIC) to communicate with the outside. If you have several VIFs, and you want to control how much bandwidth is granted to each VIF, you can configure the rate limit. Select Enable Rate Limit, and enter the rate value in Mbits in the Rate Limit (Mbit) field. The network traffic through the virtual network interface cannot exceed this limit.

    Click Next.

    Confirm the new VIF information, and click Confirm to add the new VIF. The change takes effect without restarting the virtual machine.

You can also edit or delete an existing VIF on this page.

Figure 6-9 Network Information

Description of Figure 6-9 follows
Description of "Figure 6-9 Network Information"

6.7.3 Storage

Virtual machine storage may consist of either a virtual disk, or a boot source/CDROM. This section discusses both storage types.

6.7.3.1 Virtual Disks

There are two ways to expand the storage capacity of a virtual machine: by creating non-sharable virtual disks, or by adding shared virtual disks.

Oracle VM Manager only supports file-based disks. Physical disks are not supported.

Note:

For a hardware virtualized machine (HVM), you can attach up to four IDE disks (including CD-ROM and shared virtual disks), and seven SCSI disks.

A paravirtualized machine (PV) has no such limitation. But you need to restart it for the disk changes to take effect.

Using Non-sharable Virtual Disks

To create a non-sharable virtual disk:

  1. Click Create New Virtual Disk.

  2. Enter the disk name in the Virtual Disk Name field.

    Enter the disk size in MBs in the Virtual Disk Size (MB) field. Allocate at least 1024 MB to the virtual disk.

    Select an disk type from the Hard Drive Type drop down. For a hardware virtualized machine (HVM), if you select Auto, Oracle VM Agent first selects IDE as the type of the hard drive. If the IDE disks have reached the maximum of four, Oracle VM Agent then selects SCSI. If the SCSI disks have reached the maximum of seven, you cannot add any more disks. To verify how many interfaces are available, see the message on the upper right of the page, as shown in Figure 6-10. For a paravirtualized machine, there is no limitation.

    Figure 6-10 Available Disk Interfaces

    Description of Figure 6-10 follows
    Description of "Figure 6-10 Available Disk Interfaces"

    If you want to prioritize the virtual disk, you can enable disk priority with the QoS Enabled check box, and select an appropriate priority class. The priority class ranges from 0 to 7. The priority class 0 has the highest priority, and 7 the lowest.

    Rather than being confined to a particular virtual machine, the priority of a virtual disk is global on the entire Oracle VM Server. Virtual disks of the same priority class take the same priority on the Oracle VM Server, even if they belong to different virtual machines.

    There are three IO scheduling classes: Idle, Best Effort, and Real Time. Oracle VM adopts the Real Time scheduling class. The Real Time scheduling class is given the first access to the disk, regardless of what else is going on in the system. The eight priority levels are defined denoting how big a time slice a given process will receive on each scheduling window.

  3. Click Next, confirm the information you have entered, and click Confirm to create the disk.

The new virtual disk can only be used by this virtual machine. You cannot share it.

To delete the non-sharable virtual disk, select it, and then click the Delete button. After you delete the virtual disk, all the files on it are deleted as well.

To delete shared virtual disks, see Section 5.4.5, "Deleting a Shared Virtual Disk".

Using Shared Virtual Disks

Shared virtual disks can only be shared among virtual machines within the same server pool. For information on how to create shared virtual disks, see Section 5.4.1, "Creating a Shared Virtual Disk".

To attach a shared virtual disk to the virtual machine:

  1. Click Attach/Detach Shared Virtual Disk.

  2. Move the disk from the Available Shared Virtual Disks column to the Selected Shared Virtual Disks column.

  3. Click OK. The selected virtual disk is displayed in the Virtual Disks table.

To detach a virtual disk from the virtual machine:

  1. Click Attach/Detach Shared Virtual Disk.

  2. Move the disk from the Selected Shared Virtual Disks column to the Available Shared Virtual Disks column.

  3. Click OK. The selected virtual disk is removed from the Virtual Disks table.

Virtual Disks Table

Table 6-2 displays the information you can view in the Virtual Disks table.

Table 6-2 Column Headers in the Virtual Disks Table

Column Header Description

Virtual Disk Name

The name of the virtual disk.

Size (MB)

The size of the virtual disk in MBs.

Front-end Device

The name of the disk displayed in the virtual machine.

Hard Disk Driver

The type of the hard disk. For a hardware virtualized machine (HVM), it can be IDE, SCSI, or Auto. For a paravirtualized machine (PV), it can be IDE, SCSI, XVD, or Auto.

QoS Enabled

Whether QoS is enabled.

Priority Class

If QoS is enabled, the value of the priority class is displayed.

Shared

Whether the virtual disk is shared.

Status - Disk Attachment

Whether the disk is attached to the virtual machine. It may be either of the following statuses:

  • Attached: The disk is attached to the virtual machine and functioning normally.

  • Detached: The disk is not attached to the virtual machine due to the lack of disk interfaces. For example, you create an IDE disk, but the number of IDE disks exceeds 4 and there are no more IDE interface available for this disk. Therefore, the disk is detached.

    It is also possible that Oracle VM Agent cannot connect to the disk. In this case, you need to edit the storage and save your changes. Oracle VM Agent then reconnects to the disk.

Status - Disk Status

The status of the disk may be one of the following:

  • Creating: The disk is being created. It may take a few minutes.

  • Active: The disk is available.

  • Deleting: The disk is being deleted.

  • Error: Some error occurred with the disk. You need to delete the disk and create a new one.


6.7.3.2 Boot Source/CDROM

You can select whether the virtual machine boots from a CDROM, disk, or from a location on the network.

To select the virtual machine boot location:

  1. Select the Boot Source/CDROM sub-tab.

  2. Select the boot device from the Boot Device drop down. You can choose to start the virtual machine from any of the following:

      • HDD: Starts the virtual machine from the hard disk.

      • CDROM: Starts the virtual machine from the CDROM. This option is only available to hardware virtualized machines.

      • PXE: Starts the virtual machine through a Preboot Execution Environment (PXE) from a location on the network.

  3. Select the location of the CDROM from which to boot the virtual machine in the CDROM field. This is an ISO file to install the guest operating system of the virtual machine. This option is only available to hardware virtualized machines.

  4. Click Apply to set the boot source and location.

6.7.4 Policies

You can set policies for managing virtual CPUs and for placement, and to set HA for the virtual machine. This section discusses these policy options.

To set policies for a virtual machine, select the Policies sub-tab. The Policies page contains two further sub-tabs:

6.7.4.1 High Availability

You can set up HA for the virtual machine, and the number and scheduling priority of virtual CPUs on the High Availability page.

Figure 6-11 High Availability Policies

Description of Figure 6-11 follows
Description of "Figure 6-11 High Availability Policies"

The fields on the High Availability page are:

  • Number of Virtual CPUs: Change the number of virtual CPUs. Restart the virtual machine for the changes to take effect.

  • Scheduling Priority: Set the scheduling priority for the virtual CPUs. You can select High (100), Intermediate (50), or Low (1) priority for the virtual CPUs. You can also enter a custom priority by selecting Customize and entering a value out of 100 in the text area.

  • Scheduling Cap: Set the percentage to which the virtual CPUs can receive scheduled time. You can select a High (100%), Intermediate (50%), or Low (10%) percentage of scheduled time for the virtual CPUs. You can also enter a custom percentage by selecting Customize and entering a percentage in the text area.

  • Enable High Availability: Select to enable HA for the virtual machine. HA guarantees the availability of virtual machines in case of the physical server failure or restart. To make high availability take effect, you must enable high availability for both the server pool and the virtual machine. For more information about high availability, see Section 3.5, "Enabling High Availability (HA)".

6.7.4.2 Placement Policy

You can set a virtual machine to automatically run on any Virtual Machine Server available in the server pool, or to run on a specific Virtual Machine Server on the Placement Policy page.

To run a virtual machine on a specific Virtual Machine Server, click Manual and select the Virtual Machine Server(s) in the Results table on which to run the virtual machine. Click Confirm to confirm your selection.

To run a virtual machine on any available Virtual Machine Server in the server pool, click Auto. For more information about the preferred server, see Step 3 in Section 6.3.1, "Creating Virtual Machine From a Template".

Note:

If none of the preferred servers provide sufficient resources to run the virtual machine, the virtual machine may fail to start.

When the virtual machine is Powered Off or Suspended, you can switch between the Auto mode and the Manual mode.

6.7.5 Profiles

On the Profiles page, you can set up or modify the user name and password for login, boot source, operating system, and keyboard.

To set the profile for a virtual machine, select the Profiles sub-tab. The Profiles page contains two further sub-tabs:

6.7.5.1 Login/Password

The Login/Password page enables you to change the virtual machine and console login information.

Figure 6-12 Profile Information - Login/Password

Description of Figure 6-12 follows
Description of "Figure 6-12 Profile Information - Login/Password"

The fields available on the Login/Password page are:

  • Virtual Machine System Username: Enter the user name used to log in to the guest operating system.

  • Virtual Machine System Password: Enter the password used to log in to the guest operating system.

  • Confirm Virtual Machine System Password: Confirm the password used to log in to the guest operating system.

  • Console Password: Enter the password for VNC authentication.

  • Confirm Console Password: Confirm the password for VNC authentication.

Click Send me the password if you want these passwords to be sent to your registered e-mail.

Click Apply to apply the changes.

6.7.5.2 Operating System

You can select an operating system, according to which Oracle VM optimizes the virtual machine profile, such as the configuration information in the vm.cfg file, and the timer mode for hardware virtualized machines (HVM). There are other behaviors controlled by selecting the operating system type, for example, Windows guests can use USB tablet emulation instead of mouse emulation. By selecting the appropriate operating system, you can run the virtual machine with a better performance.

You can change the keyboard for the virtual machine on this page. Select an appropriate keyboard you need to use to interact with the virtual machine.

Figure 6-13 Profile Information - Operating System

Description of Figure 6-13 follows
Description of "Figure 6-13 Profile Information - Operating System"

6.8 Reproducing Virtual Machines

Oracle VM Manager enables you to reproduce one or multiple virtual machines easily based on an existing virtual machine.

Use one of the following to reproduce virtual machines:

6.8.1 Deploying a Virtual Machine

By deploying a virtual machine, you can clone a new virtual machine to a specific server pool, and share it with other users, or keep it private. After deploying a virtual machine, the original virtual machine remains in the original server pool. You can only deploy virtual machines to the server pools and groups to which you belong.

Note:

Make sure the status of virtual machine is Powered Off before you deploy the virtual machine.

To deploy a virtual machine:

  1. Click the Virtual Machines tab.

  2. Select the virtual machine you want to deploy. In the More Actions list, select Deploy, and click Go. You can only deploy one virtual machine at a time.

  3. Enter the name of the new virtual machine.

  4. Select the group with whom you want to share the virtual machine.

    • Public Group: Deploy the virtual machine to the public group, so that all Oracle VM Manager users can use this new virtual machine.

    • My Workspace: Deploy the virtual machine to a server pool that only you are allowed to use and make it private.

    • group_name: Share the new virtual machine with members of a specific group.

  5. If you have selected My Workspace or a specific group, continue to select a server pool to which you want to deploy this virtual machine.

  6. On the Confirm Information page, confirm the virtual machine information and click Confirm.

  7. The virtual machine is deployed. This process may take some time. After you deploy the virtual machine, click the Refresh button periodically until the status of the new virtual machine changes from Creating to Powered Off. You can choose to refresh manually, or to refresh every 30 seconds.

    If the status is Error, see Section 6.1.2.9, "Error" to troubleshoot the error.

Note:

If you deploy a virtual machine to the Public Group, the deployed virtual machine image is compressed and copied to the /OVS/publish_pool of the Oracle VM Server. The deployed virtual machine cannot be Powered On. To make this virtual machine available to all users, download or copy the virtual machine image, uncompress it and import it as a virtual machine image or template. Alternatively, you can select the deployed virtual machine and deploy it again to My Workspace, or another group.

Now you have finished deploying the virtual machine. To start the new virtual machine, see Section 6.4.1, "Starting a Virtual Machine".

You can change the preferred server and other configurations of the new virtual machine. See Section 6.7, "Editing a Virtual Machine".

6.8.2 Cloning Virtual Machines

Cloning a virtual machine is a process to create one or more copies of an existing virtual machine. By cloning a virtual machine, you can save multiple copies to another server pool and share them with other users.

Note:

Make sure the status of the virtual machine is Powered Off before you clone the virtual machine.

To clone a virtual machine:

  1. Click the Virtual Machines tab.

  2. On the Virtual Machines page, select the virtual machine you want to clone. In the More Actions list, select Clone, and click Go.

  3. Enter the required information.

    • Virtual Machine Name Prefix: Enter the prefix used to name the virtual machine copies. For example, if you enter vm, the virtual machine copies will be named vm0, vm1, vm2, and so on.

    • Number of Copies: Enter the number of copies you want to clone. For example, if you enter 5, five copies of the virtual machine will be created. You can clone a maximum of 10 copies.

    • Server Pool Name: Select the server pool where the cloned virtual machine copies will be located.

    • Group Name: Select the group who can use the cloned virtual machines copies.

  4. This process may take some time. When the status of the original virtual machine changes from Cloning to Powered Off, click Refresh to check the latest virtual machine status. You can choose to refresh manually, or to refresh every 30 seconds. When the status of the cloned virtual machine changes from Creating to Powered Off, the cloning process is complete.

    If the status is Error, see Section 6.1.2.9, "Error" to troubleshoot the error.

Now you have created multiple copies of the virtual machine. You can change the preferred server and other configurations of the cloned virtual machines. See Section 6.7, "Editing a Virtual Machine".

6.8.3 Saving a Virtual Machine as a Template

You can save a virtual machine as a template, to enable other users to create their new virtual machines based on this template. For more information on this, refer to Section 6.3.1, "Creating Virtual Machine From a Template".

Note:

Make sure the status of the virtual machine is Powered Off before you save the virtual machine as a template.

To save a virtual machine as a template:

  1. Click the Virtual Machines tab.

  2. Select the virtual machine you want to deploy as a template. In the More Actions list, select Save As Template, and click Go. You can only save one virtual machine at a time.

  3. Enter the template name, and click Confirm.

  4. The status of the original virtual machine changes from Powered Off to Saving.

    This process may take some time. When the status returns to Powered Off, click the Resources tab, and then click the Virtual Machine Templates tab. Refresh the virtual machine periodically until the status changes from Creating to Active. You can see the new virtual machine template.

Now you can use the new template to create virtual machines.

6.9 Migrating a Virtual Machine

Live migration is a process to migrate a running virtual machine from one Virtual Machine Server to another, while applications on the existing virtual machine continue to run. Live migration ensures high availability of virtual machines. This feature is important, and useful, when the existing Virtual Machine Server may be out of commission, or on a planned shutdown for maintenance purposes.

Cross-server-pool live migration is not allowed. You can only migrate virtual machines from one Virtual Machine Server to another within the same server pool. You must use identical computers to perform live migrations, that is, the computer make and model number of both the source computer and the destination computer must be identical.

You must create a shared virtual disk before migrating the virtual machine.

To migrate a virtual machine:

  1. Click the Virtual Machines tab.

  2. On the Virtual Machines page, select the running virtual machine. In the More Actions list, select Live Migration, and click Go.

  3. Select the Virtual Machine Server to which you want to migrate the virtual machine. Click Next.

  4. Check the virtual machine information, and click Confirm.

The virtual machine is migrated.

6.10 Deleting a Virtual Machine

When you delete a virtual machine, all the files and data associated with this virtual machine will be removed from Oracle VM Manager. Before deleting a virtual machine, make sure you do not need it any longer.

Note:

Delete the virtual machine only when the virtual machine status is Powered Off or Error.

The process of deleting a normal virtual machine is different from that of deleting a virtual machine stuck in a certain status.

6.10.1 Deleting a Virtual Machine in Powered Off or Error Status

To delete a virtual machine in the Powered Off or Error status:

  1. On the Virtual Machines page, select the virtual machine you want to delete.

  2. In the More Actions list, select Delete, and click Go.

  3. Confirm the delete action.

6.10.2 Deleting a Stuck Virtual Machine

If a virtual machine gets stuck in any status such as Shutting Down or Creating, you can reset it, or shut it down, and delete it. To reset a virtual machine, see Section 6.4.5, "Resetting a Virtual Machine".

To delete a stuck virtual machine:

  1. Click the Virtual Machines tab.

  2. On the Virtual Machines page, select the virtual machine, and then click Power Off.

  3. After the status changes to Powered Off, delete the virtual machine.