Setting up QEMU: Difference between revisions

From KolibriOS wiki
Jump to navigation Jump to search
No edit summary
m (add a workaround for qemu "usbdevice" option warning)
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
The purpose of this tutorial is to setup KolibriOS in QEMU (virtual machine emulator).
The purpose of this tutorial is to setup KolibriOS in QEMU (virtual machine emulator).


=Using command line=
==Using command line==


If you already familiar with QEMU but have no internet access, simply add following options to the qemu start command:
If you already familiar with QEMU but have toubles with net, simply add following options to the qemu start command:


<code>-net nic,model=ne2k_pci -net user</code>
<code>-net nic,model=rtl8139 -net user</code>


It should work fine. So the whole run command looks like this:
It should work fine. So the whole run command looks like this:


<code>qemu -L . -m 128 -fda kolibri.img -boot a -hda c100.img -hdb c100_2.img -localtime -vga vmware -net nic,model=ne2k_pci -net user -soundhw ac97</code>
<code>qemu-system-i386 -L . -m 128 -fda /path/to/kolibri.img -boot a -hda /path/to/c100.img -hdb /path/to/c100_2.img -localtime -vga vmware -net nic,model=rtl8139 -net user -soundhw ac97 -usb -usbdevice tablet</code>


=Using Qemu Manager=
Where
 
-L .
: BIOS, VGA BIOS and keymaps in current directory. <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dL-93</ref>
-m 128
: Virtual RAM size to megs megabytes. <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dm-21</ref>
-fda /path/to/kolibri.img
: Floppy disk image. <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dfda-31</ref>
-boot a
: Boot floppy first. <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dboot-20</ref>
-hda /path/to/c100.img
-hdb /path/to/c100_2.img
: Hard disk image. <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dhda-33</ref>
-localtime
: Set virtual machine time to host machine time
-vga vmware
: Emulating vga card. <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dvga-60</ref>
-net nic,model=rtl8139 -net user
: Net settings. ne2k_pci, RTL8139, i8255x, i8254x and Pcnet are all supported. <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dnet-70</ref>
-soundhw ac97
: Emulating sound hardware. <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dsoundhw-26</ref>
-usb -usbdevice tablet
: The usb tablet HID device may be used to ease switching from one window to another on the host machine. (Mouse does not stay captured.) <ref>QEMU man page http://qemu.weilnetz.de/qemu-doc.html#usb_005fdevices</ref>
 
'''USB device warning'''
 
If you get a warning "''qemu-system-i386: -usbdevice tablet: '-usbdevice' is deprecated, please use '-device usb-...' instead''", use "-device usb-tablet" instead of "-usbdevice tablet"
 
'''KVM issues'''
 
If qemu complains about KVM errors (e.g. "Could not access KVM kernel module: No such file or directory"), try adding the -no-kvm flag to the command above.
 
==Copying files to HDD images in Linux==
 
Let's say you have a hi.txt file with "Hello world!" in it, and you'd like to make it available to KolibriOS easily.
 
 
First, we'll need to create an empty HDD image named hda.img and format it:
 
<code>touch hda.img
 
dd if=/dev/zero of=hda.img count=<size in KB> bs=1k</code>
 
Replace <size in KB> with the size of the image in KiloBytes, e.g. 102400 for a 100MB image.
 
<code>mkfs.msdos hda.img</code>
 
Now list files on the image:
 
<code>mdir -i hda.img</code>
 
You should see something like this:
 
  Volume in drive : has no label
  Volume Serial Number is FD16-6B35
Directory for ::/
No files
                        104 634 368 bytes free
 
 
Copying files is done via the mcopy command. Remember, the file we want to copy is hi.txt, replace it's name for different files:
 
<code>mcopy -i hda.img hi.txt ::/</code>
 
 
Listing files should reveal that we succeeded:
 
<code>mdir -i hda.img</code>
 
