Fork us on GitHub Follow us on Facebook Follow us on Twitter

Changes between Version 10 and Version 11 of UsersGuide/QuickStart


Ignore:
Timestamp:
2016-04-19T15:54:16Z (3 years ago)
Author:
Jakub Jermář
Comment:

Update, use a better command line, link to GUI page, explain KVM error, link to 0.6.0 IA-32 image

Legend:

Unmodified
Added
Removed
Modified
  • UsersGuide/QuickStart

    v10 v11  
    11= Quick Start =
    22[[PageOutline]]
     3
    34(A.k.a. get HelenOS up and running in 10 minutes)
    45
    5 This method is recommended for new users. We recommend to use '''QEMU''', which we use for our day to day testing. If you use another emulator, you need to be more careful.
     6This method is recommended for new users. We recommend to use [http://qemu.org QEMU], which we use for our day to day testing. If you use another emulator, you need to be more careful.
    67
    78== Running HelenOS in QEMU ==
    89
    9 To try out HelenOS in QEMU, download the latest '''IA-32''' ISO image from the [http://www.helenos.org/download download page]. Install [http://qemu.org QEMU]. In the directory where you downloaded the HelenOS ISO image run
     10To try out HelenOS in QEMU, download the latest HelenOS ISO [http://www.helenos.org/releases/HelenOS-0.6.0-ia32.iso image] for the IA-32 architecture. Make sure a recent enough version of QEMU is installed on your system. QEMU 2.5.0 and newer should be fine. In the directory where you downloaded the HelenOS ISO image run:
     11
    1012{{{
    11 qemu-system-i386 -m 256 -boot d -cdrom image.iso
     13qemu-system-i386 -enable-kvm -drive file=hdisk.img,index=0,media=disk,format=raw -device e1000,vlan=0 -net user -redir udp:8080::8080 \
     14  -redir udp:8081::8081 -redir tcp:8080::8080 -redir tcp:8081::8081 -redir tcp:2223::2223 -usb -device intel-hda -device hda-duplex \
     15  -boot d -cdrom HelenOS-0.6.0-ia32.iso
    1216}}}
    1317
    14 You should see the GRUB and just five seconds or so later HelenOS should automatically come up.
     18You should see the GRUB boot screen and just five seconds or so later HelenOS should automatically come up. You should find yourself in the [wiki:UsersGuide/GUI HelenOS GUI] environment.
    1519
    16 For more information about running Helenos in QEMU, see [wiki:UsersGuide/RunningInQEMU]
     20For more information about running HelenOS in QEMU, see [wiki:UsersGuide/RunningInQEMU].
    1721
    1822== Running HelenOS in another emulator ==
    1923
    20 You can also use a different emulator (Bochs, [wiki:UsersGuide/RunningInVirtualBox VirtualBox], etc.). Make sure your emulator is configured to emulate a Pentium 4 or later CPU. Otherwise HelenOS won't boot and it will display a red error message.
     24You can also use a different emulator ([http://bochs.sourceforge.net Bochs], [wiki:UsersGuide/RunningInVirtualBox VirtualBox], etc.). Make sure your emulator is configured to emulate a Pentium 4 or later CPU. Otherwise HelenOS won't boot and it will display a red error message.
    2125
    22 '''Note:''' If you use a non-free/non-libre emulator (that only runs in a non-free/non-libre OS) and you run into trouble, we might not be able or might not be willing to help you, depending on the actual circumstances. Please use free/libre software instead. There is no need to use non-free/non-libre software for running or developing HelenOS.
     26{{{#!box type=note
     27If you use a non-free/non-libre emulator (that only runs in a non-free/non-libre OS) and you run into trouble, we might not be able or might not be willing to help you, depending on the actual circumstances. Please use free/libre software instead. There is no need to use non-free/non-libre software for running or developing HelenOS.
     28}}}
    2329
    2430== Troubleshooting ==
     31
     32=== Failed to initialize KVM ===
     33
     34The command line above instructs QEMU to make use of hardware virtualization via KVM. KVM is, however, not always available. Cases when KVM is not available include another virtualization software such as !VirtualBox or Xen already running on the system, incompatible host and guest such as when trying to run this guest from an ARM host, the host operating system does not support KVM (i.e. it is not a Linux system) and the host processor does not support hardware virtualization or has it disabled. In these cases, QEMU will abort with the following error message or similar:
     35
     36{{{
     37ioctl(KVM_CREATE_VM) failed: 16 Device or resource busy
     38failed to initialize KVM: Device or resource busy
     39}}}
     40
     41You should still be able to run HelenOS in QEMU, though. Either try removing one of the possible causes listed above or, if that's not a viable alternative, simply omit the `-enable-kvm` option from the command line above. Note that this will result in a slower run and a slightly worse user experience.
    2542
    2643=== The system does not come up, a red error message is displayed ===
    2744
    2845This is a problem during the GRUB/kernel transition when the kernel probes and initializes the CPU. It can mean one of two things, depending on the message:
    29  * Error: Extended CPUID not supported -- CPU is not 64-bit. System halted.
    30    * You are trying to run a 64-bit system on a 32-bit CPU! Please download the IA-32 system image instead.
    3146
    32  * Other message
    33    * The CPU is an old antique and does not have some (pretty standard) feature required by HelenOS. Make sure your simulator is configured to emulate a more recent (at least Pentium 4 or later) CPU. It is possible to configure/build HelenOS even for a 80486-class CPU, but we don't provide a pre-built image for it.
     47  * Error: Extended CPUID not supported -- CPU is not 64-bit. System halted.
     48    * You are trying to run a 64-bit system on a 32-bit CPU! Please download the IA-32 system image instead.
     49
     50  * Other message
     51    * The CPU is an old antique and does not have some (pretty standard) feature required by HelenOS. Make sure your simulator is configured to emulate a more recent (at least Pentium 4 or later) CPU. It is possible to configure/build HelenOS even for a 80486-class CPU, but we don't provide a pre-built image for it.