Features/Virt-manager Guest Inspection

From FedoraProject

< Features(Difference between revisions)
Jump to: navigation, search
(Current status)
(Explain what packages are needed)
 
(4 intermediate revisions by one user not shown)
Line 14: Line 14:
 
== Current status ==
 
== Current status ==
 
* Targeted release: [[Releases/16 | Fedora 16 ]]  
 
* Targeted release: [[Releases/16 | Fedora 16 ]]  
* Last updated: 2011-07-27
+
* Last updated: 2011-09-19
* Percentage of completion: 50%
+
* Percentage of completion: 100% (complete)
  
 
== Detailed Description ==
 
== Detailed Description ==
Line 39: Line 39:
 
* virt-manager
 
* virt-manager
 
** <s>patch virt-manager to add inspection thread</s> (done 2011-07-18)
 
** <s>patch virt-manager to add inspection thread</s> (done 2011-07-18)
** patch virt-manager to avoid unreadable disks
+
** <s>patch virt-manager to avoid unreadable disks</s> (done 2011-08-09)
** patch virt-manager to store icon data locally
+
** patch virt-manager to store icon data locally (probably going to skip this)
** push virt-manager changes to Rawhide
+
** <s>push virt-manager changes to Rawhide</s>
 
* <s>libguestfs >= 1.12.0 (future stable release)</s>
 
* <s>libguestfs >= 1.12.0 (future stable release)</s>
 
** <s>release libguestfs 1.12.0 in Rawhide</s>
 
** <s>release libguestfs 1.12.0 in Rawhide</s>
* guestfs-browser needs to be added ([https://bugzilla.redhat.com/show_bug.cgi?id=669911 bug 669911])
+
* <s>guestfs-browser needs to be added ([https://bugzilla.redhat.com/show_bug.cgi?id=669911 bug 669911])</s>
 
** <s>complete the package review of guestfs-browser</s>
 
** <s>complete the package review of guestfs-browser</s>
 
** <s>add package to Rawhide</s>
 
** <s>add package to Rawhide</s>
** patch virt-manager to allow guestfs-browser to be launched
+
** patch virt-manager to allow guestfs-browser to be launched (deferred &mdash; you can use the main menu instead)
** push virt-manager change to Rawhide
+
  
 
== How To Test ==
 
== How To Test ==
Line 56: Line 55:
 
Users will need to have compatible KVM virtual machines installed, and be using libvirt.  Almost any Linux or Windows guest should be compatible.  FreeBSD, Solaris, etc. guests cannot be inspected at this time, although their presence should not affect inspection of other guests.
 
Users will need to have compatible KVM virtual machines installed, and be using libvirt.  Almost any Linux or Windows guest should be compatible.  FreeBSD, Solaris, etc. guests cannot be inspected at this time, although their presence should not affect inspection of other guests.
  
The user will simply need to run virt-manager.  After a short period of time, icons will appear in the main window, and when clicking into the "details" window, the other features will be seen.
+
The user will simply need to run virt-manager, and make sure python-guestfs package is installed.  After a short period of time, icons will appear in the main window, and when clicking into the "details" window, the other features will be seen.
  
 
== User Experience ==
 
== User Experience ==

Latest revision as of 10:47, 12 October 2011

Contents

[edit] Virt-manager Guest Inspection

[edit] Summary

Virt-manager-vmm-icons.png
Virt-manager-vmm-details.png
Virt-manager displays the operating system and applications within a guest, and allows the filesystems and Windows Registry of a guest to be browsed (read-only).

[edit] Owner

  • Email: rjones@redhat.com,crobinso@redhat.com

[edit] Current status

  • Targeted release: Fedora 16
  • Last updated: 2011-09-19
  • Percentage of completion: 100% (complete)

[edit] Detailed Description

We are adding several related features to virt-manager, all revolving around what we call guest inspection.

The first is that virt-manager will display operating system icons next to each guest in the main window. Screenshot Resolution of legal issues

The second is that in the virt-manager "details" window we display extra details. In particular the name of the installed operating system and the list of applications. Screenshot

The third is that there will be a button in virt-manager which will let you open up the guest filesystem and browse it graphically. For graphical browsing, this will be read-only. Screenshot

The fourth is that you will be able to browse (read-only) into Windows Registry entries. Screenshot

[edit] Benefit to Fedora

This is as far as we know a completely unique feature, that even other KVM-based Linux distros won't have for a while, and certainly no other hypervisor has.

[edit] Scope

This change is isolated to the components affected, which are:

  • virt-manager
    • patch virt-manager to add inspection thread (done 2011-07-18)
    • patch virt-manager to avoid unreadable disks (done 2011-08-09)
    • patch virt-manager to store icon data locally (probably going to skip this)
    • push virt-manager changes to Rawhide
  • libguestfs >= 1.12.0 (future stable release)
    • release libguestfs 1.12.0 in Rawhide
  • guestfs-browser needs to be added (bug 669911)
    • complete the package review of guestfs-browser
    • add package to Rawhide
    • patch virt-manager to allow guestfs-browser to be launched (deferred — you can use the main menu instead)

[edit] How To Test

No special hardware is required to test this.

Users will need to have compatible KVM virtual machines installed, and be using libvirt. Almost any Linux or Windows guest should be compatible. FreeBSD, Solaris, etc. guests cannot be inspected at this time, although their presence should not affect inspection of other guests.

The user will simply need to run virt-manager, and make sure python-guestfs package is installed. After a short period of time, icons will appear in the main window, and when clicking into the "details" window, the other features will be seen.

[edit] User Experience

Users will have a richer experience in virt-manager.

[edit] Dependencies

None.

[edit] Contingency Plan

We will revert back to the earlier version of virt-manager, or we will disable the inspection code before release.

[edit] Documentation

Patches are posted and discussed on the virt-tools mailing list.

[edit] Release Notes

virt-manager can now examine a virtual machine to determine the version of the operating system and what applications are installed.

[edit] Comments and Discussion