README.txt
author Jens Kasten <jens@kasten-edv.de>
Mon, 19 Mar 2012 04:19:05 +0100
changeset 87 228ce8fbd4ff
parent 70 0972898cb40a
child 112 0ca5084026ff
permissions -rw-r--r--
update readme
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
     1
=========
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
     2
kvm-tools
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
     3
=========
87
228ce8fbd4ff update readme
Jens Kasten <jens@kasten-edv.de>
parents: 70
diff changeset
     4
Depend on Python version >= 2.4 and < 3.0
228ce8fbd4ff update readme
Jens Kasten <jens@kasten-edv.de>
parents: 70
diff changeset
     5
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
     6
A commandline script to use a simple guest configuration file.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
     7
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
     8
usage: kvm-admin [-h]
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
     9
                 domain_name
70
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    10
                 {boot,create,kill,modify,monitor,reboot,show,shutdown,status}
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    11
                 [option [option ...]]
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    12
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    13
optional arguments:
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    14
  -h, --help            show this help message and exit
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    15
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    16
QEMU-KVM domain:
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    17
  domain_name           Choose a KVM domain name, its the same like the
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    18
                        configuration file name
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    19
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    20
Action for a domain:
70
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    21
  {boot,create,kill,modify,monitor,reboot,show,shutdown,status}
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    22
                        Choose an action for the KVM guest
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    23
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    24
Monitor command:
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    25
  option                One ore more arguments can pass to the monitor.
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    26
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    27
usage: kvm-admin [-h] [--generate-options]
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    28
                 kvm_guest_name action [monitor [monitor ...]]
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    29
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    30
=========
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    31
Depencies
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    32
=========
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    33
List: python >=2.4 and < 3.0 
63
d52d274c7ae3 Update Readme
Jens Kasten <jens@kasten-edv.de>
parents: 55
diff changeset
    34
      python-argparse (debian package name)
70
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    35
        optional using argparse from kvmtools.config.argparse 
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    36
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    37
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    38
All others are standard python library.
54
17b08e781dc6 update and fixes befor merging branch
Jens Kasten <jens@kasten-edv.de>
parents: 51
diff changeset
    39
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    40
======
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    41
Update
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    42
======
51
8955ce280ef3 update README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 39
diff changeset
    43
When qemu-kvm change or add parameter, than the this run this command:
8955ce280ef3 update README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 39
diff changeset
    44
	generate-kvm-options --generate
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    45
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    46
# Fix: and a config with current qemu-kvm verion and compare it each run
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    47
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    48
This build a new list of all availables qemu-kvm options.
63
d52d274c7ae3 Update Readme
Jens Kasten <jens@kasten-edv.de>
parents: 55
diff changeset
    49
This is used to check if the given key in the configuration file 
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    50
is a valid qemu-kvm option.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    51
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    52
====
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    53
Info
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    54
====
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    55
The qemu-kvm option for monitor, and pidfile has default values.
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    56
But this options can be overriden in each domain configuration file.
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    57
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    58
========
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    59
Downlaod
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    60
========
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    61
1. The scripts can downloaded via webrowser as bz2, zip, or gzip archive.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    62
	http://hg.kasten-edv.de/kvm-tools
51
8955ce280ef3 update README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 39
diff changeset
    63
	https://hg.kasten-edv.de/kvm-tools --insecure
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    64
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    65
2. clone the mercurial repository. 
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    66
    hg clone http://hg.kasten-edv.de/kvm-tools  
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    67
    hg clone https://hg.kasten-edv.de/kvm-tools --insecure
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    68
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    69
============
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    70
Installation
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    71
============
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    72
Look at INSTALL.txt.
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
    73
# Fix: debian package and new setup.py 
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    74
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    75
==================
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    76
System preparation
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    77
==================
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    78
Its recommend to use an unprivileged user.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    79
It can set in the global configuration file /etc/kvm/config/kvm.cfg
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    80
Uncomment:
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    81
	# optional, add an user kvm to run the qemu-kvm process
70
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    82
	runas = kvm
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    83
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    84
Each guest configuration file can have this option too.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    85
70
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    86
Example to use a system user kvm on debian. 
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    87
If qemu-kvm already is installed,then add only the group kvm
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    88
and modify the /etc/passwd.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    89
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    90
	addgroup --gid 116 kvm_test
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    91
	adduser --system --gid 116 --uid 116 --home /var/run/kvm_test --disabled-password --shell /bin/false kvm
70
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    92
	chown kvm:kvm /var/run/kvm  (or /usr/local/var/run/kvm)
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
    93
    chmod 750 /var/run/kvm  (or /usr/local/var/run/kvm)
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    94
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    95
=============
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    96
Kernel module
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    97
=============
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    98
If the kernel shipped by your distribution you have to load the follow kernel module.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
    99
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   100
kvm-module:
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   101
	modpobe -v kvm-[intel|amd]
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   102
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   103
For using tap device:
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   104
	modprobe -v tun
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   105
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   106
===================
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   107
Guest configuration
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   108
===================
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   109
An example for a domain(guest) configuration file.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   110
The syntax values are 1:1 on commandline usage the only differ is instead using
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   111
	-option_name value
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   112
	option_name = value
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   113
63
d52d274c7ae3 Update Readme
Jens Kasten <jens@kasten-edv.de>
parents: 55
diff changeset
   114
