This is part of a larger tutorial created and presented as "Walkthrough of GeoConcerns".

Setting up your environment

  • Development requirements
  • Local attendees setup VirtualBox/Vagrant

Development requirements

GeoConcerns has similar prerequisites to the Hydra Curation Concerns project. There are additional dependencies related to processing geospatial data.

Software you should have installed on your development computer

Local attendees of the workshop have the option of just using the pre-created environment on the provided thumb-drive. If you are not at the workshop, you can create the virtual machine for the workshop, by following this guide.

Local attendees setup VirtualBox/Vagrant

Good news for local workshop participants, this is already done for you using VirtualBox and Vagrant. On the thumb-drive underneath a directory titled ‘geo-concerns-demo’.

Vagrant Quick Tips

After you have your virtual machine up and going, you will want to stop it. Here are a few commands that will help out.

$ vagrant halt # stops the virtual machine
$ vagrant destroy # stops and deletes the virtual machine

Vagrant for OS X and Linux

  1. Install the Mac (.dmg) version of VirtualBox and Vagrant on your machine. If you are using Linux, please download and install appropriately. VirtualBox Downloads, Vagrant Downloads

  2. If not already on your Desktop, copy the geo-concerns-demo directory and the geo-concerns-demo-data directory to your ~/Desktop directory

  3. Move to your ~/Desktop/geo-concerns-demo directory

    $ cd ~/Desktop/geo-concerns-demo

  4. Start vagrant

    $ vagrant up # This command creates and configures guest machines according to your Vagrantfile.

  5. SSH to the VM

    $ vagrant ssh # This will SSH into a running Vagrant machine and give you access to a shell.

Vagrant for Windows

Thanks to Zach Vowell who contributed this guide for Windows.

Note: Please install a Windows ssh client installed such as PuTTY.

  1. Install the Windows (.exe) version of VirtualBox and Vagrant on your machine.

  2. If not already on your Desktop, copy the geo-concerns-demo directory and the geo-concerns-demo-data directory to your Desktop C:\Users\[username]\Desktop (for Windows 7)

  3. Open a Windows Command Prompt (cmd)

  4. Move to the geo-concerns-demo directory on the Desktop

    C:\Users\[username]> cd Desktop\geo-concerns-demo

  5. Start Vagrant

    C:\Users\[username]\Desktop\geo-concerns-demo> vagrant up
# This command creates and configures guest machines according to your Vagrantfile.

  6. Open up PuTTY

  7. SSH into the Vagrant box by entering the following parameters into the “Basic Options for Your PuTTY session” window: - Host Name (or IP address): 127.0.0.1 - Port: 2222

  8. When PuTTY shell prompts for a username and password, enter “vagrant” for both. You should now see a command prompt.

Next → Create your application