Skip to content

ITDevLtd/MCVirt

Folders and files

NameName
Last commit message
Last commit date
Feb 16, 2019
Feb 6, 2019
Sep 7, 2019
Sep 17, 2019
May 28, 2015
Feb 6, 2019
Nov 5, 2018
Dec 9, 2015
Feb 15, 2019
Nov 5, 2018
May 28, 2015
Oct 20, 2018

Repository files navigation

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:

MCVirt is implemented in Python, using the libvirt virtualisation library.

MASTER BRANCH WARNING

The master branch generally continues the current development of an upcoming release.

Use the releases to obtain the latest stable release

Getting started

Installation

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_*_all.deb
$ sudo apt-get -f install

See the installation guide for other dependencies and system configuration.

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:

$ mcvirt node --set-vm-vg <Volume Group>

See the configuration guide for further node configuration steps.

Usage

Create a VM:

$ 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:

$ 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.

Development

For information on developing on MCVirt, see the development documentation.

Further information

See the guide index for a full list of manuals

For more information, please feel free to contact us

LICENSE

MCVirt is licensed under GPL v2. For more information, please see LICENSE

COPYRIGHT

Copyright © 2015 - I.T. Dev Ltd