Example output:
 
  Volume in drive : has no label
  Volume Serial Number is FD16-6B35
Directory for ::/
hi      txt        8 2014-03-15  21:04  hi.txt
        1 file                    8 bytes
                        104 632 320 bytes free
 
 
Now we'll need to boot qemu using our new disk image, add this to the qemu command above:
 
<code>-hdc /path/to/hda.img</code>
 
Note: normally you should boot with option B set to OFF. If after boot you can not see the disk we added 1) open a bug report and 2) try booting with option B set to ON.
 
Accessing the file inside KolibriOS:
 
The new disk should be visible now, it is one of /hdX/* (if you booted with option B set to ON, it may be one of /bdX/*). Accessing it is easy, e.g. in KFM hd0/1 will already be open on the right panel.
 
 
TROUBLESHOOTING:
 
Sometimes, you may not be able to freely edit the .img virtual disk that you create and KolibriOS may show garbage values as files. Some developers prefer to use something like this :
 
qemu-system-i386 -L . -m 128 -fda /path/to/kolibri.img -boot a -localtime -vga vmware -net nic,model=rtl8139 -net user -soundhw ac97 -usb -usbdevice disk:format=raw:fat:/some/directory -usbdevice tablet
 
This will make KolibriOS mount /some/directory from your Linux machine to a USB drive on KolibriOS. You can access your files from KolibriOS using any file manager.
 
==Using Qemu Manager==


'''Step by step tutorial''' follows!
'''Step by step tutorial''' follows!
We’re going to need these programs/files:
We’re going to need these programs/files:


* Qemu Manager – download it from [http://www.davereyn.co.uk www.davereyn.co.uk]
* Qemu Manager – download it from [http://www.davereyn.co.uk www.davereyn.co.uk] or [http://qemu-manager.software.informer.com/download/ http://qemu-manager.software.informer.com/download/]
 
* KolibriOS floppy disk image – [http://www.kolibrios.org www.kolibrios.org]
* KolibriOS floppy disk image – [http://www.kolibrios.org www.kolibrios.org]


Line 66: Line 167:


Now just click Play, and let it fly!
Now just click Play, and let it fly!
==References==
<references/>


[[Category:Manuals]]
[[Category:Manuals]]

Latest revision as of 17:35, 29 May 2018

The purpose of this tutorial is to setup KolibriOS in QEMU (virtual machine emulator).

Using command line

If you already familiar with QEMU but have toubles with net, simply add following options to the qemu start command:

-net nic,model=rtl8139 -net user

It should work fine. So the whole run command looks like this:

qemu-system-i386 -L . -m 128 -fda /path/to/kolibri.img -boot a -hda /path/to/c100.img -hdb /path/to/c100_2.img -localtime -vga vmware -net nic,model=rtl8139 -net user -soundhw ac97 -usb -usbdevice tablet

Where

-L .

BIOS, VGA BIOS and keymaps in current directory. [1]

-m 128

Virtual RAM size to megs megabytes. [2]

-fda /path/to/kolibri.img

Floppy disk image. [3]

-boot a

Boot floppy first. [4]

-hda /path/to/c100.img -hdb /path/to/c100_2.img

Hard disk image. [5]

-localtime

Set virtual machine time to host machine time

-vga vmware

Emulating vga card. [6]

-net nic,model=rtl8139 -net user

Net settings. ne2k_pci, RTL8139, i8255x, i8254x and Pcnet are all supported. [7]

-soundhw ac97

Emulating sound hardware. [8]

-usb -usbdevice tablet

The usb tablet HID device may be used to ease switching from one window to another on the host machine. (Mouse does not stay captured.) [9]

USB device warning

If you get a warning "qemu-system-i386: -usbdevice tablet: '-usbdevice' is deprecated, please use '-device usb-...' instead", use "-device usb-tablet" instead of "-usbdevice tablet"

KVM issues

If qemu complains about KVM errors (e.g. "Could not access KVM kernel module: No such file or directory"), try adding the -no-kvm flag to the command above.

Copying files to HDD images in Linux

Let's say you have a hi.txt file with "Hello world!" in it, and you'd like to make it available to KolibriOS easily.


First, we'll need to create an empty HDD image named hda.img and format it:

touch hda.img

dd if=/dev/zero of=hda.img count=<size in KB> bs=1k

Replace <size in KB> with the size of the image in KiloBytes, e.g. 102400 for a 100MB image.

mkfs.msdos hda.img

Now list files on the image:

mdir -i hda.img

You should see something like this: 

 Volume in drive : has no label
 Volume Serial Number is FD16-6B35
Directory for ::/

No files
                        104 634 368 bytes free


Copying files is done via the mcopy command. Remember, the file we want to copy is hi.txt, replace it's name for different files:

mcopy -i hda.img hi.txt ::/


Listing files should reveal that we succeeded:

mdir -i hda.img

Example output: 

 Volume in drive : has no label
 Volume Serial Number is FD16-6B35
Directory for ::/

hi       txt         8 2014-03-15  21:04  hi.txt
        1 file                    8 bytes
                        104 632 320 bytes free


Now we'll need to boot qemu using our new disk image, add this to the qemu command above:

-hdc /path/to/hda.img

Note: normally you should boot with option B set to OFF. If after boot you can not see the disk we added 1) open a bug report and 2) try booting with option B set to ON.

Accessing the file inside KolibriOS:

The new disk should be visible now, it is one of /hdX/* (if you booted with option B set to ON, it may be one of /bdX/*). Accessing it is easy, e.g. in KFM hd0/1 will already be open on the right panel.


TROUBLESHOOTING:

Sometimes, you may not be able to freely edit the .img virtual disk that you create and KolibriOS may show garbage values as files. Some developers prefer to use something like this :

qemu-system-i386 -L . -m 128 -fda /path/to/kolibri.img -boot a -localtime -vga vmware -net nic,model=rtl8139 -net user -soundhw ac97 -usb -usbdevice disk:format=raw:fat:/some/directory -usbdevice tablet

This will make KolibriOS mount /some/directory from your Linux machine to a USB drive on KolibriOS. You can access your files from KolibriOS using any file manager.

Using Qemu Manager

Step by step tutorial follows! We’re going to need these programs/files:

The first thing we’re going to do is to setup KolibriOS virtual machine on Qemu Manager, so it’s assumed that you have installed it already.

Launch Qemu Manager and you will see the following window.

Img00001.gif

Click on the Img00002.gif toolbar button to add a new machine. Then it will ask you to write the new virtual machine name:

Img00003.gif

Then click Next and in that window fill the Virtual Machine RAM textbox with a RAM needed, remember that KolibriOS support 8MB of RAM as a minimum, I suggest using 64Mb

Img00004.gif

Click Next and in this window check “This Virtual Machine Does Not Require A Virtual Drive”

Img00005.gif

In the next window don’t modify anything:

Img00006.gif

Click Next and in the following window click on “Save Virtual Machine” button

Img00007.gif

It will show you the following window:

Img00008.gif

Select the “Disk Configuration” tab and click on the shown button, which is for choosing our KolibriOS floppy image:

Img00010.gif

Then select the appropiate floppy image

Img00011.gif

It will warn you but just click YES to continue:

Img00012.gif

Next select “Boot from floppy disk”

Img00013.gif

Now just click Play, and let it fly!

References

  1. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dL-93
  2. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dm-21
  3. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dfda-31
  4. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dboot-20
  5. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dhda-33
  6. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dvga-60
  7. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dnet-70
  8. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#index-g_t_002dsoundhw-26
  9. ↑ QEMU man page http://qemu.weilnetz.de/qemu-doc.html#usb_005fdevices
Retrieved from "http://wiki.kolibrios.org/index.php?title=Setting_up_QEMU&oldid=5438"