Update to r52814:

Add a troubleshooting section to the Xen chapter.

In the discussion leading up to r52813, rgrimes@ suggested to add a
troubleshooting section to the Xen chapter to help with debugging issues.

In particular, users should know where Xen 4.11 and higher logs important
information relevant for debugging. There are also a couple of options
that increase the verbosity of the dom0 and enable iommu debugging. These
were divided up into two subsections: one for the host and the other for
the guest.
This commit is contained in:
Bjoern Heidotting 2019-05-11 13:22:52 +00:00
parent 2205665483
commit 5d1b3fda75
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=53004

View file

@ -5,7 +5,7 @@
$FreeBSD$
$FreeBSDde: de-docproj/books/handbook/virtualization/chapter.xml,v 1.14 2010/07/03 14:29:30 jkois Exp $
basiert auf: r52813
basiert auf: r52814
-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
@ -1861,5 +1861,112 @@ freebsd 1 1024 1 -b---- 663.9</s
wurde. Die virtuelle Maschine kann nun verwendet
werden.</para>
</sect2>
<sect2 xml:id="virtualization-host-xen-troubleshooting">
<title>Fehlerbehebung</title>
<para>Dieser Abschnitt enthält grundlegende Informationen, um
Probleme zu beheben, die bei der Verwendung von &os; als Host
oder Gast von &xen; auftreten können.</para>
<sect3 xml:id="virtualization-host-xen-troubleshooting-host">
<title>Fehlerbehebung beim Booten des Hosts</title>
<para>Bitte beachten Sie, dass die folgenden Tipps zur
Fehlerbehebung für &xen; 4.11 oder neuer gedacht sind.
Wenn Sie noch &xen; 4.7 benutzen und Probleme haben,
sollten Sie die Migration auf eine neuere Version in
Betracht ziehen.</para>
<para>Um Probleme beim Booten des Hosts zu beheben,
benötigen Sie wahrscheinlich ein serielles Kabel oder ein
USB-Kabel. Ausführliche Informationen während des
Bootens erhalten Sie, wenn Sie die Option
<literal>xen_cmdline</literal> in
<filename>loader.conf</filename> hinzufügen. Einige
relevante Optionen sind:</para>
<itemizedlist>
<listitem>
<para><literal>iommu=debug</literal>: kann benutzt
werden, um zusätzliche Informationen über das
iommu auszugeben.</para>
</listitem>
<listitem>
<para><literal>dom0=verbose</literal>: kann benutzt
werden, um zusätzliche Informationen über den
dom0 Build Prozess auszugeben.</para>
</listitem>
<listitem>
<para><literal>sync_console</literal>: diese Option
erzwingt eine synchrone Konsolenausgabe. Dies ist sehr
nützlich für die Fehlersuche, um den Verlust von
Nachrichten durch die Begrenzung zu vermeiden.
Verwenden Sie diese Option niemals in produktiven
Umgebungen, da sie es böswilligen Gästen ermöglichen
kann, DoS-Angriffe gegen &xen; über die Konsole
durchzuführen.</para>
</listitem>
</itemizedlist>
<para>Um Probleme zu identifizieren, sollte &os; beim Booten
ebenfalls detaillierte Informationen anzeigen. Dies können
Sie wie folgt aktivieren:</para>
<screen>&prompt.root; <userinput>sysrc -f /boot/loader.conf boot_verbose="YES"</userinput></screen>
<para>Wenn keine dieser Optionen zur Lösung des Problems
beiträgt, senden Sie bitte das serielle Bootprotokoll zur
weiteren Analyse an <email>freebsd-xen@FreeBSD.org</email>
und <email>xen-devel@lists.xenproject.org</email>.</para>
</sect3>
<sect3 xml:id="virtualization-host-xen-troubleshooting-guest">
<title>Fehlerbehebung beim Erstellen von Gastsystemen</title>
<para>Die folgenden Informationen können helfen, Probleme beim
Erstellen von Gastsystemen zu diagnostizieren.</para>
<para>Die häufigste Ursache für Fehler beim Erstellen von
Gastsystemen ist der <literal>xl</literal> Befehl, der einen
Fehler generiert und mit einem Rückgabewert ungleich 0
endet. Wenn der angezeigte Fehler nicht ausreicht, um das
Problem zu identifizieren, kann auch eine umfangreichere
Ausgabe von <literal>xl</literal> erhalten werden, indem die
Option <literal>v</literal> wiederholt verwendet
wird.</para>
<screen>&prompt.root; <userinput>xl -vvv create freebsd.cfg</userinput>
Parsing config from freebsd.cfg
libxl: debug: libxl_create.c:1693:do_domain_create: Domain 0:ao 0x800d750a0: create: how=0x0 callback=0x0 poller=0x800d6f0f0
libxl: debug: libxl_device.c:397:libxl__device_disk_set_backend: Disk vdev=xvda spec.backend=unknown
libxl: debug: libxl_device.c:432:libxl__device_disk_set_backend: Disk vdev=xvda, using backend phy
libxl: debug: libxl_create.c:1018:initiate_domain_create: Domain 1:running bootloader
libxl: debug: libxl_bootloader.c:328:libxl__bootloader_run: Domain 1:not a PV/PVH domain, skipping bootloader
libxl: debug: libxl_event.c:689:libxl__ev_xswatch_deregister: watch w=0x800d96b98: deregister unregistered
domainbuilder: detail: xc_dom_allocate: cmdline="", features=""
domainbuilder: detail: xc_dom_kernel_file: filename="/usr/local/lib/xen/boot/hvmloader"
domainbuilder: detail: xc_dom_malloc_filemap : 326 kB
libxl: debug: libxl_dom.c:988:libxl__load_hvm_firmware_module: Loading BIOS: /usr/local/share/seabios/bios.bin
...</screen>
<para>Wenn die ausführliche Ausgabe nicht bei der Diagnose
des Problems hilft, gibt es auch noch die Protokolle des
QEMU und &xen; Toolstacks in
<filename>/var/log/xen</filename>. Beachten Sie, dass der
Name der Domäne an den Protokollnamen angehängt wird. Wenn
die Domäne also <literal>freebsd</literal> heißt, sollten
Sie wahrscheinlich die Dateien
<filename>/var/log/xen/xl-freebsd.log</filename> und
<filename>/var/log/xen/qemu-dm.freebsd.log</filename>
finden. Beide Dateien können nützliche Informationen zur
Fehlerbehebung enthalten. Wenn nichts davon zur Lösung des
Problems beiträgt, senden Sie bitte die Beschreibung des
Problems und so viele Informationen wie möglich an
<email>freebsd-xen@FreeBSD.org</email> und
<email>xen-devel@lists.xenproject.org</email>, um Hilfe zu
erhalten.</para>
</sect3>
</sect2>
</sect1>
</chapter>