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

From LSDevLinux
Jump to: navigation, search
(Set up FW dev machine)
(Or from the Chocolatey a package manager)
Line 18: Line 18:
 
* https://www.vagrantup.com/downloads.html
 
* https://www.vagrantup.com/downloads.html
  
===== Or from the Chocolatey a package manager =====
+
===== Or from the Chocolatey package manager =====
  
 
     choco install virtualbox
 
     choco install virtualbox

Revision as of 11:33, 4 January 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).