Managed Virtual Machine (MVM)

IntroductionEdit

Managed Virtual Machine (MVM) is a virtual machine that allows developers to start using DAVE's platform without wasting time in manually installing and configuring the development environment.

The MVM is created and managed using Vagrant (https://www.vagrantup.com/), which is a powerful tool that creates, configures and manages virtual development environments. Vagrant uses Providers to integrate with the hypervisor that provides the virtual machines, that for the MVM is Oracle VirtualBox (https://www.virtualbox.org/). The entire virtual environment configuration is stored in simple plain text files, including the instructions for the provisioning tool (Puppet, https://puppetlabs.com/), so that installation, management and update of the MVM is straightforward.

The MVM comes with all the development tools and source code, pre-configured, and requires only a minimal setup by the end user.

Installation and configurationEdit

To generate the image:

• download and install git
  • for Windows: https://git-for-windows.github.io/
  • for Linux: please refer to your distribution package manager
• install/configure ssh (please refer to https://git-scm.com/book/it/v2/Git-on-the-Server-Generating-Your-SSH-Public-Key)
• send us the ssh public key as described in http://wiki.dave.eu/index.php/Axel_Embedded_Linux_Kit_%28XELK%29#RSA_key_generation
• download VirtualBox from http://www.virtualbox.org and install it
  • tested with 5.0.14 (does NOT work with 5.0.0)
• download Vagrant from https://www.vagrantup.com/
  • install Vagrant
• clone the project/development kit repository (eg: git clone git@git.dave.eu:project-name/mvm.git)
• enter repository cloned directory
  • create data directory into parent directory
  • copy or move vagrant.yml.sample to vagrant.yml
  • customize VM settings (vagrant.yml): number of CPUs and RAM size
  • uncomment and set ip_adress to VM's ip address (vagrant.yml)
  • overwrite provision/modules/user/file/id_rsa with your private key (~/.ssh/username@myhost.com)
• create the VM with the following command:

vagrant up