qemu-1.7.0

Introduction to qemu

qemu is a full virtualization solution for Linux on x86 hardware containing virtualization extensions (Intel VT or AMD-V).

This package is known to build and work properly using an LFS-7.5 platform.

Package Information

Qemu Dependencies

Required

GLib-2.38.2, Python-2.7.6, SDL-1.2.15, and X Window System

Optional

ALSA-1.0.27, attr-2.4.47, Check-0.9.12, cURL-7.35.0, MesaLib-10.0.3, and Cyrus SASL-2.1.26

[Note]

Note

This optional dependencies list is not comprehensive. See the output of ./configure --help for a more complete list.

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/qemu

KVM Prerequisites

Before building qemu, check to see if your processor supports Virtualization Technology (VT):

egrep '^flags.*(vmx|svm)' /proc/cpuinfo

If you get any output, you have VT technology (vmx for Intel processors and svm for AMD processors). You then need to go into your system BIOS and ensure it is enabled. After enabing, reboot back to your LFS instance.

Kernel Configuration

Enable the following options in the kernel configuration and recompile the kernel if necessary:

Virtualization:  --->
  Kernel-based Virtual Machine (KVM) support: Y or M
    KVM for Intel processors support: Y or M
    KVM for AMD processors support: Y or M

The Intel or AMD settings are not both required, but the one matching your system processor is required.

For networking, check that bridge-utils-1.5 is installed and the following options in the kernel configuration are enabled:

Networking support  --->
  Networking options  --->
    802.1d Ethernet Bridging: Y or M
Device Drivers  --->
  Network device support  --->
    Universal TUN/TAP device driver support: Y or M

Installation of qemu

If xorg is not installed in /usr, then the linker needs to be told where it is. For example:

export LIBRARY_PATH=/opt/xorg/lib

Install qemu by running the following commands:

sed -e '/#include <sys\/capability.h>/ d' \
    -e '/#include "virtio-9p-marshal.h"/ i#include <sys\/capability.h>' \
    -i fsdev/virtfs-proxy-helper.c &&

./configure --prefix=/usr \
            --sysconfdir=/etc \
            --docdir=/usr/share/doc/qemu-1.7.0 \
            --target-list=x86_64-softmmu &&
make

To run the built in tests, run make V=1 check.

Now, as the root user:

make install &&
[ -e  /usr/lib/libcacard.so ] && chmod -v 755 /usr/lib/libcacard.so

You will need a dedicated group that will contain users (other than root) allowed to access the KVM device. Add the group by running the following command as the root user:

groupadd -g 61 kvm

Add any users that might use the KVM device to that group:

usermod -a -G kvm <username>

You will also need to add a Udev rule so that the KVM device gets correct permissions:

cat > /lib/udev/rules.d/65-kvm.rules << "EOF"
KERNEL=="kvm", NAME="%k", GROUP="kvm", MODE="0660"
EOF
[Note]

Note

For convenience you may want to create a symbolic link to run qemu-system-x86_64:

ln -sv qemu-system-x86_64 /usr/bin/qemu

Command Explanations

sed -e '/#include ... fsdev/virtfs-proxy-helper.c: Fixes qemu-1.7.0 to build with libcap-2.24.

--target-list=x86_64-softmmu: This switch limits the build target to the x86_64 architecture. For other hardware emulation see the --target-list list in configure's help output. Omitting this option will build all architectures.

--audio-drv-list=alsa: This switch sets the audio driver to ALSA. For other drivers see the --audio-drv-list list in configure's help output. The default audio driver is OSS.

Configuring qemu

To generate an image, run:

qemu-img create -f qcow2 vdisk.img 10G

Adjust the virtual disk size and image filename as desired. The actual size of the file will be less than specified, but will expand as it is used.

[Note]

Note

The following instructions assume you have created the optional symbolic link, qemu. Additionally, you must run qemu from an X Window System based terminal.

To install an operating system, download an iso of your choice or use a pre-intalled cdrom device. For the purposes of this example, use Fedora 16 that is downloaded as Fedora-16-x86_64-Live-LXDE.iso in the current directory. Run the following:

qemu -enable-kvm -hda vdisk.img            \
     -cdrom Fedora-16-x86_64-Live-LXDE.iso \
     -boot d                               \
     -m 384

Follow the normal installation procedures for the chosen distribution. The -boot option specifies the boot order of drives as a string of drive letters. Valid drive letters are: a, b (floppy 1 and 2), c (first hard disk), d (first CD-ROM). The -m option is the amount of memory to use for the virtual machine. If you have sufficient memory (2G or more), 1G is a reasonable value. For computers with 512MB of RAM it's safe to use -m 192, or even -m 128 (the default). The -enable-kvm option allows for hardware acceleeration. Without this switch, the emulation is relatively slow.

To run the newly installed operating system, run:

qemu -enable-kvm vdisk.img -m 384

To add networking to the instance add "-net nic -net user" to the command above. qemu provides a DHCP server for the VM and, depending on the client system, sets up networking though the host.

One problem with the above networking solution is that it does not provide the ability to connect with the local network. To do that, there are several additional steps that need to be done, all as the root user:

  • Set up bridging with bridge-utils-1.5.

  • Allow the host system to forward IP packets.

    sysctl -w net.ipv4.ip_forward=1
    

    To make this permanent, add the command to /etc/syssysctl.conf:

    cat >> /etc/sysctl.conf << EOF
    net.ipv4.ip_forward=1
    EOF
    
  • Create scripts for qemu to attach the client network device, usually visible as tap0, to the host bridge.

    cat > /etc/qemu-ifup << EOF
    #!/bin/bash
    
    switch=br0
    
    if [ -n "\$1" ]; then
      # Add new tap0 interface to bridge
      /sbin/ip link set \$1 up
      sleep 0.5s
      /usr/sbin/brctl addif \$switch \$1
    else
      echo "Error: no interface specified"
      exit 1
    fi
    
    exit 0
    EOF
    
    chmod +x /etc/qemu-ifup
    
    cat > /etc/qemu-ifdown << EOF
    #!/bin/bash
    
    switch=br0
    
    if [ -n "\$1" ]; then
      # Remove tap0 interface from bridge
      /usr/sbin/brctl delif \$switch \$1
    else
      echo "Error: no interface specified"
      exit 1
    fi
    
    exit 0
    EOF
    
    chmod +x /etc/qemu-ifdown
    
[Note]

Note

The backslashes in the above script are for convenience for cut/paste operations. The backslashes should not appear in the final scripts.

  • Start qemu with "-net nic -net tap" options.

  • If a connection, such as ssh, from the local network to the client VM is desired, the client should probably be configured with a static IP address.

Contents

Installed Programs: qemu-ga, qemu-img, qemu-io, qemu-nbd, qemu-system-x86_64, virtfs-proxy-helper, and vscclient
Installed Library: libcacard.so
Installed Directories: /etc/qemu, /usr/include/cacard, /usr/lib/qemu, /usr/share/qemu, and /usr/share/doc/qemu-1.7.0

Short Description

qemu-ga

implements support for QMP (QEMU Monitor Protocol) commands and events that terminate and originate respectively within the guest using an agent built as part of QEMU.

qemu-img

provides commands to manage QEMU disk images.

qemu-io

is a diagnostic and manipulation program for (virtual) memory media. It is still at an early stage of development.

qemu-nbd

exports Qemu disk images using the QEMU Disk Network Block Device (NBD) protocol.

qemu-system-x86_64

is the QEMU PC System emulator.

libcacard.so

is the Virtual Smart Card Emulator library.

Last updated on 2014-03-03 10:55:42 -0800