Subject: Re: Re: current version of german NetBSD/xen translation
To: Jan Schaumann <jschauma@netmeister.org>
From: =?ISO-8859-1?Q?Rainer_Brinkm=F6ller?= <rainer.brinkmoeller@web.de>
List: netbsd-docs-de
Date: 10/08/2005 01:09:11
Jan Schaumann schrieb:
>Could you provide the changes in unified diff format, please?
>
>You can create the patch via 'cvs diff -bu'.
>
>
Attention: If you did already download the files from
http://rbrinkmo.pytalhost.de/nbsddocs.html
please download them again. There are again a few changes.
Of course, here it is the current cvs diff output:
cvs diff -bu ./htdocs/de/Ports/xen/index.xml
Index: ./htdocs/de/Ports/xen/index.xml
===================================================================
RCS file: /cvsroot/htdocs/de/Ports/xen/index.xml,v
retrieving revision 1.2
diff -b -u -r1.2 index.xml
--- ./htdocs/de/Ports/xen/index.xml 16 Jul 2005 17:13:56 -0000 1.2
+++ ./htdocs/de/Ports/xen/index.xml 7 Oct 2005 22:41:39 -0000
@@ -5,9 +5,9 @@
<webpage id="de-Ports-xen-index" portpage="xen">
<config param="desc" value="NetBSD/xen"/>
-<config param="cvstag" value="$NetBSD: index.xml,v 1.2 2005/07/16
17:13:56 heinz Exp $" />
+<config param="cvstag" value="$NetBSD: index.xml,v 1.3 2005/10/03
21:28:48 jschauma Exp $" />
<!-- based on english version:
- NetBSD: index.xml,v 1.10 2005/05/05 08:09:11 hrs Exp -->
+ NetBSD: index.xml,v 1.11 2005/07/16 17:13:50 heinz Exp -->
<config param="rcsdate" value="$Date: 2005/07/16 17:13:56 $"/>
<head>
<title>NetBSD/xen</title>
@@ -67,7 +67,7 @@
<portnewsitem date="10.03.2005" title="Xen 2.0 Unterstützung">
&a.bouyer; hat den bouyer-xen2 Branch mit
- NetBSD -current vermischt. Soll heissen, dass Xen 2.0
Unterstützung
+ NetBSD -current vermischt. Das bedeutet, dass Xen 2.0
Unterstützung
(sowohl im privilegiertem und unprivilegiertem Modus) in
NetBSD 3.0 enthalten sein wird. Xen 1.2 Unterstützung wurde
entfernt.
</portnewsitem>
@@ -80,7 +80,7 @@
<portnewsitem date="11.03.2004" title="NetBSD/xen erstellt">
&a.cl; hat den ersten Port des NetBSD/xen eingefügt.
- Dieser Port läft derzeit als Xen version 1.2.
+ Dieser Port läuft derzeit als Xen version 1.2.
</portnewsitem>
<!-- <portnewsarchive/> -->
----------------------------------------------------------------------------------------------------------------------------------------
cvs diff -bu ./htdocs/de/Ports/xen/howto.xml
Index: ./htdocs/de/Ports/xen/howto.xml
===================================================================
RCS file: /cvsroot/htdocs/de/Ports/xen/howto.xml,v
retrieving revision 1.5
diff -b -u -r1.5 howto.xml
--- ./htdocs/de/Ports/xen/howto.xml 19 Jul 2005 12:50:56 -0000 1.5
+++ ./htdocs/de/Ports/xen/howto.xml 7 Oct 2005 22:47:54 -0000
@@ -6,9 +6,9 @@
<webpage id="de-Ports-xen-howto">
<config param="desc" value="NetBSD/xen Howto" />
<config param="cvstag"
- value="$NetBSD: howto.xml,v 1.5 2005/07/19 12:50:56 rpaulo Exp $" />
+ value="$NetBSD: howto.xml,v 1.6 2005/10/03 21:58:18 jschauma Exp $" />
<!-- based on english version:
- NetBSD: howto.xml,v 1.12 2005/05/05 08:09:11 hrs Exp -->
+ NetBSD: howto.xml,v 1.21 2005/08/28 23:25:33 rpaulo Exp -->
<config param="rcsdate" value="$Date: 2005/07/19 12:50:56 $" />
<head>
<!-- Copyright (c) 2005
@@ -42,6 +42,9 @@
<listitem>
<ulink url="#Linux-domains">Erstellen von
unprivilegierten Linux domains</ulink>
</listitem>
+ <listitem>
+ <ulink url="#pci-devices">Verwenden von PCI-Geräten
in Gast-domains</ulink>
+ </listitem>
</itemizedlist>
</sect1>
@@ -84,14 +87,14 @@
(<code>xbd</code>)
und virtuelle Netzwerkschnittstellen (<code>xennet</code>)
bereitgestellt durch eine privilegierte domain (normalerweise
- <emphasis>domain0</emphasis>). xbd-geräte werden an
physikalische
+ <emphasis>domain0</emphasis>). xbd-Geräte werden an
physikalische
Block-Gerät (eine Partition einer Festplatte, Raid, ccd,...
Geräte)
in den privilegierten domains verbunden. Die xennet-Geräte
werden an
virtuelle Geräte der privilegierten domain angeschlossen.
Die Benennung
ist wie folgt aufgebaut: xvif<domain Nummer>.<if-Nummer
für
diese domain> (z.B. xvif1.0). Beide, xennet- und
xvif-Geräte, werden
wie reguläre Netzwerk-Geräte gesehen (sie können
wie ein
- Crossover-Kabel zwischen 2 PC betrachtet werden), ihnen
können Adressen
+ Crossover-Kabel zwischen 2 Computer betrachtet werden), ihnen
können Adressen
zugewiesen (und geroutet oder NATed, gefiltert mit IPF, usw. ...)
oder als
Teil einer Bridge hinzugefügt werden.</para>
</sect2>
@@ -128,7 +131,7 @@
(laden Sie die Datei
<filename>xen-2.0.x-install.tgz</filename>
herunter). Entpacken Sie hieraus die Datei
- <filename>xen.gz</filename>und kopieren Sie sie in das
root-Dateisystem.
+ <filename>xen.gz</filename> und kopieren Sie diese in das
root-Dateisystem.
</para>
<para>
@@ -137,7 +140,7 @@
als Teil der i386 binaries bereitgestellt wird; allerdings
könnten Sie diesen
anpassen wollen. Behalten Sie den NetBSD/i386-Kernel bei, er
könnte für einen
Recovery-Fall hilfreich sein. <emphasis>Hinweis: Stellen Sie
sicher, dass der Kernel
- KERNFS unterstützt wird und <filename>/kern</filename>
bereits gemountet ist.
+ KERNFS unterstützt und <filename>/kern</filename> bereits
gemountet ist.
</emphasis>.
</para>
@@ -150,9 +153,8 @@
</para>
<para>
- Hier ist ein selbsterläternde
- <filename>/grub/menu.lst</filename>
- file:
+ Hier ist eine selbsterklärende Beispiel-Konfigurationsdatei
+ (<filename>/grub/menu.lst</filename>):
</para>
<programlisting>
@@ -216,7 +218,7 @@
xentool-Dienst (<command>/usr/pkg/share/examples/rc.d/xend
start</command>).
Stellen Sie sicher, dass die Dateien
<filename>/dev/xencons</filename> und
<filename>/dev/xenevt</filename> existieren bevor
- <command>xend</command>gestartet wird.
+ <command>xend</command> gestartet wird.
Diese Dateien können mit folgendem Befehl erstellt werden:
<programlisting>
@@ -269,7 +271,7 @@
# Zuweisung des Arbeitsspeicher (in Megabyte) für die neue domain.
memory = 128
-# Hier wird ein Name für die neue domain vergeben welcher u.a als
Bezeichnung
+# Hier wird ein Name für die neue domain vergeben welcher u.a. als
Bezeichnung
# in der Ausgabe des Befehls 'xm list' erscheint. Diese Bezeichnung kann
# ebenfalls anstelle der domain-Nummer als Parameter für
xm-Befehle verwendet
# werden.
@@ -294,8 +296,8 @@
# um die xvif-Schnittstelle in domain0 zu konfigurieren. Hierbei wird der
# erforderliche Parameter 'bridge' an das vif-Script übergeben.
# Wir können alle mögliche Informationen hier übergeben.
-# In unserem Beispiel wird xvif nicht der bridge hinzugefügt
dafü aber
-# mit einer privaten Adresse konfiguriert.
+# In unserem Beispiel wird xvif nicht der bridge hinzugefügt
dafür
+# aber mit einer privaten Adresse konfiguriert.
vif = [ 'mac=aa:00:00:50:02:f0, bridge=10.0.0.254 netmask 255.255.255.0' ]
@@ -411,7 +413,7 @@
</programlisting>
<para>Das Ausführen des folgenden Befehls sollte eine domain
erstellen und hierin den in der Konfigurationsdatei
- <filename>/etc/xen/nbsd</filename>
+ <filename>/usr/pkg/etc/xen/nbsd</filename>
definierten NetBSD-kernel laden:</para>
<programlisting>xm create -c /usr/pkg/etc/xen/nbsd</programlisting>
@@ -446,7 +448,7 @@
sein sofern die Option zur Installation via CD/DVD-ROM
übernommen
wurde.</para>
- <para>nschliessend führe
+ <para>Anschliessend führe
<command>halt -p</command>
in der neuen domain aus (kein reboot oder halt. INSTALL_XENU wird
jedesmal neu geladen bis die Konfigurationsdatei wieder angepasst
@@ -454,10 +456,10 @@
<filename>/usr/pkg/etc/xen/nbsd</filename> und starten Sie die
neue domain
erneut. Nun sollte es möglich sein <command>root on
xbd0a</command>
zu verwenden und Sie haben ein zweites, funktionsfähiges
- NetBSD/i386-System unter deiner xen-Installation.</para>
+ NetBSD/i386-System unter der xen-Installation.</para>
<para>Während des boot-Vorgang der neuen domain sieht man einige
- Warnungen hinsichtlich <emphasis>wscons</emphasis> wscons und der
- pseude-terminals; dies kann korrigiert werden indem die Dateien
+ Warnungen hinsichtlich <emphasis>wscons</emphasis> und der
+ pseudo-terminals; dies kann korrigiert werden indem die Dateien
<filename>/etc/ttys</filename> und
<filename>/etc/wscons.conf</filename>.
editiert werden. Es müssen alle terminals, bis auf
<emphasis>console</emphasis>, in <filename>/etc/ttys</filename>
@@ -471,8 +473,8 @@
</programlisting>
<para>Abschliessend müssen alle Screens in der Datei
<filename>/etc/wscons.conf</filename> auskommentiert werden.
- Es sollte ebenso folgender Eintrag in der Datei rc.conf der
- neuen domain hinzuzufügt bzw. entsprechend angepasst werden:
+ Es sollte ebenso folgender Eintrag in der Datei rc.conf
+ hinzuzufügt bzw. entsprechend angepasst werden:
<programlisting>
powerd=YES
@@ -484,11 +486,11 @@
<sect2 id="Linux-domains">
<title>Erstellen von unprivilegierten Linux domains</title>
- <para>Das Erstellen von unprivilegierten Linux domains ist
- nicht wesentlich unterschiedlich zu unprivilegierten NetBSD
- domains, aber es gibt einige Dinge die man wissen sollte.</para>
+ <para>Es gibt keinen erheblichen Unterschied zwischem dem
+ Erstellen von unprivilegierten Linux domains und NetBSD
+ domains, aber es gibt einige Dinge die man beachten sollte.</para>
<para>Zu allererst der zweite Parameter bezüglich der Festplatte
- (die "wd0d" im unten stehenden Beispiel) ist bezogen auf Linux:
+ (die "wd0d" im unten stehenden Beispiel) bei Linux:
<programlisting>
disk = [ 'phy:/dev/wd0e,wd0d,w' ]
@@ -518,19 +520,87 @@
</para>
<para>Um Linux auf die Partition der Gast-domain zu installieren
kann die
- folgende Methode verwendet werden: install sysutils/e2fsprogs
from pkgsrc.
- Um die Root-Partition der Linux-domain zu formatiern verwende
mke2fs und
- mounte es dann. Anschliessend kopiere die Dateien eines
funktionierenden
- Linux-Systems, führe Anpassungen in etc (fstab,
Netzerk-Konfiguration)
- durch. Es sollte ebenso möglich sein binary Packages wie
.rpm oder .deb
- direkt zur gemounteten Partition zu extrahiert, unter Verwendung
des passenden
- Tools, als NetBSD's Linux-Emulation laufen zu lassen. Nachdem das
Dateisystem
- bekannt gemacht wurde unmounte es. Wenn gewünscht kann das
Dateisystem
- unter Verwendung von "tune2fs -j" zu ext3 konvertiert werden. Es
sollte nun
- möglich sein die Linux-Gast-domain zu booten wenn einer der
vmlinuz-*-xenU
+ folgende Methode verwendet werden: Installieren Sie
sysutils/e2fsprogs von
+ pkgsrc. Um die Root-Partition der Linux-domain zu formatiern
verwenden Sie
+ mke2fs und mounten es dann. Anschliessend kopieren Sie die
Dateien eines
+ funktionierenden Linux-Systems, führe Anpassungen in etc (fstab,
+ Netzerk-Konfiguration) durch. Es sollte ebenso möglich sein
binary
+ Packages wie .rpm oder .deb direkt zur gemounteten Partition zu
extrahiert,
+ unter Verwendung des passenden Tools, als NetBSD's
Linux-Emulation laufen
+ zu lassen. Nachdem das Dateisystem bekannt gemacht wurde
unmounten Sie es.
+ Wenn gewünscht kann das Dateisystem unter Verwendung von
"tune2fs -j"
+ zu ext3 konvertiert werden. Es sollte nun möglich sein die
+ Linux-Gast-domain zu booten wenn einer der vmlinuz-*-xenU
Kernel aus der Xen binary distribution verwendet werden.
</para>
</sect2>
</sect1>
+ <sect1 id="pci-devices">
+ <title>Verwenden von PCI-Geräten in Gast-domains</title>
+ <para>Der hypervisor erm÷glicht den Zugriff zu ausgewählten
PCI-Geräten
+ anderer domains als domain0. Dies kann zum Beispiel einer
unprivilegierten domain
+ den Zugriff zu einer Netzwerkkarte oder Festplattencontroller
ermöglichen.
+ Bedenken Sie, dass das ermöglichen des Zugriffs auf ein
PCI-Gerät einer
+ domain ebenso lese-/schreibzugriff zum physikalischen Speicher
bedeutet, da PCs
+ keinen IOMMU für die Eingeschränkung des Zugriffs auf
DMA-fähige
+ Geräte besitzen. Ebenso ist es nicht möglich
ISA-Geräte zu
+ unprivilegierten domains zu exportieren (was bedeutet, dass der
primäre
+ VGA-Adapter nicht exporiert werden kann. Eine Gast-domain die
versucht auf die
+ VGA-Register zuzugreifen gerät in einen sogenannten
panic-Zustand).
+ </para>
+ <para>Vor dem exportieren eines PCI-Gerätes zu einer
Gast-domain ist es
+ empfehlenswert den hypervisor dahingehend zu konfigurieren, dass dieses
+ PCI-Gerät von der domain0 nicht erkannt werden. Dies erreicht
man anhand
+ der Option physdev_dom0_hide auf der boot Kommandozeile. Das Format
ist:
+<programlisting>
+physdev_dom0_hide='(%02x:%02x.%1x)(%02x:%02x.%1x)...'
+</programlisting>
+ </para>
+ <para>Als nächstes bauen Sie einen domainU-Kernel mit
Unterstützung
+ für die Geräte die Sie verwenden wollen. Hier ein Beispiel:
+<programlisting>
+include "arch/i386/conf/XENU"
+
+# Hinzufügen von PCI-Bus-Unterstützung zum XENU-Kernel
+pci* at hypervisor? bus ?
+
+# Jetzt füge PCI und verbundene Geräte hinzu die
+# von dieser domain verwendet werden sollen.
+# USB-Kontroller und Geräte
+
+# PCI USB Kontroller
+uhci* at pci? dev ? function ? # Universal Host Controller (Intel)
+
+# USB-Bus-Unterstützung
+usb* at uhci?
+
+# USB-Hubs
+uhub* at usb?
+uhub* at uhub? port ? configuration ? interface ?
+
+# USB Mass Speicher
+umass* at uhub? port ? configuration ? interface ?
+wd* at umass?
+
+# SCSI-Kontroller
+ahc* at pci? dev ? function ? # Adaptec [23]94x, aic78x0 SCSI
+
+# SCSI-Bus-Unterstützung (sowohl für ahc als auch umass)
+scsibus* at scsi?
+
+# SCSI-Geräte
+sd* at scsibus? target ? lun ? # SCSI disk drives
+cd* at scsibus? target ? lun ? # SCSI CD-ROM drives
+</programlisting>
+Abschliessend fügen Sie das PCI-Gerät zum Export zu Ihrer
domain's Konfigurationsdatei hinzu:
+<programlisting>
+# Export der PCI-Geräte. Die Zahlen können hier
+# sowohl dezimal als auch hexadezimal angegeben werden.
+pci = [ '0,4,2','0,6,0' ]
+</programlisting>
+Beim booten sollten Sie, zusätzlich zu den üblichen xbd und
+xennet-Geräten, die PCI-Busse und die Geräte sehen welche
+Sie exportiert haben.
+ </para>
<parentsec url="./" text="NetBSD/xen Port Page" />
</webpage>
----------------------------------------------------------------------------------------------------------------------------------------
cvs diff -bu ./htdocs/de/index.html
Index: ./htdocs/de/index.html
===================================================================
RCS file: /cvsroot/htdocs/de/index.html,v
retrieving revision 1.518
diff -b -u -r1.518 index.html
--- ./htdocs/de/index.html 2 Oct 2005 23:04:43 -0000 1.518
+++ ./htdocs/de/index.html 7 Oct 2005 23:01:54 -0000
@@ -346,7 +346,7 @@
<a href="../Ports/sun3/">sun3</a>
<a href="Ports/vax/">vax</a>
<a href="../Ports/x68k/">x68k</a>
- <a href="../Ports/xen/">xen</a>
+ <a href="Ports/xen/">xen</a>
</font>
<p>
kind regards,
Rainer