Working with GMS virtual machines (vagrant virtualbox)

Notes on configuring virtual machines

Once you clone the GMS installation repo:

git clone https://github.com/genome/gms.git
cd gms

You can modify the vagrantfile Vagrantfile.standalone.virtualbox to configure host resources used by the virtual machine. In particular refer to the --memory and --cpus options in this file.

If you want to run multiple GMS virtual machines concurrently you can clone the gms repo into multiple locations and install the GMS as normal except each of these must have a unique host port in their vagrant file. For example,

gms1:

config.vm.network :forwarded_port, guest: 80, host: 9003

gms2:

config.vm.network :forwarded_port, guest: 80, host: 9004

To control the location of VDI images you will have to modify both Vagrantfile.standalone.virtualbox and setup/bin/vm-drive-setup-host.sh. For example, in Vagrantfile.standalone.virtualbox you might change vagrant_root + tmp-disk.vdi to /Volumes/Data1/tmp-disk.vdi. Similarly, in setup/bin/vm-drive-setup-host.sh you would replace all instances of tmp-disk.vdi with /Volumes/Data1/tmp-disk.vdi. And so on for other VDI locations.

If you are testing the GMS installation you can start from scratch by simply exiting the VM, removing the VM by vagrant destroy in the directory with your vagrantfile and then simply deleting the entire directory where you cloned the GMS repo.