Set up new FieldWorks development workstation

From LSDevLinux
Revision as of 14:01, 21 June 2018 by Mstrobert (talk | contribs) (Set up FW dev machine)

Jump to: navigation, search

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.

Install vagrant and virtualbox

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 . 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
  • 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 is vagrant.

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