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

Part Number E10901-04
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
View PDF

5 Managing Resources

Resources include virtual machine templates, virtual machine images, ISO files, virtual disks, and converted virtual machines.

This chapter describes how to manage resources. It includes the following sections:

Note:

Only an Administrator or Manager can approve, edit, and delete the imported virtual machine templates, virtual machines, and ISO files.

Figure 5-1 Resources Page

Description of Figure 5-1 follows
Description of "Figure 5-1 Resources Page"

Importing Virtual Machine Templates

Virtual machine templates are shared among users to create new virtual machines. New virtual machines will inherit the same contents and configurations from the template.

Typically, a virtual machine template contains basic configurations, such as the number of virtual CPUs, the size of memory, virtual disks, virtual network interfaces (VIFs), and so on. It may also contain some applications installed beforehand.

You can obtain a virtual machine template by:

This section includes the following topics:

Importing a Virtual Machine Template

Note:

Before you import a virtual machine template, rename the configuration file of the virtual machine to vm.cfg.

Depending on where your virtual machine templates are located, on the Virtual Machine Server, on other computers, or on the Internet, you can import virtual machine templates from the server pool or download them from external source. You can also convert a Linux or Windows host to a virtual machine template (P2V).

Selecting from the Server Pool

If you already have some virtual machine templates on your Server Pool, you can discover and register them in Oracle VM Manager directly.

Before importing, make sure the component files of the virtual machine template are stored in the folder /OVS/seed_pool/template_name on the Virtual Machine Server, and make sure the configuration file is named vm.cfg.

When importing, Oracle VM Agent can update the directory information in the vm.cfg file automatically. If you need to modify the vm.cfg file, refer to Appendix A, "Preparing Virtual Machines For Importing".

To select an existing virtual machine template from the server pool, and register it in Oracle VM Manager, perform the following:

  1. On the Resources page, click Virtual Machine Templates, and then click Import.

  2. Select Select from Server Pool (Discover and register). Click Next.

  3. On the General Information page, enter or select the following general information:

    • Server Pool Name

      Select the server pool on which the imported virtual machine template will be located.

    • Virtual Machine Template Name

      Select the virtual machine template to be imported.

    • Operating System

      Select the guest operating system of the virtual machine template.

    • Virtual Machine System Username

      Enter the user name used to log in to the virtual machine template.

    • Virtual Machine System Password

      Enter the password used to log in to the virtual machine template.

    • Description

      Enter a description of the virtual machine template.

    Click Next.

  4. Confirm the information you have entered.

  5. After importing, the status of the virtual machine template is Pending. You need to approve it to make it available for creating virtual machines. See Approving the Imported Virtual Machine Template.

Downloading from External Source

To download a virtual machine template from outside of the server pool, such as OTN:

http://www.oracle.com/technology/software/products/virtualization/vm_templates.html

Or your own HTTP/FTP server, perform the following:

  1. On the Resources page, click Virtual Machine Templates, and then click Import.

  2. Select Download from External Source (HTTP and FTP). Click Next.

  3. On the General Information page, enter or select the following general information:

    • Server Pool Name

      Select the server pool on which the imported virtual machine template will be located.

    • Virtual Machine Template Name

      Enter a name for the imported virtual machine template. This must be unique. The name will be used as the name of the directory under /OVS/seed_pool, where the files associated with this virtual machine template are stored.

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

    • Operating System

      Select the guest operating system of the virtual machine template.

    • Virtual Machine System Username

      Enter the user name used to log in to the virtual machine template.

    • Virtual Machine System Password

      Enter the password used to log in to the virtual machine template.

    • Description

      Enter a description of the virtual machine template.

    Click Next.

  4. On the Import Information page, enter the URL where the virtual machine template is located. For example, enter either of the following:

    http://host/vm
    ftp://username:password@host/vm
    

    When using a proxy, select Use Proxy, and enter the proxy address.

    Click Next.

  5. Confirm the information.

  6. After importing, the status of the virtual machine template is Pending. You need to approve it to make it available for creating virtual machines. See Approving the Imported Virtual Machine Template.

