Editing Test Day:2012-04-12 libguestfs

[http://libguestfs.org/ libguestfs is a set to virt tools and a library for viewing, editing and inspecting virtual machines and disk images].

In [[Releases/17|Fedora 17]], libguestfs 1.17.x will be available (upgraded from 1.10 in Fedora 15 and 1.16 in Fedora 16).

== Requirements ==

You will need a Fedora 17 machine.  Having at least one guest will be very helpful.

You can test libguestfs inside an F17 virtual machine, but it will run a lot slower.  For best performance, run the tests in F17 running on baremetal with VT extensions.

== Installing libguestfs and the virt tools ==

As root, do:

 # yum install libguestfs-tools

If you want to write libguestfs scripts or programs, install one of the language bindings, eg:

 # yum install libguestfs-devel \
       perl-Sys-Guestfs python-libguestfs \
       ruby-libguestfs ocaml-libguestfs-devel

== Basic checks ==

Check it's working by running this command (you don't need to be root):

 $ libguestfs-test-tool

This command will run some simple tests and eventually print out:

 ===== TEST FINISHED OK =====

If it doesn't print this out, or seems to fail for some other reason, please [https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools file a bug] including the complete, unedited output.

Now check how fast the appliance gets created:

 $ time guestfish -a /dev/null run

<b>Run this a few times so the cache is "hot".</b>  Note that the first time you run it, it creates a cached appliance (in <code>/var/tmp/.guestfs-*</code>) so that is much slower.  As a typical guide, you should see times like:

* 3-6 seconds, on modern hardware with virtualization extensions and KVM enabled
* 30-60 seconds, in a VM

If you get times wildly outside these ranges, let us know.  Unless you're using an AMD Geode, in which case sorry.

== Tests ==

There is a good set of tests upstream, and rather than just copying them here, follow the link:
http://libguestfs.org/guestfs-testing.1.html

== Bugs ==

If you find bugs, please file them using this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

== IRC and mailing list ==

During the test day (2012-04-12) we will be on the #fedora-test-day IRC channel.  The rest of the time, find us on #libguestfs (on FreeNode).  There is also a [http://www.redhat.com/mailman/listinfo/libguestfs mailing list].
Latest revision		Your text
Line 1:		Line 1:
	[http://libguestfs.org/ libguestfs is a set to virt tools and a library for viewing, editing and inspecting virtual machines and disk images]. Some of the tools include [http://libguestfs.org/guestfish.1.html guestfish], [http://libguestfs.org/virt-df.1.html virt-df], [http://libguestfs.org/virt-edit.1.html virt-edit], [http://libguestfs.org/virt-inspector.1.html virt-inspector], [http://libguestfs.org/virt-rescue.1.html virt-rescue], [http://libguestfs.org/virt-resize.1.html virt-resize], [http://libguestfs.org/virt-sparsify.1.html virt-sparsify], [http://libguestfs.org/virt-win-reg.1.html virt-win-reg].		[http://libguestfs.org/ libguestfs is a set to virt tools and a library for viewing, editing and inspecting virtual machines and disk images].

	In [[Releases/17\|Fedora 17]], libguestfs 1.17.x will be available (upgraded from 1.10 in Fedora 15 and 1.16 in Fedora 16).		In [[Releases/17\|Fedora 17]], libguestfs 1.17.x will be available (upgraded from 1.10 in Fedora 15 and 1.16 in Fedora 16).