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

From LSDevLinux
Jump to: navigation, search
(Set up FW dev machine)
(Ubuntu 16.04)
Line 9: Line 9:
 
     sudo apt-get install vagrant virtualbox virtualbox-guest-additions-iso
 
     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/ .
+
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 ====
 
==== Windows 7 and 10 ====

Revision as of 13:13, 3 April 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/ . 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 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