Oracle® VM Manager User's Guide Release 2.1 Part Number E10901-04 |
|
|
View PDF |
Resources include virtual machine templates, virtual machine images, ISO files, virtual disks, and converted virtual machines.
Virtual machine templates
Virtual machine templates imported to Oracle VM Manager are used to create virtual machines.
Virtual machine images
Virtual machine images imported to Oracle VM Manager are used directly, without the process of creating.
ISO files
ISO files imported to Oracle VM Manager are used to create virtual machines from installation media.
Shared virtual disks
Shared virtual disks extend the storage capability of your virtual machine.
This chapter describes how to manage resources. It includes the following sections:
Note:
Only anAdministrator
or Manager
can approve, edit, and delete the imported virtual machine templates, virtual machines, and ISO files.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:
Saving an existing virtual machine as template. For more information, refer to Saving a Virtual Machine as a Template. You can then use the virtual machine template directly without importing it.
Downloading Oracle VM templates at:
http://www.oracle.com/technology/products/vm/templates.html
The password for the root user of all Oracle VM templates is ovsroot. The password for the oracle account in the OVM_EL4U5_X86_HVM_ORACLE_11G template is oracle. For more information on how to use these templates, see
http://download.oracle.com/otn_software/virtualization/README.templates
Before using the downloaded templates, you must import them into Oracle VM Manager.
This section includes the following topics:
Note:
Before you import a virtual machine template, rename the configuration file of the virtual machine tovm.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).
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:
On the Resources page, click Virtual Machine Templates, and then click Import.
Select Select from Server Pool (Discover and register). Click Next.
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.
Confirm the information you have entered.
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.
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:
On the Resources page, click Virtual Machine Templates, and then click Import.
Select Download from External Source (HTTP and FTP). Click Next.
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.
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.
Confirm the information.
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.
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:
On the Resources page, click Virtual Machine Templates, and then click Import.
Select Linux/Windows P2V Import. Click Next.
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.
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.
Confirm the information.
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.
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.
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:
On the Virtual Machine Templates page, select the virtual machine template you want to reimport, and click Reimport.
Enter the URL. When using a proxy, select Use Proxy.
Click Reimport.
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.
To edit a virtual machine template, perform the following:
On the Virtual Machine Templates page, select the template you want to update, and click Edit.
Update the template parameters. Click Apply.
For more information about the template parameters, refer to Importing a Virtual Machine Template.
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:
Note:
Before you import an Oracle VM virtual machine, make sure the configuration file is namedvm.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.
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:
On the Resources page, click Virtual Machine Images, and then click Import.
Select Select from Server Pool (Discover and register). Click Next.
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.
Confirm the information.
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.
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:
On the Resources page, click Virtual Machine Images, and then click Import.
Select Download from External Source (HTTP and FTP). Click Next.
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.
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.
Confirm the information.
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.
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:
On the Resources page, click Virtual Machine Images, and then click Import.
Select Linux/Windows P2V Import. Click Next.
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.
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.
Confirm the information.
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.
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.
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:
On the Virtual Machine Images page, select the virtual machine you want to reimport, and click Reimport.
Enter the URL. When using a proxy, select Use Proxy.
Click Reimport.
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.
To edit a virtual machine image, perform the following:
On the Virtual Machine Images page, select the virtual machine you want to update, and click Edit.
Update the virtual machine parameters. Click Apply.
For more information about the virtual machine parameters, refer to Importing a Virtual Machine Image.
To delete a virtual machine image, perform the following:
On the Virtual Machine Images page, select the virtual machine you want to delete, and click Delete.
If prompted, confirm the delete operation.
You can import ISO files to provide installation media for creating virtual machines. This section includes the following topics:
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:
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:
On the Resources page, click ISO Files, and then click Import.
Select Select from Server Pool (Discover and register). Click Next.
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.
Confirm the information.
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.
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:
On the Resources page, click ISO Files, and then click Import.
Select Download from External Source (HTTP and FTP). Click Next.
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.
Confirm the information.
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.
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.
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:
On the ISO Files page, select the ISO file you want to reimport, and click Reimport.
Enter the URL. When using a proxy, select Use Proxy.
Click Reimport.
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.
To change the status of the ISO files, perform the following:
Only active ISO files are available to users.
Note:
Only anadministrator
or server pool manager
of the server pool can approve, and manage the imported ISO files and virtual machines.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.
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:
To create a shared virtual disk, perform the following:
On the Resources page, click Shared Virtual Disk, and then click Create Shared Virtual Disk.
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.
Confirm the information you have entered.
You can search shared virtual disks for a particular server pool and group.
To search a shared virtual disk, perform the following:
The search criteria include: virtual disk name, server pool name, group name, status. Use % as a wildcard.
Click Search to view the shared virtual disks.
Note:
Make sure no application is using the virtual disk before you delete it.To delete a shared virtual disk, perform the following:
Select the shared virtual disk, and click Delete.
Confirm the delete operation.
After you delete the virtual disk, all the files on it will be deleted as well.