Welcome to MCVirt’s documentation!¶
MCVirt - Managed Consistent Virtualisation¶
MCVirt (em-see-vert)
- Command line virtual machine management utility.
Description¶
MCVirt is a utility for managing virtual machines, supporting the following technologies:
- Ubuntu 14.04 LTS.
- KVM virtualisation.
- Clustering with optional DRBD support.
MCVirt is implemented in Python, using the the libvirt virtualisation library.
Getting started¶
MCVirt must currently be built from source into a deb package, using the build script. The package and dependencies can then be installed:
$ ./build.sh
$ sudo dpkg -i mcvirt_0.10_all.deb
$ sudo apt-get -f install
See the installation guide for other dependencies and system configuration.
Start the MCVirt nameserver and daemon by running:
$ sudo service mcvirt-ns start
$ sudo service mcvirtd start
Most commands require a username and password to the MCVirt daemon. During installation a superuser is created with username mjc
and password pass
- see permissions for information on creating new users.
Configure the volume group that MCVirt will use to store virtual machine data:
$ sudo mcvirt node --set-vm-vg <Volume Group>
See the configuration guide for further node configuration steps.
Create a VM:
$ sudo mcvirt create --cpu-count 1 --memory 512 --disk-size 8000 test-vm
See the create/remove VMs, cluster, permissions and modifying VMs guides for further administrative instructions.
Start the VM:
$ sudo mcvirt start test-vm
See the controlling VMs guide for further user instructions.
Note: Username and password can be provided on the command line with the --username
and --password
options to instead of typing them in after every command.
For information on developing on MCVirt, see the development documentation.
See the guide index for a full list of manuals
For more information, please feel free to contact us
API Documentation¶
Contents:
- mcvirt package
- Subpackages
- mcvirt.auth package
- mcvirt.client package
- mcvirt.cluster package
- mcvirt.iso package
- mcvirt.node package
- mcvirt.rpc package
- Submodules
- mcvirt.rpc.certificate_generator module
- mcvirt.rpc.certificate_generator_factory module
- mcvirt.rpc.constants module
- mcvirt.rpc.daemon_lock module
- mcvirt.rpc.lock module
- mcvirt.rpc.name_server module
- mcvirt.rpc.pyro_object module
- mcvirt.rpc.rpc_daemon module
- mcvirt.rpc.ssl_socket module
- Module contents
- mcvirt.test package
- mcvirt.virtual_machine package
- Submodules
- mcvirt.argument_validator module
- mcvirt.bash-complete module
- mcvirt.config_file module
- mcvirt.constants module
- mcvirt.exceptions module
- mcvirt.libvirt_connector module
- mcvirt.logger module
- mcvirt.mcvirt-drbd module
- mcvirt.mcvirt_config module
- mcvirt.parser module
- mcvirt.syslogger module
- mcvirt.system module
- mcvirt.utils module
- mcvirt.version module
- Module contents
- Subpackages