Converting a Linux or Windows Host to a Virtual Machine Template (P2V)

You can convert a Linux or Windows host to an Oracle VM virtual machine template (Physical to Virtual, P2V). The conversion process is similar to downloading a template from external source.

Before conversion, you need to restart the Linux or Windows computer with the Oracle VM Server CD, and use P2V utility to start the conversion. For more information on how to use the P2V utility, see the Oracle VM Server User's Guide.

During the conversion, you are prompted to enter the number of virtual CPUs and memory size, and this information is configured in the vm.cfg file. The disk size in the virtual machine is determined by the size of the disks you have chosen to be included in the virtual machine. Make sure the Virtual Machine Server has sufficient resources for the conversion (disk space).

The converted virtual machine template is a hardware virtualized machine (HVM).

To convert a Linux or Windows host to a virtual machine template:

  1. On the Resources page, click Virtual Machine Templates, and then click Import.

  2. Select Linux/Windows P2V Import. Click Next.

  3. On the General Information page, enter the following general information:

    • Server Pool Name

      Select the server pool on which the converted virtual machine template will be located.

    • Virtual Machine Template Name

      Enter a name for the converted virtual machine template. This must be unique. The name will be used as the name of the directory under /OVS/seed_pool, where the files associated with this virtual machine template are stored.

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

    • Operating System

      Select the guest operating system of the virtual machine template.

    • Virtual Machine System Username

      Enter the user name used to log in to the virtual machine template.

    • Virtual Machine System Password

      Enter the password used to log in to the virtual machine template.

    • Description

      Enter a description of the virtual machine template.

    Click Next.

  4. On the Import Information page, enter the host name or IP address of the Linux or Windows host. For example, enter:

    hostname.example.com
    

    When using a proxy, select Use Proxy, and enter the proxy address.

    Click Next.

  5. Confirm the information.

  6. After importing, the status of the virtual machine template is Pending. You need to approve it to make it available. See Approving the Imported Virtual Machine Template.

Statuses of Virtual Machine Templates

The imported virtual machine template can be one of the following statuses.

  • Importing: This status indicates that the virtual machine template is in the process of being imported.

  • Pending: This status indicates that the virtual machine template has been imported successfully, and is waiting for the approval of the Manager.

  • Import Error: This status indicates that there were some errors during importing. Reimport the template, or delete it.

  • Active: This status indicates that the virtual machine template has been approved, and is available for creating virtual machines.

  • Inactive: This status indicates that the virtual machine template is imported, but not available.

  • Creating: This status indicates that the virtual machine template is in the process of being created from a virtual machine. See Saving a Virtual Machine as a Template.

  • Create Error: This status indicates that there were some errors during the creating process. Delete it and try again to save a virtual machine as the template.

Reimporting a Virtual Machine Template

If an error occurs during downloading from an external source, check if the URL or proxy URL is correct, and then reimport the virtual machine template.

To reimport a virtual machine template:

  1. On the Virtual Machine Templates page, select the virtual machine template you want to reimport, and click Reimport.

  2. Enter the URL. When using a proxy, select Use Proxy.

  3. Click Reimport.

Approving the Imported Virtual Machine Template

After importing, the status of virtual machine templates is Pending. After the Manager or Administrator approves them, the status changes to Active and the virtual machine now becomes an available template.

To approve an imported virtual machine template, you must have the Manager or Administrator role. On the Virtual Machine Templates page, select the template you want to approve, and then click Approve.

Editing a Virtual Machine Template

To edit a virtual machine template, perform the following:

  1. On the Virtual Machine Templates page, select the template you want to update, and click Edit.

  2. Update the template parameters. Click Apply.

    For more information about the template parameters, refer to Importing a Virtual Machine Template.

Deleting a Virtual Machine Template

To delete a virtual machine template, perform the following:

  1. On the Virtual Machine Templates page, select the template you want to delete, and click Delete.

  2. When prompted, confirm the delete operation.

