summaryrefslogtreecommitdiffstats
path: root/examples
diff options
context:
space:
mode:
authorRichard W.M. Jones <rjones@redhat.com>2012-09-26 20:56:44 +0100
committerRichard W.M. Jones <rjones@redhat.com>2012-09-26 20:56:44 +0100
commitf7e138835a7194135113088767c46df65dbf292a (patch)
tree6a63248be900d08c43deaba7e877c06261bb4a63 /examples
parent4f3048c6be0663c6c254a765ec5f83a7b40a8808 (diff)
downloadlibguestfs-f7e138835a7194135113088767c46df65dbf292a.tar.gz
libguestfs-f7e138835a7194135113088767c46df65dbf292a.tar.xz
libguestfs-f7e138835a7194135113088767c46df65dbf292a.zip
recipes: Add a section about diagnosing hanging guests.
Diffstat (limited to 'examples')
-rw-r--r--examples/guestfs-recipes.pod29
1 files changed, 29 insertions, 0 deletions
diff --git a/examples/guestfs-recipes.pod b/examples/guestfs-recipes.pod
index 6683b151..2679b688 100644
--- a/examples/guestfs-recipes.pod
+++ b/examples/guestfs-recipes.pod
@@ -278,6 +278,35 @@ listing who was logged in recently
L<http://augeas.net/>
+=head1 Hanging guests
+
+There are various ways to use libguestfs to find out why a guest
+is hanging or unresponsive:
+
+=over 4
+
+=item 1.
+
+Read the log files using virt-cat:
+
+ virt-cat Guest /var/log/messages | less
+
+=item 2.
+
+Read the Windows Event Log (Windows Vista or later only):
+
+L<https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-guestfish/#content>
+
+=item 3.
+
+Find out which files were last updated in a guest:
+
+L<https://rwmj.wordpress.com/2012/02/27/using-libguestfs-to-find-out-why-a-windows-guest-was-hanging/#content>
+
+This might give you a clue as to what program is running.
+
+=back
+
=head1 Install RPMs in a guest
The link below contains a method to install RPMs in a guest. In fact