blob: ffb5c80bec3e1b39713357b799566193fce6e644 [file] [log] [blame]
Danny ter Haar404d0ae2008-10-15 22:01:34 -07001Currently, kvm module is in EXPERIMENTAL stage on IA64. This means that
2interfaces are not stable enough to use. So, please don't run critical
3applications in virtual machine.
4We will try our best to improve it in future versions!
5
Xiantao Zhangfdae8622008-04-01 15:08:29 +08006 Guide: How to boot up guests on kvm/ia64
7
8This guide is to describe how to enable kvm support for IA-64 systems.
9
101. Get the kvm source from git.kernel.org.
11 Userspace source:
12 git clone git://git.kernel.org/pub/scm/virt/kvm/kvm-userspace.git
13 Kernel Source:
14 git clone git://git.kernel.org/pub/scm/linux/kernel/git/xiantao/kvm-ia64.git
15
162. Compile the source code.
17 2.1 Compile userspace code:
18 (1)cd ./kvm-userspace
19 (2)./configure
20 (3)cd kernel
21 (4)make sync LINUX= $kernel_dir (kernel_dir is the directory of kernel source.)
22 (5)cd ..
23 (6)make qemu
24 (7)cd qemu; make install
25
26 2.2 Compile kernel source code:
27 (1) cd ./$kernel_dir
28 (2) Make menuconfig
29 (3) Enter into virtualization option, and choose kvm.
30 (4) make
31 (5) Once (4) done, make modules_install
32 (6) Make initrd, and use new kernel to reboot up host machine.
33 (7) Once (6) done, cd $kernel_dir/arch/ia64/kvm
34 (8) insmod kvm.ko; insmod kvm-intel.ko
35
36Note: For step 2, please make sure that host page size == TARGET_PAGE_SIZE of qemu, otherwise, may fail.
37
383. Get Guest Firmware named as Flash.fd, and put it under right place:
39 (1) If you have the guest firmware (binary) released by Intel Corp for Xen, use it directly.
40
41 (2) If you have no firmware at hand, Please download its source from
42 hg clone http://xenbits.xensource.com/ext/efi-vfirmware.hg
43 you can get the firmware's binary in the directory of efi-vfirmware.hg/binaries.
44
Nick Andrew877d0312009-01-26 11:06:57 +010045 (3) Rename the firmware you owned to Flash.fd, and copy it to /usr/local/share/qemu
Xiantao Zhangfdae8622008-04-01 15:08:29 +080046
474. Boot up Linux or Windows guests:
48 4.1 Create or install a image for guest boot. If you have xen experience, it should be easy.
49
50 4.2 Boot up guests use the following command.
51 /usr/local/bin/qemu-system-ia64 -smp xx -m 512 -hda $your_image
52 (xx is the number of virtual processors for the guest, now the maximum value is 4)
53
Matt LaPlanted9195882008-07-25 19:45:33 -0700545. Known possible issue on some platforms with old Firmware.
Xiantao Zhangfdae8622008-04-01 15:08:29 +080055
Matt LaPlanted9195882008-07-25 19:45:33 -070056In the event of strange host crash issues, try to solve it through either of the following ways:
Xiantao Zhangfdae8622008-04-01 15:08:29 +080057
58(1): Upgrade your Firmware to the latest one.
59
60(2): Applying the below patch to kernel source.
61diff --git a/arch/ia64/kernel/pal.S b/arch/ia64/kernel/pal.S
62index 0b53344..f02b0f7 100644
63--- a/arch/ia64/kernel/pal.S
64+++ b/arch/ia64/kernel/pal.S
65@@ -84,7 +84,8 @@ GLOBAL_ENTRY(ia64_pal_call_static)
66 mov ar.pfs = loc1
67 mov rp = loc0
68 ;;
Matt LaPlanted9195882008-07-25 19:45:33 -070069- srlz.d // serialize restoration of psr.l
70+ srlz.i // serialize restoration of psr.l
Xiantao Zhangfdae8622008-04-01 15:08:29 +080071+ ;;
72 br.ret.sptk.many b0
73 END(ia64_pal_call_static)
74
756. Bug report:
76 If you found any issues when use kvm/ia64, Please post the bug info to kvm-ia64-devel mailing list.
77 https://lists.sourceforge.net/lists/listinfo/kvm-ia64-devel/
78
79Thanks for your interest! Let's work together, and make kvm/ia64 stronger and stronger!
80
81
82 Xiantao Zhang <xiantao.zhang@intel.com>
83 2008.3.10