Importing Virtual Machine Images

You can import virtual machines from outside of Oracle VM Manager, and use them directly.

Oracle VM Manager allows you to import both Oracle VM virtual machines and VMware virtual machines. When you import VMware virtual machines, Oracle VM Manager converts them to Oracle VM virtual machines automatically (Virtual to Virtual, V2V).

This section includes the following topics:

Importing a Virtual Machine Image

Note:

Before you import an Oracle VM virtual machine, make sure the configuration file is named vm.cfg.

Depending on where your virtual machines are located, on the Virtual Machine Server, on other computers, or on the Internet, you can import a virtual machine image from different resources. You can also convert a Linux or Windows host to a virtual machine (Physical to Virtual, P2V).

When importing a VMware virtual machine, make sure you have enough free disk space in the /OVS/tmp directory to convert the VMware virtual machine to an Oracle VM virtual machine. Oracle VM requires at least twice the disk space of the VMware virtual machine.

Selecting from the Server Pool

If you already have some virtual machine images on your Server Pool, you can discover and register them in Oracle VM Manager directly, without going through the downloading or copying process.

Before importing, make sure the component files of the virtual machine are stored in the folder /OVS/running_pool/virtual_machine_name on the Virtual Machine Server, and make sure the configuration file is named vm.cfg.

When importing, Oracle VM Agent updates the directory information in vm.cfg automatically. If you need to modify the vm.cfg file, refer to Appendix A, "Preparing Virtual Machines For Importing".

To discover and select an existing virtual machine image from the Server Pool, and register it in Oracle VM Manager, perform the following:

  1. On the Resources page, click Virtual Machine Images, and then click Import.

  2. Select Select from Server Pool (Discover and register). Click Next.

  3. On the General Information page, enter the following general information:

    • Server Pool Name

      Select the server pool on which the imported virtual machine will be located.

    • Sharing

      Select whether you want to share this virtual machine.

      private: This indicates that the virtual machine can only be used by the user who imports it.

      Shared (group_name): This indicates that the virtual machine can be used by members of this specific group.

    • Virtual Machine Image Name

      Select the virtual machine to be imported.

      Oracle VM Agent identifies the hypervisor type of the virtual machine directory, which can be Oracle VM or VMware. If both Oracle VM and VMware virtual machines are stored in the same directory, Oracle VM Agent only identifies the Oracle VM virtual machine, and ignores other types of virtual machines. If only the VMware virtual machine is detected, V2V (virtual machine to virtual machine) conversion is started.

    • Enable High Availability

      You can enable high availability for the imported virtual machine. For more information about high availability, see Enabling High Availability (HA).

    • Operating System

      Select the guest operating system of the imported virtual machine.

    • Virtual Machine System Username

      Enter the user name used to log in to the virtual machine.

    • Virtual Machine System Password

      Enter the password used to log in to the virtual machine.

    • Console Password

      Set the password for the VNC login to access the virtual machine.

    • Confirm Console Password

    Click Next.

  4. Confirm the information.

  5. After importing, the status of the virtual machine is Pending. You need to approve it to make it available. See Approving the Imported Virtual Machine Image.

    If the status turns out to be Import Error, click the error log link to check the detailed information.

Downloading from External Source

To download a virtual machine image from outside of the Server Pool, such as OTN:

http://www.oracle.com/technology/software/products/virtualization/vm_templates.html

