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

From LSDevLinux
Jump to: navigation, search
(Ubuntu 16.04 host machine)
(Windows 7 and 10 host machine)
Line 11: Line 11:
 
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/ .
  
==== Windows 7 and 10 host machine ====
+
==== Windows and Mac host machine ====
  
 
===== From web sites =====
 
===== From web sites =====
Line 17: Line 17:
 
* https://www.virtualbox.org/wiki/Downloads and  
 
* https://www.virtualbox.org/wiki/Downloads and  
 
* https://www.vagrantup.com/downloads.html
 
* https://www.vagrantup.com/downloads.html
 
===== Or from the Chocolatey package manager =====
 
 
    choco install virtualbox
 
    choco install vagrant
 
  
 
=== Set up FW dev machine ===
 
=== Set up FW dev machine ===

Revision as of 15:30, 27 April 2020

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 on host machine

Ubuntu Linux host machine

   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 and Mac host machine

From web sites

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-w1804
   host$ vagrant up

Note: Alternatively to fwdev-w1804, you can also choose from fwdev-u1804 or fwdev-w1604. In this way you can develop in Wasta 18.04, Ubuntu 18.04, or Wasta 16.04.

  • 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-w1804
   host$ vagrant up

Use Synaptic to choose which repositories to enable (such as llso:experimental).

Note: Alternatively to fwtest-w1804, you can also choose from fwtest-u1804 or fwtest-w1604. In this way you can test in Wasta 18.04, Ubuntu 18.04, or Wasta 16.04.

  • You can delete and re-create a vagrant guest by doing the following:
   host$ vagrant destroy && vagrant box update && vagrant up
  • Note that in vagrant, the username is vagrant and the password is vagrant.