CS Vagrant Boxes
The Computer Science department provides Vagrant boxes (pre-built VM images and provisioning scripts) that provide a useful development environment for CS courses.
Requirements
- A 64-bit processor
- At least 4GB of RAM
- At least 10GB of free disk space
Setup
A number of packages need to be installed, install all that apply to your platform.
Basic setup:
- Install VirtualBox (you will need at least version 5.2 of VirtualBox for the setup to work correctly)
- Install Vagrant (recommendation is to use the download links on the Vagrant site instead of any package manager versions)
- If you are using Windows install the Visual C++ 2010 Redistributable Package
Installation of the Virtual Machine
We provide a customised Vagrantfile via a Github repository. This allows us to provide updates as the lab configuration changes. Apart from this the standard Vagrant workflows apply.
Mac and Linux setup with Git:
git clone https://github.com/reed-college/cs-virtualmachine
cd cs-virtualmachine
vagrant plugin install vagrant-vbguest
vagrant up
vagrant ssh
USER=[your username]; sudo adduser --gecos "" $USER; sudo usermod -aG sudo $USER; sudo usermod -aG vagrant $USER; sudo ln -s /vagrant /home/$USER/; sudo chown $USER:$USER /home/$USER/vagrant
Mac and Linux setup without Git:
wget https://github.com/reed-college/cs-virtualmachine/archive/master.zip
unzip master.zip
vagrant plugin install vagrant-vbguest
vagrant up
vagrant ssh
USER=[your username]; sudo adduser --gecos "" $USER; sudo usermod -aG sudo $USER; sudo usermod -aG vagrant $USER; sudo ln -s /vagrant /home/$USER/; sudo chown $USER:$USER /home/$USER/vagrant
Run the above commands from a terminal or command shell.
The install will take 10-20 minutes to complete.
To use the Ubuntu desktop, logout of the virtual machine and run the following command after the initial install is complete:
vagrant reload
This will restart the virtual machine, and you will be given the Ubuntu login screen.
You can also edit the Vagrantfile to change the amount of memory and cores used by the virtual machine. The VirtualBox provider reference has more details.
Shared Folder
Any files saved in the cs-virtualmachine directory will be visible inside the virtual machine. On the virtual machine, the files are available in the ~/vagrant directory.
Basic Commands
vagrant suspend
"vagrant suspend" will save the current running state of the machine and stop it. When you are ready to begin working again, just run "vagrant up", and it will be resumed from where you left off. The main benefit of this method is that it is super fast, usually taking only 5 to 10 seconds to stop and start your work. The downside is that the virtual machine still eats up your disk space, and requires even more disk space to store all the state of the virtual machine RAM on disk.
vagrant halt
"vagrant halt" will gracefully shut down the guest operating system and power down the guest machine. You can use vagrant up when you are ready to boot it again. The benefit of this method is that it will cleanly shut down your machine, preserving the contents of disk, and allowing it to be cleanly started again. The downside is that it'll take some extra time to start from a cold boot, and the guest machine still consumes disk space.
vagrant up
"vagrant up" starts the machine.
vagrant destroy
"vagrant destroy" will remove all traces of the guest machine from your system. It'll stop the guest machine, power it down, and remove all of the guest hard disks. Again, when you are ready to work again, just issue a vagrant up. The benefit of this is that no cruft is left on your machine. The disk space and RAM consumed by the guest machine is reclaimed and your host machine is left clean. The downside is that "vagrant up" to get working again will take some extra time since it has to reimport the machine and re-provision it.
vagrant ssh
SSHs into the virtual machine as the vagrant user.
vagrant reload
The equivalent of running a halt followed by an up. This command is necessary to pick up changes made to the Vagrantfile. Additionally, changes to the provisioning script can be applied by adding the --provision flag.
Updating
As new tools are needed, the repository and boxes can be updated.
The repository can be updated using standard Git workflows or by redownloading the zip file. Run the following commands in the cs-virtualmachine directory:
git pull
To install only the new packages, you run the following command:
vagrant reload --provision
To completely rebuild the virtual machine, you run the following commands:
vagrant destroy
vagrant up
Note, in both cases, the files you saved in the cs-virtualmachine directory are not affected by the "vagrant destroy" command.
Troubleshooting
GUI does not load after installation
You may not be on the latest version of VirtualBox's Guest Additions. First, do a "git pull" to make sure you are on the latest version of this repository. Then download the following file https://www.virtualbox.org/download/testcase/VBoxGuestAdditions_5.2.7-120528.iso. Next, in the cs-virtualmachine folder, run "vagrant vbguest --do install --iso [PATH TO .iso FILE]" and then perform a "vagrant reload"