Update to r37989:

Update the VirtualBox sections with new info:

FreeBSD Guest Additions
Guest CD/DVD support
Guest USB support

Reviewed by:	bcr
Differential Revision:	https://reviews.freebsd.org/D4662
This commit is contained in:
Bjoern Heidotting 2015-12-20 15:45:07 +00:00
parent 1ab8bf3205
commit 9752a491c1
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=47896

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: r35955
basiert auf: r37989
-->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="virtualization">
<info><title>Virtualisierung</title>
@ -1022,6 +1022,121 @@ xenbr1 8000.feffffffffff no vif0.1
</procedure>
</sect3>
</sect2>
<sect2 xml:id="virtualization-guest-virtualbox-guest-additions">
<title>&virtualbox; Gasterweiterungen auf einem &os;
Gast</title>
<para>Die &virtualbox; Gasterweiterungen bieten Unterstützung
für:</para>
<itemizedlist>
<listitem>
<para>Gemeinsame Zwischenablage</para>
</listitem>
<listitem>
<para>Mauszeiger-Integration</para>
</listitem>
<listitem>
<para>Zeitsynchronisation mit dem Host</para>
</listitem>
<listitem>
<para>Skalierung von Fenstern</para>
</listitem>
<listitem>
<para>Nahtloser Modus</para>
</listitem>
</itemizedlist>
<note>
<para>Die folgenden Kommandos werden im &os; Gastsystem
ausgeführt.</para>
</note>
<para>Installieren Sie das Paket
<package>emulators/virtualbox-ose-additions</package> in das
&os; Gastsystem:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose-additions</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
<para>Fügen Sie folgende Einträge in
<filename>/etc/rc.conf</filename> hinzu:</para>
<programlisting>vboxguest_enable="YES"
vboxservice_enable="YES"</programlisting>
<para>Wenn &man.ntpd.8; oder &man.ntpdate.8; verwendet wird um
die Uhrzeit zu synchronisieren, dann sollte die
Synchronisierung mit dem Host deaktiviert werden:</para>
<programlisting>vboxservice_flags"--disable-timesync"</programlisting>
<para><literal>vboxvideo_drv</literal> sollte von
<command>Xorg -configure</command> automatisch erkannt werden.
Alternativ kann auch manuell ein entsprechender Eintrag für
die <application>&virtualbox;</application> Grafikkarte in
<filename>xorg.conf</filename> hinzugefügt werden:</para>
<programlisting>Section "Device"
Identifier "Card0"
Driver "vboxvideo"
VendorName "InnoTek Systemberatung GmbH"
BoardName "VirtualBox Graphics Adapter"
EndSection</programlisting>
<para>Um <literal>vboxmouse_drv</literal> zu verwenden, muss
<filename>xorg.conf</filename> ebenfalls angepasst
werden:</para>
<programlisting>Section "InputDevice"
Identifier "Mouse0"
Driver "vboxmouse"
EndSection</programlisting>
<para>Benutzer von <acronym>HAL</acronym> sollten die Datei
<filename>/usr/local/etc/hal/fdi/policy/90-vboxguest.fdi</filename>
erstellen oder sie aus
<filename>/usr/local/share/hal/fdi/policy/10osvendor/90-vboxguest.fdi</filename>
kopieren:</para>
<programlisting>&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;!--
# Sun VirtualBox
# Hal driver description for the vboxmouse driver
# $Id: chapter.xml,v 1.33 2012-03-17 04:53:52 eadler Exp $
>>>>>>>>Copyright (C) 2008-2009 Sun Microsystems, Inc.
This file is part of VirtualBox Open Source Edition (OSE, as
available from http://www.virtualbox.org. This file is free software;
you can redistribute it and/or modify it under the terms of the GNU
General Public License (GPL) as published by the Free Software
Foundation, in version 2 as it comes in the "COPYING" file of the
VirtualBox OSE distribution. VirtualBox OSE is distributed in the
hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
Clara, CA 95054 USA or visit http://www.sun.com if you need
additional information or have any questions.
--&gt;
&lt;deviceinfo version="0.2"&gt;
&lt;device&gt;
&lt;match key="info.subsystem" string="pci"&gt;
&lt;match key="info.product" string="VirtualBox guest Service"&gt;
&lt;append key="info.capabilities" type="strlist"&gt;input&lt;/append&gt;
>>>>>>>>&lt;append key="info.capabilities" type="strlist"&gt;input.mouse&lt;/append&gt;
&lt;merge key="input.x11_driver" type="string"&gt;vboxmouse&lt;/merge&gt;
>>>>>>>>&lt;merge key="input.device" type="string"&gt;/dev/vboxguest&lt;/merge&gt;
&lt;/match&gt;
&lt;/match&gt;
&lt;/device&gt;
&lt;/deviceinfo&gt;</programlisting>
</sect2>
</sect1>
<sect1 xml:id="virtualization-host">
@ -1032,8 +1147,6 @@ xenbr1 8000.feffffffffff no vif0.1
</authorgroup>
</info>
<para>Seit einigen Jahren wurde &os; nicht offiziell von irgendeiner der
verfügbaren Virtualisierungslösungen als Host-Betriebssystem
unterstützt. Viele Anwender verwenden aber noch
@ -1060,9 +1173,13 @@ xenbr1 8000.feffffffffff no vif0.1
<sect2 xml:id="virtualization-virtualbox-install">
<title>&virtualbox; installieren</title>
<para><application>&virtualbox;</application> steht als &os;-Port in
<package>emulators/virtualbox-ose</package> bereit und
kann über den folgenden Befehl installiert werden:</para>
<para><application>&virtualbox;</application> steht als
&os;-Port in <package>emulators/virtualbox-ose</package>
bereit. Da <application>&virtualbox;</application> sehr aktiv
weiterentwickelt wird, vergewissern Sie sich, dass Ihre
Ports-Sammlung aktuell ist. Benutzen Sie die folgenden
Befehle um <application>&virtualbox;</application> zu
installieren:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
@ -1091,36 +1208,14 @@ xenbr1 8000.feffffffffff no vif0.1
<programlisting>vboxdrv_load="YES"</programlisting>
<para>Ältere Versionen als 3.1.2 von
<application>&virtualbox;</application> benötigen auch das
eingehängte <filename>proc</filename>-Dateisystem. Dies wird in
aktuellen Versionen nicht mehr benötigt, da dort die
Funktionen von der &man.sysctl.3; Bibliothek bereitgestellt
werden.</para>
<para>Um die Kernelmodule für die Unterstützung von
Netzwerkbrücken oder
<foreignphrase>Host-Only</foreignphrase>
Netzwerken zu laden, fügen Sie folgendes in
<filename>/etc/rc.conf</filename> ein und starten Sie den
Computer neu:</para>
<para>Wenn Sie eine ältere Version aus den Ports benutzen, befolgen
Sie die unten stehenden Anweisungen und stellen Sie sicher, dass
<filename>proc</filename> eingehangen ist.</para>
<screen>&prompt.root; <userinput>mount -t procfs proc /proc</userinput></screen>
<para>Um auch diese Einstellung nach einem Neustart zu erhalten, wird die
folgende Zeile in <filename>/etc/fstab</filename>
eingefügt:</para>
<programlisting>proc /proc procfs rw 0 0</programlisting>
<note>
<para>Möglicherweise erscheint eine Fehlermeldung ähnlich der
Folgenden, wenn <application>&virtualbox;</application> von einem
Terminal aus gestartet wird:</para>
<screen>VirtualBox: supR3HardenedExecDir: couldn't read "", errno=2 cchLink=-1</screen>
<para>Wahrscheinlich ist der Übeltäter das <filename>proc</filename>-Dateisystem. Verwenden Sie bitte
das <command>mount</command>-Kommando um zu überprüfen, ob
es korrekt eingehängt ist.</para>
</note>
<programlisting>vboxnet_enable="YES"</programlisting>
<para>Die Gruppe <systemitem class="groupname">vboxusers</systemitem> wird während der
Installation von <application>&virtualbox;</application> angelegt.
@ -1129,11 +1224,25 @@ xenbr1 8000.feffffffffff no vif0.1
<command>pw</command>-Befehl kann benutzt werden, um neue Mitglieder
hinzuzufügen:</para>
<screen>&prompt.root; <userinput>pw groupmod vboxusers -m yourusername</userinput></screen>
<screen>&prompt.root; <userinput>pw groupmod vboxusers -m <replaceable>yourusername</replaceable></userinput></screen>
<para>Damit Netzwerkbrücken funktionieren, müssen die in der
Voreinstellung eingeschränkten Berechtigungen für
<filename>/dev/vboxnetctl</filename> angepasst werden:</para>
<screen>&prompt.root; <userinput>chown root:vboxusers /dev/vboxnetctl</userinput>
&prompt.root; <userinput>chmod 0600 /dev/vboxnetctl</userinput></screen>
<para>Um die Berechtigungen dauerhaft zu speichern, fügen Sie
folgende Einträge in <filename>/etc/devfs.conf</filename>
hinzu:</para>
<programlisting>own vboxnetctl root:vboxusers
perm vboxnetctl 0600</programlisting>
<para>Um <application>&virtualbox;</application> zu starten, wählen
Sie entweder den Eintrag <guimenuitem>Sun VirtualBox</guimenuitem> aus
dem Menü Ihrer graphischen Benutzeroberfläche, oder geben
dem Menü der graphischen Benutzeroberfläche, oder geben
Sie den folgenden Befehl in ein Terminal ein:</para>
<screen>&prompt.user; <userinput>VirtualBox</userinput></screen>
@ -1147,6 +1256,76 @@ xenbr1 8000.feffffffffff no vif0.1
<uri xlink:href="http://wiki.FreeBSD.org/VirtualBox">http://wiki.FreeBSD.org/VirtualBox</uri>.</para>
</sect2>
<sect2 xml:id="virtualization-virtualbox-usb-support">
<title>USB Unterstützung für &virtualbox;</title>
<note>
<para>Für die folgenden Schritte wird mindestens
&virtualbox; 4.0.0 vorausgesetzt.</para>
</note>
<para>Um auf <acronym>USB</acronym>-Geräte lesend und schreibend
zuzugreifen, müssen Benutzer Mitglied der Gruppe
<systemitem class="groupname">operator</systemitem>
sein:</para>
<screen>&prompt.root; <userinput>pw groupmod operator -m <replaceable>jerry</replaceable></userinput></screen>
<para>Fügen Sie dann folgenden Eintrag in
<filename>/etc/devfs.rules</filename> hinzu. Erstellen Sie die
Datei, wenn sie nicht bereits existiert:</para>
<programlisting>[system=10]
add path 'usb/*' mode 0660 group operator</programlisting>
<para>Um diese neuen Regeln zu laden, fügen Sie folgenden
Eintrag in <filename>/etc/rc.conf</filename> hinzu:</para>
<programlisting>devfs_system_ruleset="system"</programlisting>
<para>Danach starten Sie devfs neu:</para>
<screen>&prompt.root; <userinput>service devfs restart</userinput></screen>
<para><acronym>USB</acronym> kann nun im Gastsystem aktiviert
werden. Die <acronym>USB</acronym>-Geräte sollten nun in den
&virtualbox; Einstellungen sichtbar sein.</para>
</sect2>
<sect2 xml:id="virtualbox-virtualization-host-dvd-cd-access">
<title>Host <acronym>CD</acronym>/<acronym>DVD</acronym>-Zugriff
in &virtualbox;</title>
<para>Das Kernelmodul <command>atapicam</command> muss durch die
folgenden Einträge in <filename>/boot/loader.conf</filename>
geladen werden:</para>
<programlisting>atapicam_load="YES"</programlisting>
<para>Damit die
<acronym>CD</acronym>/<acronym>DVD</acronym>-Funktionen von
&virtualbox; funktionieren, muss <acronym>HAL</acronym> in
<filename>/etc/rc.conf</filename> aktiviert und anschließend
gestartet werden:</para>
<programlisting>hald_enable="YES"</programlisting>
<screen>&prompt.root; <userinput>service hald start</userinput></screen>
<para>Damit die
<acronym>CD</acronym>/<acronym>DVD</acronym>-Funktionen von
Benutzern verwendet werden können, benötigen diese Zugriff auf
<filename>/dev/xpt0</filename>,
<filename>/dev/cd<replaceable>N</replaceable></filename> und
<filename>/dev/pass<replaceable>N</replaceable></filename>.
Fügen Sie folgende Einträge in
<filename>/etc/devfs.conf</filename> hinzu:</para>
<programlisting>perm cd0 0600
perm xpt0 0660
perm pass0 0660</programlisting>
</sect2>
<!--
Note: There is no working/end-user ready Xen support for FreeBSD as of 07-2010.
Hide all information regarding Xen under FreeBSD.