Editing Test Day:2010-09-23 Virtualization libguestfs

{|border="1"
|-style="color: white; background-color: #3074c2; font-weight: bold" 
| DATE || TIME || WHERE
|-
| [[Test_Day:2010-09-23_Virtualization|Thursday September 23, 2010]] || All day || [irc://irc.freenode.net/fedora-test-day #fedora-test-day]  ([http://webchat.freenode.net/?channels=fedora-test-day webchat])
|-
|}

=== What to test? ===

This part of [[Test_Day:2010-09-23_Virtualization|today's Fedora Test Day]] will focus on testing libguestfs / guestfish.

If you come to this page after the test day is completed, your testing is still valuable, and you can use the information on this page to test libguestfs and provide feedback.

=== Who's available ===

[[User:RJones|Richard Jones]] is your host for today.

The following people have also agreed to be available for testing, workarounds, bug fixes, and general discussion:

* [[User:jforbes|Justin M. Forbes]]
* <i>add your name here</i>

=== What's needed to test ===

* A fully updated Fedora 14 test machine.  See instructions on the [[Test_Day:2010-09-23_Virtualization|main test day page]].  <b>Note</b> you <i>can</i> use a virtual machine for testing!
* (Optional) Existing virtual machine disk images.

=== How to test ===

Look at the <i>Test Cases</i> section below and run through them.

Add your comments below this in the <i>Issues that were identified</i> section, and/or file bugs in Bugzilla by [https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools following this link].

=== Test Cases ===

Things to test:

{|
! Test !! Method
|-
| Installation
|| Install F14 (you can install it inside a virtual machine if you want, but it'll run a bit slower).  Then:
 yum install libguestfs guestfish perl-libguestfs \
   virt-cat virt-df virt-inspector virt-v2v
If there are any installation errors or dependency problems, these are serious bugs and should be reported.
|-
| Start up
|| Does libguestfs start up?  Firstly run this:
 guestfish alloc /tmp/test.img 10M : run || echo failed
This should take a few seconds (perhaps up to a minute or two on a slow machine).  It shouldn't print any error messages.  You don't need to be root.

Edit: Although it "shouldn't print any error messages", if KVM is unavailable then you may see the following harmless warnings, and it'll also be a lot slower:

 open /dev/kvm: No such file or directory
 Could not initialize KVM, will disable KVM support

If the short test above fails, please run:
 libguestfs-test-tool
If it doesn't print "== TEST FINISHED OK== " at the end, copy the complete, unedited output into a bug report, along with details of your test machine.  You can also ask about problems in the IRC channel.
|-
| Inspector
|| If you have any existing virtual machine disk images around, then try running [http://libguestfs.org/virt-inspector.1.html virt-inspector] on them:
 virt-inspector /path/to/disk.img
(Note you don't need to be root, but if the disk image isn't at least readable as non-root them you may need to chmod the image or become root).
Does the output look sensible?  Does it match the operating system you think is in the disk image?  Are there any error messages?
|-
| virt-df
|| If you have any existing virtual machine disk images around, or the machine has libvirt guests, try running [http://libguestfs.org/virt-df.1.html virt-df] on them:
 virt-df /path/to/disk.img
 virt-df
Does the output agree with the free/used space for that guest?  Do you see any error messages?
Note that virt-df has a bug where it hangs if it cannot access a disk image: {{bz|579155}}
|-
| virt-cat
|| If you have any existing virtual machine disk images around, or the machine has libvirt guests, try running [http://libguestfs.org/virt-cat.1.html virt-cat] on them:
 virt-cat guestname /etc/fstab
 virt-cat guestname /var/log/messages

 virt-cat guestname /var/run/utmp > /tmp/utmp
 who /tmp/utmp

 virt-cat mydomain /var/log/wtmp > /tmp/wtmp
 last -f /tmp/wtmp
Does the output agree with what is in the corresponding files in that guest?  Do you see any error messages?
|-
| Make image
|| Choose a large tarball and construct a disk image from it.
You have to set the size of the disk image in advance, large enough to fit the tarball with some headroom.  eg. If the tarball was 10 MB, you might choose a 14 MB image (if the image is not large enough, you will trip {{bz|580246}})  So:
 guestfish -x alloc output.img 14M : run : \
   sfdiskM /dev/sda , : \
   mkfs ext2 /dev/sda1 : \
   mount /dev/sda1 / : \
   tgz-in something.tar.gz /
That should produce an output file (<i>output.img</i>) which you can look at also with guestfish:
 guestfish -a output.img -m /dev/sda1
 ><fs> ls /
|-
| Advanced
|| If you have lots of time, try some of the guestfish recipes here:
http://libguestfs.org/recipes.html
|}

Thanks for your contribution to making Fedora better and less buggy!

=== Issues that were identified ===

{| border="1"
|-style="color: white; background-color: #3074c2; font-weight: bold" 
| Tester || Description || Bug references || Status
|- 
| || || [http://bugzilla.redhat.com/XXXXXX #XXXXX] || '''ASSIGNED'''
|}

[[Category:Fedora_14_Test_Days]]
[[Category:Virtualization]]