Kvmtools

2011-06-22T23:45:32Z

Whit: fixed some grammar and spelling

= kvm-admin =
'''What it does?'''
It can do the following actions: show, boot, shutdown, status and monitor.

= Howto use it =
Example, to get monitor's help:

<code>
kvm-admin my_guest monitor help
</code>

To get the command printed:

<code>
kvm-admin my_guest show
</code>

Boot a guest:

<code>
kvm-admin my_guest boot
</code>

= Features =
It's add a bridge to a given bridge from guest configuration file.

The bridge(s) have to exists.
There can individual bridges on the system and each guest can assign to different bridge.
No need to add many script files and scriptdown files.
This is set automaticly.

= Configuration File Format =
The guest configuration file has to be placed in the directory 'domains'.
The format is taken 1:1 from the command line.

To use an qemu-kvm option which doesn't have a parameter, have to use:
variable = enabled

Global configuration variabales, which all guest should effected,
can write in 'config/kvm.cfg' file.

Exampe:
# have to set the path to qemu-kvm executable
qemu-kvm = /usr/bin/kvm

daemonize = enabled
localtime = enabled

Example format:
name = my_guest
smp = 2
m = 1024
# first drive
drive = file:/path_to_image_or_lvm,[and other options]
# second drive
drive = file:/path_to_image_or_lvm,[and other options]
cdrom = my_installer.iso
daemonize = enabled
localtime = enabled

Only one exception exists.
This is only for the '-net tap' option.
There have to add an option for the bridge.

An example for tap option when using '-net nic':

# first network interface
net = nic,[and other options]
net = tap,ifname=my_iface_one,bridge=br0
# second network interface
net = nic,[and other options]
net = tap,ifname=my_iface_two,bridge=br1

= Download =
It can be downloaded on the mercurial repository on:

via Webbrowser:
http://hg.kasten-edv.de/kvm-tools (klick on bzip,gzip or zip link)

via mercurial:
hg clone http://hg.kasten-edv.de/kvm-tools

= Installation =
Please read the README for further information.

= Security=
To run the kvm process under a unprivileged user.

Add an user 'kvm' for example and add this in the guest configuration file.
runas = kvm

For each guest can assign an individual user.

When all guests should run as the user 'kvm' then add this in the global configurations file 'config/kvm.cfg'
runas = kvm

When is set in 'config/kvm.cfg' the guest configuration file does override
it, when there also is set.
runas = kvm_one

Then this process is running as user 'kvm_one'

= ToDo =
* build a init script
* build an installation routine
* add possibility to automatic create and delete guest

= Fixes =
The ordinary fixes :)

Lists, IRC

2010-07-14T03:23:19Z

Whit: cut spam

=Lists, IRC=

== Mailing Lists ==

{|
|-
! list
! topics
! subscribe
! archives
|-
| kvm@vger.kernel.org
| general and x86
| [mailto:majordomo@vger.kernel.org?body=subscribe%20kvm subscribe]
| [http://news.gmane.org/gmane.comp.emulators.kvm.devel Gmane], [http://www.spinics.net/lists/kvm spinics], [http://marc.info/?l=kvm MARC]
|-
| kvm-commits@vger.kernel.org
| kernel commit logs
| [mailto:majordomo@vger.kernel.org?body=subscribe%20kvm-commits subscribe]
| [http://news.gmane.org/gmane.comp.emulators.kvm.scm Gmane]
|-
| kvm-ia64@vger.kernel.org
| ia64
| [mailto:majordomo@vger.kernel.org?body=subscribe%20kvm-ia64 subscribe]
|
|-
| kvm-ppc@vger.kernel.org
| PowerPC
| [mailto:majordomo@vger.kernel.org?body=subscribe%20kvm-ppc subscribe]
| [http://marc.info/?l=kvm-ppc-devel MARC]
|
|}

While the lists are used mainly for development, user queries are welcome. No need to subscribe for a one-off question, just send an email. You may also want to check the various qemu resources on the web, as kvm shares the qemu user interface and networking.

Please observe the usual mailing list etiquette: don't top-post, and trim excess quotations from the mail you are replying to.

Don't post to individual kvm developers directly.

== IRC ==

Join us on '''#kvm''' at [http://freenode.net Freenode]. Don't report serious bugs on IRC; they're liable to get lost. Use the list or the [[Bugs|bug tracker]].

== Blogs and related sites ==
Haydn Solomon's [http://www.linux-kvm.com linux-kvm] site, featuring forums and a blog

Avi Kivity's [http://avikivity.blogspot.com blog]

Anthony Liguori's [http://blog.codemonkey.ws blog]

[http://virt.kernelnewbies.org/ Linux virtualization] wiki

== Forums ==

[http://forums.meulie.net/viewforum.php?f=43 KVM forum]

KVM - User contributions [en]

Kvmtools

Lists, IRC