View source

This tutorial shows the steps to run a Mac OSX guest under KVM ([http://kvm.qumranet.com/kvmwiki Kernel-based Virtual Machine]) on a Linux System.

If your distribution is an '''openSUSE 11.0 (IIRC)''' or later, you have only to install kvm package.

Otherwise you have to follow this tutorial to build and run latest pacthed KVM version. 

__TOC__



== Special Thanks ==

To '''Alexander Graf''' ( http://alex.csgraf.de/ )
Author of '''Virtualizing an x86 Mac OS X''' Project and of all KVM patches that make this possible.

== Disclaimer ==
{{Box Warning|" The author of this guide assumes no responsibility for anything done with this document, nor does he make any warranty, implied or explicit. If you break it, it's not my fault. "}}

Basic Rules:<br/>
# '''BACKUP EVERYTHING''', before '''TRYING ANYTHING'''. If it's important you definitely don't want to lose it.
# Read the '''MANUAL PAGES''' for the commands you are going to use, to make sure that I haven't made a mistake.
# '''BEFORE''' you hit enter, make sure the commands you type '''MAKES SENSE'''.


== Legal ==
(from Alexander Graf site)

While the EULA clearly states, that running Mac OS X only once and only on Apple hardware is allowed, this does not exclude running it legally in a virtual machine on Apple hardware. This is basically the same approach that Mac-on-Linux took, but this time with the Intel based version of Mac OS X.
Of course, as all the hardware Mac OS X runs on with this solution is virtual, the very same approach enables potential users to run it on non-Apple hardware as well, which is illegal though.

== Tutorial ==

Tutorial Environment:<br/>
Gentoo 2.6.34 amd64 Kernel


=== PreBuild Instructions ===

Build Package Requirements (Debian/Ubuntu) :
<pre>
sudo apt-get install rpm zlib1g-dev libasound2-dev libpulse-dev libsdl1.2-dev dev86 iasl quilt
</pre>
Download the latest version of KVM Sources pacthed for OSX at the url:
http://download.opensuse.org/repositories/Virtualization:/KVM/openSUSE_Factory/src/

Go to the directory where you downloaded the .rpm file.
<pre>
mkdir kvm-src
cd kvm-src
</pre>
Unpack rpm files.
<pre>
rpm2cpio ../kvm-*.src.rpm | cpio -id
tar xvvjf qemu-kvm-*.tar.bz2
</pre>

=== PrePatch Instructions ===

For '''Suse distribution''':
<pre>
quilt -v setup kvm.spec
cd kvm-*/
cp -a bios bios-mac
</pre>
 

For '''NOT Suse distribution''':

Modify kvm.spec if you have a distribution different from Suse:

You can edit this manually,

Copy it:

<pre>
cp kvm.spec kvm_nosuse.spec
</pre>

and add this line somewhere at the beginning of the kvm_nosuse.spec file:

<pre>
%define suse_version 1120
</pre>

and comment out the %suse_kernel_module_package line (if exists):

<pre>
#%suse_kernel_module_package
</pre>

ore you can do the same by this command:

<pre>
cat kvm.spec | sed '/Name:/ i\
%define suse_version 1120
'| sed 's/%suse_kernel_module_package/#%suse_kernel_module_package/' > kvm_nosuse.spec
</pre>

Prepare patches:

<pre>
quilt -v setup kvm_nosuse.spec
</pre>

Change directory:
<pre>
cd qemu-kvm-*/
</pre>

Copy bios directory:
<pre>
cp -a kvm/bios kvm/bios-mac
</pre>

=== Patch Instructions ===

Apply The pacthes
<pre>
quilt push -a -v
</pre>

=== Build Instructions ===

Compile it:
<pre>
./configure
make
</pre>

Compile bios-mac:
<pre>
cd kvm/bios-mac
make
cd ../..
</pre>

=== Install Instructions ===

Install Official KVM package (optional):
<pre>
sudo apt-get install kvm
</pre>

Install new KVM module:
<pre>
sudo make install
</pre>

Load new KVM module:
<pre>
sudo modprobe kvm_intel (or kvm_amd)
</pre>

Copy MAC BIOS in the correct location:
<pre>
sudo cp kvm/bios-mac/BIOS-bochs-latest /usr/local/share/qemu-kvm/bios-mac.bin
</pre>

Download the bootloader:
<pre>
cd ~
mkdir kvm-osx-bootloader
cd kvm-osx-bootloader
wget http://alex.csgraf.de/qemu/boot
cd ~
</pre>

=== Start Up Instructions ===

If you don't have a OSX partition, you can create a disk image file to use as HD device.
Mac OSX Leopard Installation requires at least 11,4 GB free space to setup, more spaces (5,5 GB) are needed for current updates, so the image file for MAC OSX setup should be at least 20 GB.
<pre>
qemu-img create -f qcow2 $MY_DISK_IMAGE_FILE 20G
</pre>

Mac OSX contains a binary protection, this means that OSX checks for an hardware key (contained in a dongle on apple machines) to correctly execute itself and the other application.
KVM has to emulate that dongle so you have to supply your hardware key.
To find your hardware key you can use the getkey script (http://alex.csgraf.de/qemu/getkey) from Alexander Graf site or look for OSK0 and OSK1 on google.
KVM needs this key as a human-readable ASCII string of 64 chars in -osk parameter.

For OpenSuse:
<pre>
QEMU_BIN=qemu-kvm
</pre>

On Other systems:
<pre>
QEMU_BIN=qemu-system-x86_64
</pre>

Start Mac OSX:
<pre>
$QEMU_BIN -M mac -kernel ~/kvm-osx-bootloader/boot \
-usb -usbdevice mouse -usbdevice keyboard -hda $MY_DISK_IMAGE_FILE \
-cdrom /dev/cdrom -m 512 -osk $HARDWARE_KEY -serial stdio
</pre>

To boot from cdrom (useful for OSX setup) you have to press "any key" immediately on BOOT screen and then write down "e0" as hexadecimal boot device code.

Debug Options:<br />
Hit F8 immediately at OSX boot to select kernel options.<br />
You could add "-v" option for verbose mode and "debug=0x8 serial=0x3" for extra debug output.