Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
View | Details | Raw Unified | Return to bug 105177 | Differences between
and this patch

Collapse All | Expand All

(-)xen.xml.orig (-45 / +51 lines)
Lines 27-34 Link Here
27
<body>
27
<body>
28
28
29
<impo>
29
<impo>
30
This guide is currently x86-centric as that's the platform I've set up the Xen
30
This guide is focused on installing Xen on x86 processors. While Xen is
31
on. It'd be great if someone adds notes about using Xen on different platforms.
31
supported on other architectures, this guide does not yet cover them.
32
</impo>
32
</impo>
33
33
34
<p>
34
<p>
Lines 38-68 Link Here
38
38
39
<dl>
39
<dl>
40
  <dt>Domain</dt>
40
  <dt>Domain</dt>
41
  <dd>An instance of your "virtual computer", running its own kernel and user
41
    <dd>
42
  level applications</dd>
42
      An instance of your "virtual computer", running its own kernel and user
43
      level applications
44
    </dd>
43
  <dt>Dom0</dt>
45
  <dt>Dom0</dt>
44
  <dd>The "primary" domain that is running all the time and is usually
46
    <dd>
45
  responsible for things like setting up another domains and other management
47
      The "primary" domain that is running all the time and is usually
46
  tasks. It's "automatically" launched by the Xen hypervisor during the boot
48
      responsible for things like setting up another domains and other
47
  process. When the dom0 exists, Xen by default reboots the machine.
49
      management tasks. It's "automatically" launched by the Xen hypervisor
48
  </dd>
50
      during the boot process. When the dom0 exists, Xen by default reboots the
51
      machine.
52
    </dd>
49
  <dt>DomU</dt>
53
  <dt>DomU</dt>
50
  <dd>"Regular" instances of the unprivileged virtual machines. Each of them can
54
    <dd>
51
  be running different kernel version with wildly differing userspace
55
      "Regular" instances of the unprivileged virtual machines. Each of them can
52
  environment, even another operating system.
56
      be running a different kernel version with a wildly differing userspace
53
  </dd>
57
      environment, or even another operating system.
58
    </dd>
54
  <dt>Hypervisor</dt>
59
  <dt>Hypervisor</dt>
55
  <dd>A Xen-supplied software that runs at the "bare metal" of your computer and
60
    <dd>
56
  is responsible for low-level tasks like CPU scheduling, memory management and
61
      A Xen-supplied software that runs at the "bare metal" of your computer and
57
  dom0 launching upon boot.
62
      is responsible for low-level tasks like CPU scheduling, memory management
58
  </dd>
63
      and dom0 launching upon boot.
64
    </dd>
59
</dl>
65
</dl>
60
66
61
<p>
67
<p>
62
Xen comes with extensive <uri
68
Xen comes with extensive <uri
63
link="http://www.cl.cam.ac.uk/research/srg/netos/xen/documentation.html">documetnation</uri>.
69
link="http://www.cl.cam.ac.uk/research/srg/netos/xen/documentation.html">documentation</uri>.
64
It's a good idea to read through it to get familiar with its internal structure
70
It's a good idea to read through it to get familiar with its internal structure
65
as it's out of scope of this guide.
71
as it's beyond the scope of this guide.
66
</p>
72
</p>
67
73
68
</body>
74
</body>
Lines 75-82 Link Here
75
<body>
81
<body>
76
82
77
<p>
83
<p>
78
Installing the Xen hypervisor under Gentoo is a breeze, as usually :). The
84
Installing the Xen hypervisor under Gentoo is a breeze, as usual :). The
79
following will install both the hypervisor and a userspace management tools:
85
following will install both the hypervisor and userspace management tools:
80
</p>
86
</p>
81
87
82
<pre caption="Installing the Xen hypervisor">
88
<pre caption="Installing the Xen hypervisor">
Lines 113-131 Link Here
113
119
114
<p>
120
<p>
115
As Xen requires each domain to have its own kernel image loaded into memory, you
121
As Xen requires each domain to have its own kernel image loaded into memory, you
116
usually want to strip the domU kernels to the bare minimum that's required for a
122
usually want to strip the domU kernels to the bare minimum that's required for
117
proper function. Unlike the dom0 which is generally responsible for tasks like
123
proper functionality. Unlike the dom0 which is generally responsible for tasks
118
I/O to hard drives, networking stuff and graphics output, the domUs don't
124
like I/O to hard drives, networking, and graphics output, the domUs don't
119
require to worry about your HW devices at all. There's simply no need to include
125
require you to worry about your hardware devices at all. There's simply no need
120
a driver for your SCSI controller into domU kernel as it's already handled by
126
to include a driver for your SCSI controller into the domU kernel as it's
121
dom0.
127
already handled by dom0.
122
</p>
128
</p>
123
129
124
<note>
130
<note>
125
Xen itself supports a delegating of some device directly to the domU instance.
131
Xen itself supports a delegating of some device directly to the domU instance.
126
You can, for example, have a domain with a dedicated NIC or another one handling
132
You can, for example, have a domain with a dedicated NIC or another one handling
127
a TV-capture card. Such setups, usually called <b>Driver Domains</b>, are out of
133
a TV-capture card. Such setups, usually called <b>Driver Domains</b>, are
128
scope of this guide, so you should better consult the <uri
134
outside the scope of this guide, so you should consult the <uri
129
link="http://wiki.xensource.com/xenwiki/DriverDomain">Xen wiki page</uri> and/or
135
link="http://wiki.xensource.com/xenwiki/DriverDomain">Xen wiki page</uri> and/or
130
the official documentation.
136
the official documentation.
131
</note>
137
</note>
Lines 143-149 Link Here
143
149
144
<p>
150
<p>
145
Now you should configure the kernel for dom0. Please note that there are some
151
Now you should configure the kernel for dom0. Please note that there are some
146
differences from the general kernel config and don't forget to customize the
152
differences from the general kernel config. Don't forget to customize the
147
examples according to your needs, especially with regard to kernel versions and
153
examples according to your needs, especially with regard to kernel versions and
148
file paths.
154
file paths.
149
</p>
155
</p>
Lines 154-160 Link Here
154
</pre>
160
</pre>
155
161
156
<p>
162
<p>
157
Here are the most importand Xen-related settings that should take care about:
163
Here are the most important Xen-related settings that should take care about:
158
</p>
164
</p>
159
165
160
<pre caption="dom0 configuration">
166
<pre caption="dom0 configuration">
Lines 164-176 Link Here
164
170
165
Processor type and features  ---&gt;
171
Processor type and features  ---&gt;
166
  Subarchitecture Type
