Bureaucrats, dave_user, Administrators
8,157
edits
Changes
→Installation and configuration
** for Windows: https://git-for-windows.github.io/
** for Linux: please refer to your distribution package manager
* install/configure ssh (please refer to for example by following [https://git-scm.com/book/it/v2/Git-on-the-Server-Generating-Your-SSH-Public-Keythis guide])* send us the ssh public key as described in http://wiki.dave.eu/index.php/[[Axel_Embedded_Linux_Kit_%28XELK%29#RSA_key_generation|here]]* download VirtualBox from [http://www.virtualbox.org download VirtualBox] and install it
** tested with 5.0.14 (does NOT work with 5.0.0)
* download Vagrant from [https://www.vagrantup.com/download Vagrant]
** 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:
<pre>
vagrant up
</pre>
After the first boot, MVM may need to restart to complete installation. To reboot the VM just run:
<pre>
vagrant reload
</pre>
== MVM Lifecycle Management ==
You may start/stop/destroy MVM from classic VirtualBox interface or using Vagrant.
In the latter case:
* to stop MVM run
<pre>
vagrant halt
</pre>
* to destroy MVM (WARNING: this remove all MVM VirtualBox files, including your customization!)
<pre>
vagrant destroy
</pre>
* to start a previously stopped MVM:
<pre>
vagrant up
</pre>
* to save MVM state to file (hibernate)
<pre>
vagrant suspend
</pre>
== Update MVM ==
To update your MVM enter MVM git repository and just:
* stop MVM
<pre>
vagrant halt
</pre>
* update git repository
<pre>
git pull
</pre>
* force Vagrant provision
<pre>
vagrant up --provision
</pre>