Its exists only one tap option, which has an extend attribute.
d52d274c7ae3 Update Readme
Jens Kasten <jens@kasten-edv.de>
parents: 55
diff changeset
   115
This is only used in combination with tap device.
d52d274c7ae3 Update Readme
Jens Kasten <jens@kasten-edv.de>
parents: 55
diff changeset
   116
Its automatically add the tap device to given bridge.
d52d274c7ae3 Update Readme
Jens Kasten <jens@kasten-edv.de>
parents: 55
diff changeset
   117
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   118
The syntax to append to net = tap option is:
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
   119
    Example:
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
   120
	net = tap,bridge=bridge_name 
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
   121
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
   122
For fist run, you can use:
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
   123
	kvm-admin my_new_domain create
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
   124
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
   125
This build a very minimalistic domain config through a console based dialog.
70
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
   126
# Todo: build a python dialog script
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   127
51
8955ce280ef3 update README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 39
diff changeset
   128
Example domain configuration file:
55
1d4c061d1502 update and fixes for new structur
Jens Kasten <jens@kasten-edv.de>
parents: 54
diff changeset
   129
    name = my_first_domain
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   130
    # first drive
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   131
    drive = file=/home/kvm/my_testfile.img,if=virtio,index=0,boot=on,cache=none
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   132
    # second drive 
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   133
    drive = file=/home/kvm/my_swapfile.img,if=virtio,index=1,cache=none
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   134
    # memory for using in the guest
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   135
    m = 512
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   136
    # default language for keyboard
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   137
    k = de
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   138
    # add more then one cpu to the guest
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   139
    smp = 2
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   140
    # vnc port 5901 on the qemu-kvm host machine
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   141
    # example usage: vncviever :1 
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   142
    vnc = :1
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   143
    # first network interface
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   144
    net = nic,mac=00:50:11:22:33:00
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   145
    net = tap,bridge=br0
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   146
    # second network interace 
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   147
    net = tap,bridge=br1
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   148
    net = nic,mac=00:50:11:22:33:01
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   149
    # to run kvm guest as unprivileged user
70
0972898cb40a small typo fix in README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 63
diff changeset
   150
    runas = kvm
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   151
    # override the pidfile, the directory have to writeable
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   152
    pidfile = absolute_path_to_pidfile
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   153
    # override the monitor to use tcp connection
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   154
    monitor = tcp:localhost:4444,server,nowait
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   155
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   156
Example kvm.cfg:
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   157
    # have to set the absolute path to qemu-kvm binary
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   158
    qemu-kvm = /usr/bin/kvm
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   159
    # optional, run the process in daemon mode
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   160
    daemonize = enabled
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   161
    # optional, use cpu typ 
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   162
    cpu = core2duo
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   163
    # optional, use localtime in guest
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   164
    rtc = base=localtime
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   165
    # optinal, run as kvm user
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   166
    runas = kvm
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   167
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   168
====================
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   169
Hotplug a pci device
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   170
====================
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   171
If you plan to hotplug a device in a guest this kernel module have to load in guest. 
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   172
	modprobe -v acpiphp
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   173
	modprobe -v pci_hotplug 
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   174
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   175
Use the monitor to hotplug a device:
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   176
    # add a nic to guest
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   177
    kvm-admin my_guest monitor pci_add auto nic model=e1000
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   178
    # add a harddrive to guest
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   179
    kvm-admin my_guest monitor pci_add auto storage file=/path/to/partion_or_file,if=virtio
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   180
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   181
=============
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   182
Monitor using
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   183
=============
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   184
You can communicate with the guest monitor on commandline.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   185
Each command behind the monitor concatenate to a string. 
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   186
No quotations are needed.
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   187
51
8955ce280ef3 update README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 39
diff changeset
   188
usage: kvm-admin domain_name monitor help
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   189
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   190
Reboot or shutdown or status can send via the monitor too.
51
8955ce280ef3 update README.txt
Jens Kasten <jens@kasten-edv.de>
parents: 39
diff changeset
   191
    kvm-admin domain_name monitor system_powerdown
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   192
63
d52d274c7ae3 Update Readme
Jens Kasten <jens@kasten-edv.de>
parents: 55
diff changeset
   193
You can use the command line monitor like the orgin "ALT + CTRL + 2" monitor.
39
b0b22dee909a rename README to README.txt and update it
Jens Kasten <jens@kasten-edv.de>
parents:
diff changeset
   194
You can add an usb device or ecject cdrom etc.