172
  Subarchitecture Type
167
  (<comment>Set to "Xen-compatible"</comment>)
173
  <comment>(Set to "Xen-compatible")</comment>
168
174
169
XEN  ---&gt;
175
XEN  ---&gt;
170
  [*] Privileged Guest (domain 0)
176
  [*] Privileged Guest (domain 0)
171
  &lt;*&gt; PCI device backend driver
177
  &lt;*&gt; PCI device backend driver
172
  &lt;*&gt; Block-device backend driver
178
  &lt;*&gt; Block-device backend driver
173
  <comment>(You usually want your domUs to be able to access some kind of storage :) )</comment>
179
  <comment>(You usually want your domUs to be able to access some kind of storage)</comment>
174
  &lt;*&gt; Network-device backend driver
180
  &lt;*&gt; Network-device backend driver
175
  &lt;*&gt;   Network-device loopback driver
181
  &lt;*&gt;   Network-device loopback driver
176
  &lt; &gt;  TPM-device backend driver
182
  &lt; &gt;  TPM-device backend driver
Lines 182-200 Link Here
182
  [*] Disable serial port drivers
188
  [*] Disable serial port drivers
183
  &lt;*&gt; Export Xen attributes in sysfs
189
  &lt;*&gt; Export Xen attributes in sysfs
184
190
185
<comment>FIXME: add a blurb about various config options and their meaning</comment>
191
<comment>(FIXME: add a blurb about various config options and their meaning)</comment>
186
</pre>
192
</pre>
187
193
188
<p>
194
<p>
189
Now thaty you've configured your dom0 kernel, it's time to build it. Standard
195
Now that you've configured your dom0 kernel, it's time to build it. Standard
190
<c>make</c> suggestions like <c>-j3</c> when on a two-way SMP systems apply here
196
<c>make</c> suggestions like <c>-j3</c> when on a two-way SMP system apply here
191
as well.
197
as well.
192
</p>
198
</p>
193
199
194
<pre caption="Building a dom0 kernel">
200
<pre caption="Building a dom0 kernel">
195
# <i>make O=~/xen-build/2.6.16.28-dom0</i>
201
# <i>make O=~/xen-build/2.6.16.28-dom0</i>
196
202
197
<comment>(Only if you've included module support:)</comment>
203
<comment>(Only if you've included module support)</comment>
198
# <i>make O=~/xen-build/2.6.16.28-dom0 modules modules_install</i>
204
# <i>make O=~/xen-build/2.6.16.28-dom0 modules modules_install</i>
199
</pre>
205
</pre>
200
206
Lines 208-220 Link Here
208
# <i>cp ~/xen-build/2.6.16.28-dom0/vmlinuz /boot/linux-2.6.16.28-xen0-vmlinuz</i>
214
# <i>cp ~/xen-build/2.6.16.28-dom0/vmlinuz /boot/linux-2.6.16.28-xen0-vmlinuz</i>
209
</pre>
215
</pre>
210
216
211
<note>
217
<p>
212
FIXME: when you use LILO, you're screwed as I haven't worked with it. Just go
218
Next, we'll add an entry to our bootloader (<c>grub</c>) so that we can boot
213
and search the web, I'm sure you'll find a manual about how to set it up.
219
into our Xen system.
214
</note>
220
</p>
215
221
216
<pre caption="Editting the /boot/grub/grub.conf">
222
<pre caption="Editing /boot/grub/grub.conf">
217
<comment>(Please make sure you include the correct names of the Xen and kernel images:)</comment>
223
<comment>(Please make sure you include the correct names of the Xen and kernel images)</comment>
218
224
219
# Example Xen settings for Grub
225
# Example Xen settings for Grub
220
title=Xen-3.0.2, Linux 2.6.16.28
226
title=Xen-3.0.2, Linux 2.6.16.28
Lines 223-229 Link Here
223
</pre>
229
</pre>
224
230
225
<p>
231
<p>
226
After you've double-checked that everything at least <i>seems</i> to be okay
232
After you've double-checked that everything at least <e>seems</e> to be okay
227
and/or that you have console access to the box being Xenized, try to reboot it.
233
and/or that you have console access to the box being Xenized, try to reboot it.
228
If it comes back up, chances are that you can proceed with the real joy,
234
If it comes back up, chances are that you can proceed with the real joy,
229
creating virtual domains.
235
creating virtual domains.
Lines 232-238 Link Here
232
</body>
238
</body>
233
</section>
239
</section>
234
<section>
240
<section>
235
<title>Ttroubleshooting</title>
241
<title>Troubleshooting</title>
236
<body>
242
<body>
237
243
238
<p>TODO</p>
244
<p>TODO</p>

Return to bug 105177