||3 years ago|
|.gitignore||6 years ago|
|LICENSE||6 years ago|
|README.md||3 years ago|
|configvmrc||3 years ago|
|fbopt||3 years ago|
|qvm||3 years ago|
Trivial management of 64 bit virtual machines with qemu.
Table of contents
- Table of contents
- What this script will do
- Setup information and usage
- Connection to the machine
- VNC options
- Automatic remote startup
- Interesting applications
See all qvm releases.
What this script will do
It can handle:
- Virtual hard disk creation, backup and deletion.
- Basic network management: three ports are exposed to the host machine (but you can add as many as you want). One of these two ports is SSH.
- Shared directory between host and guest.
- Running the virtual machine with a combination of the previous options.
- You need a 64 bit machine with virtualization technology and at least 4 GB of RAM.
configvmrcbased on your needs. Variables are self-explanatory and I have kept mine as an example.
You need to install the following packages and the ones listed for fbopt
|Package||Executable||Version command||Package version|
Arch Linux based distros
# pacman -S coreutils openssh tigervnc qemu
Usage: qvm [OPTION] Trivial management of 64 bit virtual machines with qemu. Only a single option is accepted. By default, the backup vhd is run. Mandatory arguments to long options are mandatory for short options too. Options: -a, --attach connect via SSH -b, --backup backup the vhd -c, --create create a new vhd -d, --delete delete the vhd backup -h, --help print this help -i, --install install the image on a vhd -m, --mkdir-shared create a shared directory -n, --nox run vm without graphical output -o, --orig run from the original vhd -r, --remote connect to a remote instance of QVM -v, --vnc use VNC -x, --run run the vm Exit status: 0 if OK, 1 if an error occurred. CC0 License Written in 2018 by Franco Masotti/frnmst <firstname.lastname@example.org>
Setup information and usage
Actions and parameters
You can make some combinations between actions and places. Both of these elements are parameters.
Create a new virtual hard disk and complete the OS installation which can also be done via SSH.
$ ./qvm --create && ./qvm --install
Optionally enable the SSH daemon on the guest machine.
Optionally create a new backup VHD:
$ ./qvm --backup
Now you can run the virtual machine either using the original or the backup virtual hard disk. If you run
./qvm --runthe virtual machine will run in graphics mode using the backup hard disk.
Optionally add the following in the guest machine fstab file (
/etc/fstab), to enable the shared directory automatically. This avoids entering mount commands by hand.
host_share /home/vm/shared 9p noauto,x-systemd.automount,trans=virtio,version=9p2000.L 0 0
Connection to the machine
You can also access the virtual machine through SSH:
$ ./qvm --attach
or, if you are working on another computer,
$ ./qvm --attach --remote
The VNC options in this script allow you to connect to a remote instance of QEMU. This is particularly useful if, for example, your local machine does not support virtualization.
Note: the VNC traffic goes through SSH TCP forwarding, so it is encrypted.
For this to work, you must add the following lines in the SSH daemon configuration of the host computer:
AllowTcpForwarding yes AllowAgentForwarding yes
You must run QVM with one of the VNC options on the server side.
On the client side you must simply edit the
HOST_USERNAME variables in the configuration file.
To intall a virtual machine remotely, on the server side you must run:
$ ./qvm --create && ./qvm --install --vnc
and on the client side:
$ ./qvm --attach --remote --vnc
At this point you should see your virtual machine running in a TigerVNC window.
Automatic remote startup
To automatically start the virtual machine from a non-host computer you can
--remote option. Make sure that both the local
(non-host) and the remote host computer have a copy of the QVM repository with
the variables correctly set in the
This script will start the virtual machine if on the host computer no other
virtual machine is running. You can use either a VNC or headless
connection. Both of them require that SSH is configured correctly on the
computers, i.e. the host must be reachable from the client via SSH. This can be verified by using the
--attach --remote options while the
virtual machine is already running.
Once you have checked that everyting works, you can add a command alias in
your shell configuration file (e.g:
~/.bashrc), something like:
alias vm='/home/user/scripts/qvm/qvm --run --remote --vnc'
--nox by default. If you don't need VNC:
alias vm='/home/user/scripts/qvm/qvm --run --remote'
Virtual machine hard disk over a network protocol
If you happen to use a form of network filesystem, such as GlusterFS, you can keep the machine hard disk off the host and put it on another computer. There might be a some form of lag depending on the hardware, protocol and network connections.
An example with GlusterFS might be:
This will work provided that you install the QEMU GlusterFS block module package (if it's not already present in the QEMU package itself).
You should consult the QEMU's manual to learn about all possible compatible network filesystems.
- If you want to use
--vnccombined, you must first disable any
ControlPathoptions associated to the user and host in control of the virtual machine. These options can be found in the client's SSH configuration file which is usually
Creative Commons Zero (CC0).