Haiku installation

h1. Installing Haiku OS in a virtual machine

The Haiku OS is available in a stable version (R1/Alpha 4.1) and nightly images.
Since R1/Alpha 4.1 was released in November 2012, it is kind of outdated and
shouldn't be used for development of new applications anymore. The nightly images
are quite stable so far and can be downloaded from http://download.haiku-os.org/nightly-images/x86_gcc2_hybrid/

To compile/test Qt5 on Haiku, we recommend to use the latest VMDK image inside VirtualBox
or VMware, but you can also do a native installation on bare metal with the provided ISO images.

Once you have downloaded the ZIP archive of the VMDK (~270MB), unzip it and you'll get a haiku-nightly.vmdk
disc image. The following steps show how to setup VirtualBox to get a running Haiku system:

1) Create a new virtual machine and use Other/Unknown as operating system type and version
Step 1

2) Select an appropriated amount of RAM, 2GB should be sufficient
Step 2

3) Choose the 'Use an existing virtual hard drive file' entry and select the downloaded haiku-nightly.vmdk file.
A click on 'Create' will finalize the creation of the virtual machine.
Step 3

4) Since the haiku-nightly.vmdk contains just the system partition with little additional disc space left,
we need an additional partition (virtual hard disc) where we can keep the Qt git repository and build directory.
To add a new hard disc, open the 'Setting' dialog of the newly created virtual machine and click on
the 'Add Hard Disk' button of the IDE controller on the 'Storage' tab.
Step 4

5) Select VDI as hard drive type (or whatever else you prefer)
Step 5

6) For the VDI hard drive it is recommended to use 'Fixed size' mode, to speed up disc access during compilation
Step 6

7) In the next step select a meaningful name for that disc and select a proper size (10GB are sufficient for building qtbase)
After a click on 'Create', the virtual hard disc is created and the virtual machine ready to use.
Step 7

8) Now start the virtual machine and go through the setup wizard that is executed the first time you
run the new Haiku OS installation. When that is done and the desktop is ready, start the 'DriveSetup' tool
from the Tracker menu to format the additional virtual hard disc with a Be file system.
Step 8

9) Select the empty virtual disc in the table and choose the 'Partition > Format> Be File System…'
entry from the menu.
Step 9

10) Give the virtual disc a meaningful name and click 'Initialize' to start the formatting.
Step 10

11) Once the formatting has finished ('File system' columns shows 'Be File System'), right click on
the disc entry and select 'Mount' to mount the disc under '/'
Step 11