Author: buildbot
Date: Thu Apr 11 13:40:19 2013
New Revision: 858115
Log:
Staging update by buildbot for vcl
Modified:
websites/staging/vcl/trunk/content/ (props changed)
websites/staging/vcl/trunk/content/confluence_export/libvirt-provisioning-module.html
Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Apr 11 13:40:19 2013
@@ -1 +1 @@
-1466857
+1466886
Modified:
websites/staging/vcl/trunk/content/confluence_export/libvirt-provisioning-module.html
==============================================================================
---
websites/staging/vcl/trunk/content/confluence_export/libvirt-provisioning-module.html
(original)
+++
websites/staging/vcl/trunk/content/confluence_export/libvirt-provisioning-module.html
Thu Apr 11 13:40:19 2013
@@ -78,63 +78,53 @@
<div id="content">
<h1 class="title">Libvirt Provisioning Module</h1>
- <p><a href="http://libvirt.org/";>Libvirt </a>
+ <p><strong>(this page is probably beyond repair and should be recreated -
it would probably
+be best to separate the manually created part from the auto generated part and
+just directly check in the manually created part as a plain html file instead
of
+a .mdtext file)</strong></p>
+<p><a href="http://libvirt.org/";>Libvirt </a>
is an open source toolkit which can interact with KVM, Xen, and several
other virtualization architectures.</p>
-<p><a name="LibvirtProvisioningModule-libvirt.pm"></a></p>
<h3 id="libvirtpm">libvirt.pm</h3>
<ul>
<li>libvirt.pm is the main provisioning module</li>
<li>Computers should have their provisioningID attributes set to point to
this module in order to utilize it</li>
-<li>Implements the required provisioning module subroutines: <em>load, capture,
-node_status, power_status, power_on, power_off, power_reset...</em></li>
-<li>Implements the functions provided by libvirt: <em>define, start,
destroy...</em></li>
+<li>Implements the required provisioning module subroutines: <strong>load,
capture,
+node_status, power_status, power_on, power_off, power_reset...</strong></li>
+<li>Implements the functions provided by libvirt: <strong>define, start,
destroy...</strong></li>
<li>Does not contain code specific to any of the hypervisors supported by
libvirt (KVM, Xen, etc)</li>
-<li>File location: <em>lib/VCL/Module/Provisioning/Libvirt.pm</em></li>
+<li>File location: <strong>lib/VCL/Module/Provisioning/Libvirt.pm</strong></li>
<li>Automatically determines which hypervisor driver object to use upon
initialization by examining the host</li>
</ul>
-<p><a name="LibvirtProvisioningModule-HypervisorDriverModules"></a></p>
-<h3 id="hypervisor-driver-modules">Hypervisor Driver Modules</h3>
+<h3 id="hypervisordrivermodules">Hypervisor Driver Modules</h3>
<p>Libvirt hypervisor drivers allow it to interact with and control various
-types of hypervisors. The drivers are listed at <a
href="http://libvirt.org/drivers.html.&nbsp";>http://libvirt.org/drivers.html.&nbsp</a>
-; A hypervisor driver module must be written in order for VCL to support
-any of the hypervisors supported by libvirt. These driver modules
+types of hypervisors. The drivers are listed at <a
href="http://libvirt.org/drivers.html";>http://libvirt.org/drivers.html</a>.
+A hypervisor driver module must be written in order for VCL to support
+any of the hypervisors supported by libvirt. These driver modules
only contain code specific to the driver in order to perform functions not
handled by libvirt.pm.</p>
<ul>
-<li>Hypervisor driver directory:
<em>lib/VCL/Module/Provisioning/libvirt/</em></li>
-<li>Example: lib/VCL/Module/Provisioning/libvirt/KVM.pm
-<strong> Contains code which only applies to KVM
-</strong> Calls qemu-img to perform image file operations</li>
+<li>Hypervisor driver directory:
<strong>lib/VCL/Module/Provisioning/libvirt/</strong></li>
+<li>Example: lib/VCL/Module/Provisioning/libvirt/KVM.pm<ul>
+<li>Contains code which only applies to KVM</li>
+<li>Calls qemu-img to perform image file operations</li>
+</ul>
+</li>
</ul>
<p>!Libvirt UML Diagram.gif!</p>
-<p><a name="LibvirtProvisioningModule-*VirtualMachineDisks*"></a></p>
-<h4 id="virtual-machine-disks"><em>Virtual Machine Disks</em></h4>
+<h4 id="virtualmachinedisks">Virtual Machine Disks</h4>
<p>A master disk image is stored in the location specified by the datastore
-path in the VM host profile. A copy on write virtual disk image is
-created for each virtual machine when it is loaded. The master disk
+path in the VM host profile. A copy on write virtual disk image is
+created for each virtual machine when it is loaded. The master disk
image is used as a read-only backing file for the copy on write disk
-images. Each VM writes to its own copy on write disk image.
+images. Each VM writes to its own copy on write disk image.
Using copy on write virtual disks allows VMs to be loaded without having to
create a complete copy of the master disk image.
!Copy on Write.gif|width=367,height=448!</p>
-<p>{anchor:libvirt.pm}</p>
-<p><a
name="LibvirtProvisioningModule-{color:#0000ff}libvirt.pm{color}"></a></p>
-<h1 id="color0000fflibvirtpmcolor">{color:#0000ff}libvirt.pm{color}</h1>
-<p>{html}<?xml version="1.0" ?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
-"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml";>
-<head>
-<title>VCL::Provisioning::libvirt - VCL provisioning module to support the
-libvirt toolkit</title>
-<meta http-equiv="content-type" content="text/html; charset=utf-8" />
-<link rev="made" href="mailto:root@localhost"; />
-</head></p>
-<p><body style="background-color: white"></p>
+<h1 id="libvirtpm2">libvirt.pm</h1>
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
@@ -219,8 +209,7 @@ libvirt toolkit</p>
<pre>
use VCL::Module::Provisioning::libvirt;
my $provisioner =
-(VCL::Module::Provisioning::libvirt)->new({data_structure =>
-$self->data});</pre>
+(VCL::Module::Provisioning::libvirt)->new({data_structure =>
$self->data});</pre>
<p>
</p>
<hr />
@@ -241,19 +230,16 @@ $self->data});</pre>
Returns : boolean
Description : Enumerates the libvirt driver modules directory:
lib/VCL/Module/Provisioning/libvirt/</p>
-<div class="codehilite"><pre> <span class="n">Attempts</span> <span
class="n">to</span> <span class="n">create</span> <span class="ow">and</span>
<span class="n">initialize</span> <span class="n">an</span> <span
class="n">object</span> <span class="k">for</span> <span class="nb">each</span>
+<div class="codehilite"><pre> <span class="n">Attempts</span> <span
class="n">to</span> <span class="n">create</span> <span class="ow">and</span>
<span class="n">initialize</span> <span class="n">an</span> <span
class="n">object</span> <span class="k">for</span> <span class="nb">each</span>
<span class="n">hypervisor</span>
+ <span class="n">driver</span> <span class="n">module</span> <span
class="n">found</span> <span class="n">in</span> <span class="n">this</span>
<span class="n">directory</span><span class="o">.</span> <span
class="n">The</span> <span class="n">first</span> <span class="n">driver</span>
<span class="n">module</span>
+ <span class="n">object</span> <span class="n">successfully</span> <span
class="n">initialized</span> <span class="n">is</span> <span
class="n">used</span><span class="o">.</span> <span class="n">This</span> <span
class="n">object</span> <span class="n">is</span> <span class="n">made</span>
+ <span class="n">accessible</span> <span class="n">within</span> <span
class="n">this</span> <span class="n">module</span> <span class="n">via</span>
<span class="nv">$self</span><span class="o">-&</span><span
class="ow">gt</span><span class="p">;</span><span class="n">driver</span><span
class="o">.</span> <span class="n">This</span> <span class="n">allows</span>
+ <span class="n">libvirt</span> <span class="n">support</span> <span
class="n">driver</span> <span class="n">modules</span> <span
class="n">to</span> <span class="n">be</span> <span class="n">added</span>
<span class="n">without</span> <span class="n">having</span> <span
class="n">to</span>
+ <span class="n">alter</span> <span class="n">the</span> <span
class="n">code</span> <span class="n">in</span> <span
class="n">libvirt</span><span class="o">.</span><span class="n">pm</span><span
class="o">.</span><span class="sr"></pre></span>
</pre></div>
-<p>hypervisor
- driver module found in this directory. The first driver
-module
- object successfully initialized is used. This object is made
- accessible within this module via $self->driver. This
-allows
- libvirt support driver modules to be added without having to
- alter the code in libvirt.pm.</pre>
-<p>
+<p><p>
</p>
<h2><a name="load">load</a></h2>
<pre>
@@ -311,8 +297,7 @@ implemented.</p>
<pre>
Parameters : $computer_id (optional)
Returns : string
- Description : Checks the status of the computer in order to determine if
-the
+ Description : Checks the status of the computer in order to determine if the
computer is ready to be reserved or needs to be reloaded. A
string is returned depending on the status of the computer:
'READY':
@@ -324,8 +309,7 @@ the
* Computer is loaded with the correct image
* OS module's post-load tasks have not run
'RELOAD':
- * Computer is not accessible or not loaded with the
-correct
+ * Computer is not accessible or not loaded with the correct
image</pre>
<p>
</p>
@@ -334,10 +318,8 @@ correct
Parameters : $image_name (optional)
Returns : array (boolean)
Description : Checks if the requested image exists on the node or in the
- repository. If the image exists, an array containing the
-image
- file paths is returned. A boolean evaluation can be done on
-the
+ repository. If the image exists, an array containing the image
+ file paths is returned. A boolean evaluation can be done on the
return value to simply determine if an image exists.</pre>
<p>
</p>
@@ -353,12 +335,9 @@ name="get_image_repository_search_paths"
<pre>
Parameters : $management_node_identifier (optional)
Returns : array
- Description : Returns an array containing paths on the management node
-where an
- image may reside. The paths may contain wildcards. This is
-used
- to attempt to locate an image on another managment node in
-order
+ Description : Returns an array containing paths on the management node where
an
+ image may reside. The paths may contain wildcards. This is used
+ to attempt to locate an image on another managment node in order
to retrieve it.</pre>
<p>
</p>
@@ -366,8 +345,7 @@ order
<pre>
Parameters : $domain_name (optional)
Returns : string
- Description : Determines the power state of the domain. A string is
-returned
+ Description : Determines the power state of the domain. A string is returned
containing one of the following values:
* 'on'
* 'off'
@@ -378,8 +356,7 @@ returned
<pre>
Parameters : $domain_name (optional)
Returns : boolean
- Description : Powers on the domain. Returns true if the domain was
-successfully
+ Description : Powers on the domain. Returns true if the domain was
successfully
powered on or was already powered on.</pre>
<p>
</p>
@@ -395,8 +372,7 @@ successfully
<pre>
Parameters : $domain_name (optional)
Returns : boolean
- Description : Resets the power of the domain by powering it off and then
-back
+ Description : Resets the power of the domain by powering it off and then back
on.</pre>
<p>
</p>
@@ -416,8 +392,7 @@ back
<pre>
Parameters : none
Returns : Libvirt driver object
- Description : Returns a reference to the libvirt driver object which is
-created
+ Description : Returns a reference to the libvirt driver object which is
created
when this libvirt.pm module is initialized.</pre>
<p>
</p>
@@ -425,8 +400,7 @@ created
<pre>
Parameters : none
Returns : string
- Description : Returns the name of the libvirt driver being used to control
-the
+ Description : Returns the name of the libvirt driver being used to control the
node. Example: 'KVM'</pre>
<p>
</p>
@@ -434,10 +408,8 @@ the
<pre>
Parameters : none
Returns : string
- Description : Returns the name of the domain. This name is passed to
-various
- virsh commands. It is also the name displayed in
-virt-manager.
+ Description : Returns the name of the domain. This name is passed to various
+ virsh commands. It is also the name displayed in virt-manager.
Example: 'vclv99-197:vmwarewin7-Windows764bit1846-v3'</pre>
<p>
</p>
@@ -446,10 +418,8 @@ virt-manager.
Parameters : none
Returns : string
Description : Returns the base name for files created for the current
- reservation. A file extension is not included. This file
-name is
- used for the domain's XML definition file and it's copy on
-write
+ reservation. A file extension is not included. This file name is
+ used for the domain's XML definition file and it's copy on write
image file. Example: 'vclv99-37_234-v23'</pre>
<p>
</p>
@@ -458,8 +428,7 @@ name="get_domain_xml_directory_path">get
<pre>
Parameters : none
Returns : string
- Description : Returns the directory path on the node where domain
-definition
+ Description : Returns the directory path on the node where domain definition
XML files reside. The directory used is: '/tmp/vcl'</pre>
<p>
</p>
@@ -476,8 +445,7 @@ name="get_master_image_directory_path">g
<pre>
Parameters : none
Returns : string
- Description : Returns the directory path on the node where the master
-image
+ Description : Returns the directory path on the node where the master image
files reside. Example: '/var/lib/libvirt/images'</pre>
<p>
</p>
@@ -486,10 +454,9 @@ name="get_master_image_file_path">get_ma
<pre>
Parameters : $image_name (optional)
Returns : string
- Description : Returns the path on the node where the master image file
-resides.
- Example:</p>
-<p>'/var/lib/libvirt/images/vmwarelinux-RHEL54Small2251-v1.qcow2'</pre>
+ Description : Returns the path on the node where the master image file
resides.
+ Example:
+ '/var/lib/libvirt/images/vmwarelinux-RHEL54Small2251-v1.qcow2'</pre>
<p>
</p>
<h2><a
@@ -497,8 +464,7 @@ name="get_copy_on_write_file_path">get_c
<pre>
Parameters : none
Returns : string
- Description : Returns the path on the node where the copy on write file
-for the
+ Description : Returns the path on the node where the copy on write file for
the
domain resides. Example:
'/var/lib/libvirt/images/vclv99-197_2251-v1.qcow2'</pre>
<p>
@@ -507,8 +473,7 @@ for the
<pre>
Parameters : none
Returns : boolean
- Description : Deletes existing domains which were previously created for
-the
+ Description : Deletes existing domains which were previously created for the
computer assigned to the current reservation.</pre>
<p>
</p>
@@ -523,8 +488,7 @@ the
<pre>
Parameters : none
Returns : string
- Description : Generates a string containing the XML definition for the
-domain.</p>
+ Description : Generates a string containing the XML definition for the
domain.</p>
<p></pre>
<p>
</p>
@@ -532,12 +496,9 @@ domain.</p>
<pre>
Parameters : none
Returns : hash reference
- Description : Retrieves information about all of the domains defined on
-the
- node and constructs a hash containing the information.
-Example:
- "vclv99-197:vmwarewin7-Windows764bit1846-v3"
-=> {
+ Description : Retrieves information about all of the domains defined on the
+ node and constructs a hash containing the information. Example:
+ "vclv99-197:vmwarewin7-Windows764bit1846-v3" => {
"id" => 135,
"state" => "paused"
},
@@ -551,8 +512,7 @@ Example:
<pre>
Parameters : $domain_name
Returns : hash reference
- Description : Retrieves the XML definition of a domain already defined on
-the
+ Description : Retrieves the XML definition of a domain already defined on the
node. Generates a hash using XML::Simple::XMLin.</p>
<p></pre>
<p>
@@ -569,14 +529,11 @@ the
<pre>
Parameters : $domain_name
Returns : hash reference
- Description : Retrieves snapshot information for the domain specified by
-the
- argument and constructs a hash. The hash keys are the
-snapshot
+ Description : Retrieves snapshot information for the domain specified by the
+ argument and constructs a hash. The hash keys are the snapshot
names. Example:
"VCL snapshot" => {
- "creation_time" => "2011-12-07
-16:05:50 -0500",
+ "creation_time" => "2011-12-07 16:05:50
-0500",
"state" => "shutoff"
}</p>
<p></pre>
@@ -613,46 +570,21 @@ name="find_repository_image_file_paths">
Parameters : $image_name (optional)
Returns : array
Description : Locates valid image files stored in the image repository.
- Searches for all files beginning with the image name and
-then
+ Searches for all files beginning with the image name and then
checks the results to remove any files which should not be
included. File extensions which are excluded: vmx, txt, xml
- If multiple vmdk files are found it is assumed that the
-image is
- one of the split vmdk formats and the <image
-name>.vmdk contains
+ If multiple vmdk files are found it is assumed that the image is
+ one of the split vmdk formats and the <image name>.vmdk
contains
the descriptor information. This file is excluded because it
causes qemu-img to fail.</p>
<p></pre>
<p>
</p>
-<hr />
-<h1><a name="see_also">SEE ALSO</a></h1>
-<p><a href="http://cwiki.apache.org/VCL/";>http://cwiki.apache.org/VCL/</a></p>
-</p>
-
-<p></body></p>
-<p></html>{html}</p>
-<p><a name="LibvirtProvisioningModule-"></a></p>
-<h2></h2>
-<p>{anchor:KVM.pm}</p>
-<p><a name="LibvirtProvisioningModule-{color:#0000ff}KVM.pm{color}"></a></p>
-<h1 id="color0000ffkvmpmcolor">{color:#0000ff}KVM.pm{color}</h1>
-<p>{html}
-<?xml version="1.0" ?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
-"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml";>
-<head>
-<title>KVM.pm</title>
-<meta http-equiv="content-type" content="text/html; charset=utf-8" />
-<link rev="made" href="mailto:root@localhost"; />
-</head></p>
-<p><body style="background-color: white"></p>
+<hr>
+<a name="LibvirtProvisioningModule-"></a></p>
+<h1 id="kvmpm">KVM.pm</h1>
<p><a name="__index__"></a></p>
-<!-- INDEX BEGIN -->
-
<ul>
<li><a href="#name">NAME</a></li>
@@ -697,17 +629,14 @@ href="#update_windows_image">update_wind
</p>
<h1><a name="name">NAME</a></h1>
<p>VCL::Provisioning::libvirt::KVM - Libvirt hypervisor driver module to
-allow
-support for the KVM hypervisor</p>
+allow support for the KVM hypervisor</p>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<pre>
- This is a driver module to allow the main libvirt.pm provisioning module
-to
- support KVM hosts. It performs the KVM-specific tasks not handled by
-libvirt
+ This is a driver module to allow the main libvirt.pm provisioning module to
+ support KVM hosts. It performs the KVM-specific tasks not handled by libvirt
itself.</pre>
<p>
</p>
@@ -719,45 +648,21 @@ libvirt
<pre>
Parameters : none
Returns : boolean
- Description : Checks if the node has KVM installed by checking if
-/usr/bin/qemu
- exists. Returns true if the file exists, false
-otherwise.</pre>
+ Description : Checks if the node has KVM installed by checking if
/usr/bin/qemu
+ exists. Returns true if the file exists, false otherwise.</pre>
<p>
</p>
<h2><a name="get_domain_type">get_domain_type</a></h2>
<pre>
Parameters : none
Returns : string
- Description : Returns 'kvm'. This is specified in the domain XML
-definition:
+ Description : Returns 'kvm'. This is specified in the domain XML definition:
<domain type='kvm'></pre>
-<pre></p>
-<p>=cut</pre>
-<p><table cellspacing="0" cellpadding="0"><tr><td>sub get_domain_type {
-<tr><td><td>my $self = shift;
-<tr><td><td>unless (ref($self) &&
-$self-><code>isa('VCL::Module'))</code> {
-<tr><td><td>notify($ERRORS{'CRITICAL'}, 0, ``subroutine was called as a
-function, it must be called as a class method'');
-<tr><td><td>return;
-<tr><td><td>}
-</table></p>
-<pre></p>
-<div class="codehilite"><pre><span class="k">return</span> <span
class="s">'kvm'</span><span class="p">;</span>
-</pre></div>
-
-
-<p>}</pre>
-<p>#/////////////////////////////////////////////////////////////////////////////</p>
-<p>
-</p>
<h2><a name="get_disk_driver_name">get_disk_driver_name</a></h2>
<pre>
Parameters : none
Returns : string
- Description : Returns 'qemu'. The disk driver name is specified in the
-domain
+ Description : Returns 'qemu'. The disk driver name is specified in the domain
XML definition:
<domain ...>
<devices>
@@ -769,8 +674,7 @@ domain
<pre>
Parameters : none
Returns : string
- Description : Returns 'qcow2'. The disk format is specified in the domain
-XML
+ Description : Returns 'qcow2'. The disk format is specified in the domain XML
definition:
<domain ...>
<devices>
@@ -782,8 +686,7 @@ XML
<pre>
Parameters : none
Returns : string
- Description : Returns 'qcow2'. This is used by libvirt.pm as the file
-extension
+ Description : Returns 'qcow2'. This is used by libvirt.pm as the file
extension
of the virtual disk file paths.</pre>
<p>
</p>
@@ -792,13 +695,10 @@ extension
Parameters : none
Returns : boolean
Description : Performs the KVM-specific steps prior to defining a domain:
- * Checks if the master image file exists on the node, If it
-does
- not exist, attempts to copy image from repository to the
-node
- * Creates a copy on write image which will be used by the
-domain
- being loaded</pre>
+ * Checks if the master image file exists on the node, If it does
+ not exist, attempts to copy image from repository to the node
+ * Creates a copy on write image which will be used by the domain
+ being loaded</pre>
<p>
</p>
<hr />
@@ -810,33 +710,26 @@ name="get_virtual_disk_file_info">get_vi
<pre>
Parameters : $virtual_disk_file_path
Returns : hash reference
- Description : Calls 'qemu-img info' to retrieve the virtual disk
-information.
+ Description : Calls 'qemu-img info' to retrieve the virtual disk information.
Builds a hash based on the output. Example:
- "backing_file" =>
-"/var/lib/libvirt/images/vmwarewinxp-base234-v23.qcow2 (actual path:
-/var/lib/libvirt/images/vmwarewinxp-base234-v23.qcow2)",
- "backing_file_actual_path" =>
-"/var/lib/libvirt/images/vmwarewinxp-base234-v23.qcow2",
+ "backing_file" =>
"/var/lib/libvirt/images/vmwarewinxp-base234-v23.qcow2 (actual path:
+/var/lib/libvirt/images/vmwarewinxp-base234-v23.qcow2)",
+ "backing_file_actual_path" =>
"/var/lib/libvirt/images/vmwarewinxp-base234-v23.qcow2",
"cluster_size" => 65536,
"disk_size" => "423M",
"disk_size_bytes" => 443547648,
"file_format" => "qcow2",
- "image" =>
-"/var/lib/libvirt/images/vclv99-37_234-v23.qcow2",
+ "image" =>
"/var/lib/libvirt/images/vclv99-37_234-v23.qcow2",
"snapshot" => {
1 => {
- "date" => "2011-12-07
-14:43:12",
+ "date" => "2011-12-07 14:43:12",
"tag" => "snap1",
"vm_clock" => "00:00:00.000",
"vm_size" => 0
}
},
- "virtual_size" => "20G (21474836480
-bytes)",
- "virtual_size_bytes" =>
-"21474836480"</pre>
+ "virtual_size" => "20G (21474836480 bytes)",
+ "virtual_size_bytes" => "21474836480"</pre>
<p>
</p>
<h2><a
@@ -849,11 +742,9 @@ name="get_virtual_disk_size_bytes">get_v
</p>
<h2><a name="copy_virtual_disk">copy_virtual_disk</a></h2>
<pre>
- Parameters : $source_file_paths, $destination_file_path, $disk_format
-(optional)
+ Parameters : $source_file_paths, $destination_file_path, $disk_format
(optional)
Returns : boolean
- Description : Calls qemu-img to copy a virtual disk image. The destination
-disk
+ Description : Calls qemu-img to copy a virtual disk image. The destination
disk
format can be specified as an argument. If omitted, qcow2 is
used.</pre>
<p>
@@ -863,14 +754,10 @@ name="create_copy_on_write_image">create
<pre>
Parameters : $master_image_file_path, $copy_on_write_file_path
Returns : boolean
- Description : Calls qemu-img to create a copy on write virtual disk image
-based
- on the master image. The resulting image is written to by
-the VM
- when it makes changes to its hard disk. Multiple VMs may
-utilize
- the master image file. Each writes to its own copy on write
-image
+ Description : Calls qemu-img to create a copy on write virtual disk image
based
+ on the master image. The resulting image is written to by the VM
+ when it makes changes to its hard disk. Multiple VMs may utilize
+ the master image file. Each writes to its own copy on write image
file. The master image file is not altered.</pre>
<p>
</p>
@@ -878,33 +765,15 @@ image
<pre>
Parameters : $virtual_disk_file_path
Returns : boolean
- Description : Runs virt-win-reg to update the registry of the image
-specified
- by the $virtual_disk_file_path argument. The virt-win-reg
-utility
- is provided by libguestfs-tools. This subroutine returns
-true if
+ Description : Runs virt-win-reg to update the registry of the image specified
+ by the $virtual_disk_file_path argument. The virt-win-reg utility
+ is provided by libguestfs-tools. This subroutine returns true if
virt-win-reg isn't installed.</p>
-<div class="codehilite"><pre> <span class="n">Adds</span> <span
class="n">registry</span> <span class="nb">keys</span> <span
class="n">to</span> <span class="n">disable</span> <span
class="n">VMware</span> <span class="n">services</span><span class="o">.</span>
<span class="n">If</span> <span class="n">the</span> <span
class="n">image</span>
+<div class="codehilite"><pre> <span class="n">Adds</span> <span
class="n">registry</span> <span class="nb">keys</span> <span
class="n">to</span> <span class="n">disable</span> <span
class="n">VMware</span> <span class="n">services</span><span class="o">.</span>
<span class="n">If</span> <span class="n">the</span> <span
class="n">image</span> <span class="n">is</span>
+ <span class="n">Windows</span> <span class="mi">5</span><span
class="o">.</span><span class="n">x</span><span class="p">,</span> <span
class="n">registry</span> <span class="nb">keys</span> <span
class="n">are</span> <span class="n">added</span> <span class="n">to</span>
<span class="n">enable</span> <span class="n">the</span> <span
class="n">builtin</span> <span class="n">IDE</span>
+ <span class="n">drivers</span><span class="o">.</span> <span
class="n">This</span> <span class="n">allows</span> <span
class="n">Windows</span> <span class="n">images</span> <span
class="n">converted</span> <span class="n">from</span> <span
class="n">VMware</span> <span class="n">using</span> <span class="n">a</span>
+ <span class="n">SCSI</span> <span class="n">virtual</span> <span
class="n">disk</span> <span class="n">to</span> <span class="n">be</span> <span
class="n">loaded</span> <span class="n">on</span> <span
class="n">KVM</span><span class="o">.</span><span class="sr"></pre></span>
</pre></div>
-
-
-<p>is
- Windows 5.x, registry keys are added to enable the builtin
-IDE
- drivers. This allows Windows images converted from VMware
-using a
- SCSI virtual disk to be loaded on KVM.</pre>
-<p>
-</p>
-<hr />
-<h1><a name="see_also">SEE ALSO</a></h1>
-<p><a href="http://cwiki.apache.org/VCL/";>http://cwiki.apache.org/VCL/</a></p>
-</p>
-
-<p></body></p>
-<p></html>
-{html}</p>
</div>
<div id="footer">
