Difference between revisions of "Set up new FieldWorks development workstation"

From LSDevLinux
Jump to: navigation, search
(Or from the Chocolatey a package manager)
(FieldWorks test vagrant machine)
Line 53: Line 53:
  
 
Use Synaptic to choose which repositories to enable (such as llso:experimental).
 
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

Revision as of 11:25, 27 February 2018

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 https://www.vagrantup.com/ .

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
   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.

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