Open Solo Vagrant VM
The solo-builder and Artoo STM32 builder both operate with Open Solo's vagrant virtual machine (VM).
You must use the vagrant virtual machine, which will have everything configured by script. We can assure you with 100% confidence that trying to run the builders naively on your own Linux machine or otherwise outside of this vagrant VM will not work. The vagrant VM is configured to have all required packages, and uses Ubuntu 14.04. Nothing newer will work. Do not attempt to upgrade the Vagrant VM, even if it suggests you do so. Everything will explode.
The vagrant VM is used for solo-builder and the Artoo builder (tup). The instructions for both will reference this readme for initial VM setup.
Windows Users download and install the following if you don't already have them:
- Virtual Box: https://www.virtualbox.org/wiki/Downloads
- Vagrant: https://www.vagrantup.com/downloads.html
Ubuntu Users install the following packages if you don't already have them:
$ sudo apt-get install virtualbox
$ sudo apt-get install vagrant
Initialize The VM
$ vagrant up from the root of root of the OpenSolo repo directory (windows command prompt or Ubuntu terminal). The vagrant VM will create itself. Scripts will run to install all the required packages in the VM. This will take approx 30 minutes on a typical internet connection. Once complete, you will be returned to the command prompt.
Vagrant VM Control
The following vagrant commands are available and useful. From the root of root of the OpenSolo repo directory (windows command prompt or Ubuntu terminal):
vagrant upstarts up the VM and returns you to the command prompt once complete. Do this to begin.
vagrant haltstops the VM and returns you to the command prompt once complete. Do this when you're done.
vagrant destroydeletes the VM entirely. Do this if you break it and start over with the initial vagrant VM setup above.
vagrant statusreturns the status of the VM.
vagrant sshbrings you into the VM. This is where you will execute and monitor the build.