Or your own HTTP/FTP server, perform the following:

  1. On the Resources page, click Virtual Machine Images, and then click Import.

  2. Select Download from External Source (HTTP and FTP). Click Next.

  3. On the General Information page, enter the following general information:

    • Server Pool Name

      Select the server pool on which the imported virtual machine will be located.

    • Sharing

      Select whether you want to share this virtual machine, or keep it private.

      Private: This indicates that the virtual machine can only be used by the user who imports it.

      Shared (group_name): This indicates that the virtual machine can be used by members of a specific group.

    • Virtual Machine Image Name

      Enter a new name for the imported virtual machine. This must be unique. The name will be used as the name of the directory under /OVS/running_pool, where the files associated with this virtual machine are stored.

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

    • Enable High Availability

      You can enable high availability for the imported virtual machine. For more information about high availability, see Enabling High Availability (HA).

    • Operating System

      Select the guest operating system of the imported virtual machine.

    • Virtual Machine System Username

      Enter the user name used to log in to the virtual machine.

    • Virtual Machine System Password

      Enter the password used to log in to the virtual machine.

    • Console Password

      Set the password for the VNC login to access the virtual machine.

    • Confirm Console Password

    Click Next.

  4. On the Import Information page, enter the URL of the folder where the virtual machine you want to import is located. For example, enter either of the following:

    http://example.com/vm
    ftp://username:password@example.com/vm
    

    If you are importing a VMware virtual machine, enter the URL of the .vmx file. For example, enter:

    ftp://username:password@example.com/vm/vm.vmx
    

    Oracle VM Manager first copies the necessary files of the virtual machine, then converts the virtual machine to an Oracle VM virtual machine, and finally generates the vm.cfg file. After conversion, the VMware virtual machine will be deleted.

    When using a proxy, select Use Proxy, and enter the proxy address.

    Click Next.

  5. Confirm the information.

  6. After importing, the status of the virtual machine is Pending. You need to approve it to make it available. See Approving the Imported Virtual Machine Image.

    If the status turns out to be Import Error, click the error log link to check the detailed information.

Converting a Linux or Windows Host to a Virtual Machine (P2V)

You can convert a Linux or Windows host to an Oracle VM virtual machine template (Physical to Virtual, P2V). The conversion process is similar to downloading a template from external source.

Before conversion, you need to restart the Linux or Windows computer with the Oracle VM Server CD, and use P2V utility to start the conversion. For more information on how to use the P2V utility, see the Oracle VM Server User's Guide.

During the conversion, you are prompted to enter the number of virtual CPUs and memory size, and this information is configured in the vm.cfg file. The disk size in the virtual machine is determined by the size of the disks you have chosen to be included in the virtual machine. Make sure the Virtual Machine Server has sufficient resources for the conversion (disk space).

The converted virtual machine is a hardware virtualized machine (HVM).

To convert a Linux or Windows host to a virtual machine:

  1. On the Resources page, click Virtual Machine Images, and then click Import.

  2. Select Linux/Windows P2V Import. Click Next.

  3. On the General Information page, enter the following general information:

    • Server Pool Name

      Select the server pool on which the imported virtual machine will be located.

    • Sharing

      Select whether you want to share this virtual machine, or keep it private.

      Private: This indicates that the virtual machine can only be used by the user who imports it.

      Shared (group_name): This indicates that the virtual machine can be used by members of a specific group.

    • Virtual Machine Image Name

      Enter a name for the imported virtual machine. This must be unique. The name will be used as the name of the directory under /OVS/running_pool, where the files associated with this virtual machine are stored.

    • Enable High Availability

      You can enable high availability for the imported virtual machine. For more information about high availability, see Enabling High Availability (HA).

    • Operating System

      Select the guest operating system of the imported virtual machine.

    • Virtual Machine System Username

      Enter the user name used to log in to the virtual machine.

    • Virtual Machine System Password

      Enter the password used to log in to the virtual machine.

    • Console Password

      Set the password for the VNC login to access the virtual machine.

    • Confirm Console Password.

    Click Next.

  4. On the Import Information page, enter the host name or IP address of the computer. For example, enter:

    hostname.example.com
    

    When using a proxy, select Use Proxy, and enter the proxy address.

    Click Next.

  5. Confirm the information.

  6. After importing, the status of the virtual machine is Pending. You need to approve it to make it available. See Approving the Imported Virtual Machine Image.

    If the status turns out to be Import Error, click the error log link to check the detailed information.

Statuses of Virtual Machine Images

