Difference between revisions of "Set up new FieldWorks development workstation"
(→Set up FW dev machine) |
(→Install vagrant and virtualbox) |
||
Line 3: | Line 3: | ||
For older, more advanced, and additional instructions, see [[Advanced Set up new FieldWorks development workstation]]. | For older, more advanced, and additional instructions, see [[Advanced Set up new FieldWorks development workstation]]. | ||
− | === Install vagrant and virtualbox === | + | === Install vagrant and virtualbox on host machine === |
==== Ubuntu 16.04 ==== | ==== Ubuntu 16.04 ==== |
Revision as of 09:27, 28 February 2019
This page describes how to set up a Linux FieldWorks development machine using vagrant.
For older, more advanced, and additional instructions, see Advanced Set up new FieldWorks development workstation.
Contents
Install vagrant and virtualbox on host machine
Ubuntu 16.04
sudo apt-get install vagrant virtualbox virtualbox-guest-additions-iso
If you ever find that your vagrant version is not new enough, install a newer .deb package from https://www.vagrantup.com/ . This seems to be needed on Ubuntu 16.04 where xenial's vagrant isn't new enough to support xenial's virtualbox.
Windows 7 and 10
From web sites
Or from the Chocolatey package manager
choco install virtualbox choco install vagrant
Set up FW dev machine
- Get the vagrant setup information. First cd to a desired location to clone the repository with the Vagrant definitions.
host$ git clone https://github.com/sillsdev/FwSupportTools.git
- Your host's ssh key will be copied into the guest, to authenticate with gerrit in the guest.
- Start machine. The box is several GB and will take some time to download.
host$ cd FwSupportTools/vagrant/development/fwdev-w1604 # or fwdev-w1804 host$ vagrant up
- Read the instructions file on the desktop in the machine.
- If you trash your machine, don't want to spend time fixing something that went wrong, or for whatever reason want to re-create your vagrant guest, you can delete and re-create it using:
host$ vagrant destroy && vagrant box update && vagrant up
- Note that in vagrant, the username is
vagrant
and the password isvagrant
.
Needed machine fixes in current fwdev-w1604 image
Update build scripts:
guest$ cd ~/fwrepo/FwSupportTools && git pull
Force NuGet.exe to be updated:
guest$ cd ~/fwrepo/fw/Build && rm NuGet.exe
FieldWorks test vagrant machine
You can also set up a FieldWorks test machine, to test the FieldWorks packages as a user would experience them.
Some fieldworks packages and dependencies are pre-downloaded but not installed so that the test machine starts as a clean machine.
host$ cd FwSupportTools/vagrant/testing/fwtest-w1604 host$ vagrant up
Use Synaptic to choose which repositories to enable (such as llso:experimental).
For bionic, use Wasta 18.04 instead:
host$ cd FwSupportTools/vagrant/testing/fwtest-w1804 host$ vagrant up