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

From LSDevLinux
Jump to: navigation, search
(Windows 7)
(Set up FW dev machine)
Line 30: Line 30:
  
 
* Your host's ssh key will be copied into the guest, to authenticate with gerrit in the guest.
 
* Your host's ssh key will be copied into the guest, to authenticate with gerrit in the guest.
* Start machine. If your host is Windows, you may need to do these steps using git bash rather than Command. The box is several GB and will take some time to download.
+
* Start machine. The box is several GB and will take some time to download.
  
 
     host$ cd FwSupportTools/vagrant/development/fwdev-w1604
 
     host$ cd FwSupportTools/vagrant/development/fwdev-w1604
 
     host$ vagrant up
 
     host$ vagrant up
  
* Read the instructions file on the desktop.
+
* 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:
 
* 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:

Revision as of 11:47, 7 December 2017

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