The imported virtual machine can be one of the following statuses:

  • Importing: This status indicates that the virtual machine is in the process of being imported.

  • Pending: This status indicates that the virtual machine has been imported successfully, and is waiting for the approval of the Manager.

  • Import Error: This status indicates that there were some errors during the importing process. Click the link to check the error log. You may need to reimport the virtual machine, or delete it.

Reimporting a Virtual Machine Image

If an error occurs during downloading from an external source, check if the URL or proxy URL is correct, and then reimport the virtual machine.

To reimport a virtual machine:

  1. On the Virtual Machine Images page, select the virtual machine you want to reimport, and click Reimport.

  2. Enter the URL. When using a proxy, select Use Proxy.

  3. Click Reimport.

Approving the Imported Virtual Machine Image

The process of approving and managing virtual machine images is similar to that of virtual machine templates. For more information, refer to Approving the Imported Virtual Machine Template.

After approving, click the Virtual Machines tab, and you can find the virtual machine is displayed in the Virtual Machines list.

You can change the preferred server and other configurations of the imported virtual machine. See Editing Virtual Machine Configuration.

Editing a Virtual Machine Image

To edit a virtual machine image, perform the following:

  1. On the Virtual Machine Images page, select the virtual machine you want to update, and click Edit.

  2. Update the virtual machine parameters. Click Apply.

    For more information about the virtual machine parameters, refer to Importing a Virtual Machine Image.

Deleting a Virtual Machine Image

To delete a virtual machine image, perform the following:

  1. On the Virtual Machine Images page, select the virtual machine you want to delete, and click Delete.

  2. If prompted, confirm the delete operation.

Importing ISO Files

You can import ISO files to provide installation media for creating virtual machines. This section includes the following topics:

Importing an ISO File

Common rules about ISO files management:

  • Any user can import an ISO file.

  • The Administrator or server pool manager approves the imported ISO files.

  • All ISO files of one image should belong to the same ISO group.

  • All users in the same server pool can share ISO files on the server pool.

Depending on where your ISO files are located, on the Virtual Machine Server, on other computers, or on the Internet, you can import ISO files from different resources as follows:

Selecting from the Server Pool

If you already have some ISO files on your Server Pool, you can discover and register them in Oracle VM Manager directly.

Before importing, make sure the ISO files are in the folder /OVS/iso_pool/iso_group_name on the Virtual Machine Server. You can also download ISO files from other computers, or from the Internet, and then copy them to this folder.

To select an existing ISO file on the Server Pool, and register it in Oracle VM Manager, perform the following:

  1. On the Resources page, click ISO Files, and then click Import.

  2. Select Select from Server Pool (Discover and register). Click Next.

  3. On the General Information page, select the following ISO file information:

    • Server Pool Name

      Select the server pool on which the ISO file is stored.

    • ISO Group

      Select the ISO group. One ISO group may contain multiple ISO files.

    • ISO Label

      Select the ISO file you want to import.

    Click Next.

  4. Confirm the information.

  5. After importing, the status of the ISO file is Pending. You need to approve it to make it available to use. See Approving the Imported ISO File.

Downloading from External Source

To download an ISO file from outside of the Server Pool, such as your own HTTP or FTP server, or from the Internet, perform the following:

  1. On the Resources page, click ISO Files, and then click Import.

  2. Select Download from External Source (HTTP and FTP). Click Next.

  3. On the General Information page, enter the following ISO file information:

    • Server Pool Name

      Select the server pool on which the ISO file is to be used and stored.

    • ISO Group

      Enter the name of the ISO group. One ISO group may contain multiple ISO files. The name will be used as the name of the directory under /OVS/iso_pool, where the ISO files of this group are stored.

    • ISO Label

      Enter the ISO label used to identify the imported ISO file. For example, enter CD1.

      An ISO label must consist of alphanumeric characters, and must not contain spaces or special characters, except the underscore (_) and hyphen (-) characters. The maximum label length is 100 characters.

    • URL

      Enter the path where the ISO file is located. You can import the ISO file through an FTP service or through an HTTP web service. For example, enter an address similar to the following:

      http://example.com/el5_img/disc1.iso

      ftp://username:password@example.com/el5_img/disc1.iso

      When using a proxy, select User Proxy and enter the proxy address. For example, enter a proxy address similar to the following:

      http://example.com:8888

    Click Next.

  4. Confirm the information.

  5. After importing, the status of the ISO file is Pending. You need to approve it to make it available for creating virtual machines. See Approving the Imported ISO File.

