Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xaionaro/kvm-pool
Utility to manage KVM (Kernel Virtual Machine) instances as a pool for VNC.
https://github.com/xaionaro/kvm-pool
Last synced: 27 days ago
JSON representation
Utility to manage KVM (Kernel Virtual Machine) instances as a pool for VNC.
- Host: GitHub
- URL: https://github.com/xaionaro/kvm-pool
- Owner: xaionaro
- License: other
- Created: 2016-01-12T20:30:15.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2016-01-13T16:48:01.000Z (almost 9 years ago)
- Last Synced: 2024-05-08T21:27:01.791Z (6 months ago)
- Language: C
- Homepage: https://devel.mephi.ru/dyokunev/kvm-pool
- Size: 53.7 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Main repository: https://devel.mephi.ru/dyokunev/kvm-pool
```
NAME
kvm-pool - utility to manage KVM (Kernel Virtual Machine) instances as a pool for VNC.
SYNOPSIS
kvm-pool [ ... ] -- [ kvm-arguments ]
DESCRIPTION
kvm-pool creates a pool of virtual machines using KVM, listens specified
port and proxies connections to instances of the pool.
OPTIONS
This options can be passed as arguments or to be used in the configuration file.
To disable numeric option set to zero:
=0
To disable string option (for example path to file) set to empty string:
=
Also you can use previously set values while setting new options. Substring
%option_name% will be substituted with previously set value of option option_name.
(see CONFIGURATION FILE)
To set kvm-arguments in config file use '--'. An example:
-- = -net tap -boot n -m 512
-c, --config-file path
Sets path to the config file (see CONFIGURATION FILE).
Default: "". Changing of this options is not implemented, yet.
-K, --config-group string
Sets configuration group name (see CONFIGURATION FILE).
Default: "default". Changing of this options is not implemented, yet.
-m, --min-vms number
Minimal number of running virtual machines.
Default: 0.
-M, --max-vms number
Maximal number of running virtual machines.
Default: 64.
-s, --min-spare number
Minimal number of spare (idle) virtual machines.
Default: 1.
-S, --max-spare number
Maximal number of spare (idle) virtual machines.
Default: 8.
-r, --kill-vm-on-disconnect [0|1]
Kill the VM if the client disconnected. It's to prevent getting session of a one
user by another one.
Default: 1. Changing of this options is not implemented, yet.
-L, --listen host:port
Which port to listen for incoming VNC connections.
Default: 0.0.0.0:5900. Changing of this options is not implemented, yet.
CONFIGURATION FILE
kvm-pool supports configuration file.
By default kvm-pool tries to read next files (in specified order):
~/.kvm-pool.conf
/etc/kvm-pool/kvm-pool.conf
This may be overrided with option --config-file.
kvm-pool reads only one configuration file. In other words, if option --config-file is
not set and file ~/.kvm-pool.conf is accessible and parsable, kvm-pool will not try to
open /etc/kvm-pool/kvm-pool.conf. Command line options have precedence over config
file options.
Configuration file is parsed with glib's g_key_file_* API. That means, that config
should consits from groups of key-value lines as in the example:
[default]
max-vms = 16
min-spare = 2
[laboratory]
config-group-inherits = default
-- = -net tap -boot n -m 512
min-spare = 4
In this example there're 2 groups are set - "default" and "laboratory". And the group
"laboratory" inherited setup of the group "default" except options "min-spare".
By default kvm-pool uses group with name "default". The group name can be set by option
--config-group.
EXAMPLES
Getting a pool of virtual machines booted using PXE with 512MB RAM:
kvm-pool -- -net tap -boot n -m 512
AUTHOR
Dmitry Yu Okunev 0x8E30679C
SEE ALSO
kvm(1)
```