ia64/xen-unstable

view stubdom/README @ 17916:10e79ad54c91

blktap: Extend userland busid to 32 bits

Signed-off-by: Chris Lalancette <clalance@redhat.com>
author Keir Fraser <keir.fraser@citrix.com>
date Fri Jun 27 16:08:56 2008 +0100 (2008-06-27)
parents c8d9ade45781
children 0d88b4b86428
line source
1 To compile
2 ==========
4 Just run make -j 4, that will download / patch / compile
5 Then make install to install the result.
7 Also, run make and make install in $XEN_ROOT/tools/fs-back
11 IOEMU stubdom
12 =============
14 This boosts HVM performance by putting ioemu in its own lightweight domain.
16 General Configuration
17 =====================
19 In your HVM config "hvmconfig",
21 - use /usr/lib/xen/bin/stubdom-dm as dm script:
23 device_model = '/usr/lib/xen/bin/stubdom-dm'
25 - comment the disk statement:
27 #disk = [ 'file:/tmp/install.iso,hdc:cdrom,r', 'phy:/dev/sda6,hda,w', 'file:/tmp/test,hdb,r' ]
29 - disable anything related to dom0, like pty serial assignments
32 Create /etc/xen/stubdom-hvmconfig (where "hvmconfig" is the name of your HVM
33 guest) with
35 kernel = "/usr/lib/xen/boot/ioemu-stubdom.gz"
36 vif = [ '', 'ip=10.0.1.1,mac=aa:00:00:12:23:34']
37 disk = [ 'file:/tmp/install.iso,hdc:cdrom,r', 'phy:/dev/sda6,hda,w', 'file:/tmp/test,hdb,r' ]
39 where
40 - the first vif ('') is reserved for VNC (see below)
41 - 'ip=10.0.1.1,mac= etc...' is the same net configuration as in the hvmconfig
42 script,
43 - and disk = is the same block configuration as in the hvmconfig script.
45 Display Configuration
46 =====================
48 There are three posibilities
50 * Using SDL
52 - In hvmconfig, disable vnc and sdl:
54 vnc = 0
55 sdl = 0
57 - In stubdom-hvmconfig, set an sdl vfb:
59 vfb = [ 'type=sdl' ]
61 * Using a VNC server in the stub domain
63 - In hvmconfig, set vnclisten to "172.30.206.1" for instance. Do not use a
64 host name as Mini-OS does not have a name resolver. Do not use 127.0.0.1 since
65 then you will not be able to connect to it.
67 vnc = 1
68 vnclisten = "172.30.206.1"
70 - In stubdom-hvmconfig, fill the reserved vif with the same IP, for instance:
72 vif = [ 'ip=172.30.206.1', 'ip=10.0.1.1,mac=aa:00:00:12:23:34']
74 * Using a VNC server in dom0
76 - In hvmconfig, disable vnc and sdl:
78 vnc = 0
79 sdl = 0
81 - In stubdom-hvmconfig, set a vnc vfb:
83 vfb = [ 'type=vnc' ]
85 and any other parameter as wished.
87 To run
88 ======
90 mkdir -p /exports/usr/share/qemu
91 ln -s /usr/share/qemu/keymaps /exports/usr/share/qemu
92 mkdir -p /exports/var/lib
93 ln -s /var/lib/xen /exports/var/lib
94 /usr/sbin/fs-backend &
96 xm create hvmconfig
100 PV-GRUB
101 =======
103 This replaces pygrub to boot domU images safely: it runs the regular grub
104 inside the created domain itself and uses regular domU facilities to read the
105 disk / fetch files from network etc. ; it eventually loads the PV kernel and
106 chain-boots it.
108 Configuration
109 =============
111 In your PV config,
113 - use /usr/lib/xen/boot/pv-grub.gz as kernel:
115 kernel = "/usr/lib/xen/boot/pv-grub.gz"
117 - set the path to menu.lst, as seen from the domU, in extra:
119 extra = "(hd0,0)/boot/grub/menu.lst"
121 you can also use a tftp path (dhcp will be automatically performed):
123 extra = "(nd)/somepath/menu.lst"
125 or you can set it in option 150 of your dhcp server and leave extra empty
127 Limitations
128 ===========
130 - You can not boot a 64bit kernel with a 32bit-compiled PV-GRUB and vice-versa.
131 To cross-compile a 32bit PV-GRUB,
133 export XEN_TARGET_ARCH=x86_32
135 - bootsplash is supported, but the ioemu backend does not yet support restart
136 for use by the booted kernel.