Statuses of ISO Files

The imported ISO file can be one of the following statuses:

  • Importing: This status indicates that the ISO file is in the process of being imported.

  • Pending: This status indicates that the ISO file has been imported successfully, and is waiting for the approval of the Manager.

  • Import Error: This status indicates that there were some errors during the importing process. Reimport the ISO file, or delete it.

  • Active: This status indicates that the ISO file has been approved, and is available for creating virtual machines.

  • Inactive: This status indicates that the ISO file is imported successfully, but not available.

Reimporting an ISO File

If an error occurs during external import, check if the URL or proxy URL is correct, and then reimport the ISO file.

To reimport an ISO file:

  1. On the ISO Files page, select the ISO file you want to reimport, and click Reimport.

  2. Enter the URL. When using a proxy, select Use Proxy.

  3. Click Reimport.

Approving the Imported ISO File

The process of approving, and managing ISO files is similar to that of virtual machine templates. For more information, refer to Approving the Imported Virtual Machine Template.

Changing Status of an ISO File

To change the status of the ISO files, perform the following:

  1. Select the ISO file and click Edit.

  2. Select the status. It can be Active or Inactive. Click Apply.

Only active ISO files are available to users.

Note:

Only an administrator or server pool manager of the server pool can approve, and manage the imported ISO files and virtual machines.

Deleting an ISO File

If you do not need an ISO file, or there are errors during the ISO file importing process, you can delete it.

To delete an ISO file, from the ISO page, select the ISO file you want to delete, and click Delete.

Managing Shared Virtual Disks

You can create shared virtual disks, and use them to expand your virtual machines storage capacity. The available virtual disks can also be used by other users in the group.

Oracle VM now only supports using files as virtual disks, namely, the prefix of the disk in the configuration file can only be file. Physical devices can be used, but cannot be changed through Oracle VM Manager. The following is an example:

disk = [ 'file:/tmp/para_seed/system.img,hda,w', ]

For more information on how to assign shared hard disks to a virtual machine, refer to Storage.

This section includes the following topics:

Creating a Shared Virtual Disk

To create a shared virtual disk, perform the following:

  1. On the Resources page, click Shared Virtual Disk, and then click Create Shared Virtual Disk.

  2. On the Add Shared Virtual Disks page, enter or select the following parameters:

    • Virtual Disk Name

      Enter the disk name.

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

    • Virtual Disk Size (MB)

      Allocate at least 1024 MB for the virtual disk.

    • Server Pool Name

      Select the server pool on which the shared virtual disk can be used, and shared.

    • Group Name

      Select the group that can use this shared virtual disk. You can select one of the following groups:

      • My Workspace: The virtual disk will be a private one, and only you can use it.

      • group_name: Select a specific group with whom you want to share this virtual disk. If the virtual disk is available after creation, any member of this group can use it.

  3. Confirm the information you have entered.

Searching a Shared Virtual Disk

You can search shared virtual disks for a particular server pool and group.

To search a shared virtual disk, perform the following:

  1. The search criteria include: virtual disk name, server pool name, group name, status. Use % as a wildcard.

  2. Click Search to view the shared virtual disks.

Deleting a Shared Virtual Disk

Note:

Make sure no application is using the virtual disk before you delete it.

To delete a shared virtual disk, perform the following:

  1. Select the shared virtual disk, and click Delete.

  2. Confirm the delete operation.

After you delete the virtual disk, all the files on it will be deleted as well.