Skip to content

samvera-deprecated/geo_works

Folders and files

NameName
Last commit message
Last commit date
Apr 23, 2018
Mar 14, 2017
Sep 13, 2017
Aug 30, 2016
Sep 12, 2017
Feb 21, 2017
Mar 30, 2017
Mar 30, 2017
Feb 21, 2017
Mar 30, 2017
Sep 7, 2016
Jul 25, 2016
Feb 21, 2017
Sep 6, 2017
Aug 30, 2016
Jun 7, 2017
Jan 25, 2017
Mar 30, 2017
Jun 18, 2015
Mar 27, 2018
Feb 21, 2017
Nov 19, 2016
Nov 19, 2016
Mar 13, 2018
Nov 19, 2016
Oct 26, 2017

Repository files navigation

GeoWorks

Code: Build Status Coverage Status

Docs: Documentation Status API Docs Gem Version

Rails engine that provides geospatial models for Hyrax repository applications.

Dependencies

  1. Solr
  2. Fedora Commons digital repository
  3. A SQL RDBMS (MySQL, PostgreSQL), though note that SQLite will be used by default if you're looking to get up and running quickly
  4. Redis, a key-value store
  5. ImageMagick with JPEG-2000 support
  6. GDAL
    • You can install it on Mac OSX with brew install gdal.
    • On Ubuntu, use sudo apt-get install gdal-bin.
  7. GeoServer (Optional)

Simple Tiles

GeoWorks requires the image generation library Simple Tiles.

Mac OS X:

  • Install via Homebrew: brew install simple-tiles

Linux:

  • Install dependencies:

    libgdal-dev
    libcairo2-dev
    libpango1.0-dev
    
  • Compile:

    $ git clone git@github.com:propublica/simple-tiles.git
    $ cd simple-tiles
    $ ./configure
    $ make && make install
    

Installation

Create and run a new GeoWorks application from a template:

$ rails new app-name -m https://raw.githubusercontent.com/samvera-labs/geo_works/master/template.rb
$ cd app-name
$ rake hydra:server

Add GeoWorks models to an existing Hyrax application:

  1. Add gem 'geo_works' to your Gemfile.
  2. bundle install
  3. rails generate hyrax:install
  4. rails generate geo_works:install -f

Development

  1. bundle install
  2. rake engine_cart:generate
  3. rake geo_works:dev_servers

Testing

  1. rake ci

To run tests separately:

$ rake geo_works:test_servers

Then, in another terminal window:

$ rake spec

To run a specific test:

rspec spec/path/to/your_spec.rb:linenumber

Running GeoServer for Development with Docker

MacOS

  1. Make sure you have docker engine, docker-machine, and docker-compose installed.

  2. Execute the following command in the geo_works directory:

    $ source ./run-docker.sh
    
  3. To stop the server and remove port forwarding:

    $ docker-compose stop
    $ killall ssh
    

Linux

  1. Make sure you have docker engine and docker-compose installed.

  2. Execute the following commands in the geo_works directory:

    $ docker-compose up -d
    

Running GeoServer for Development with Vagrant

  1. Make sure you have VirtualBox and Vagrant installed.

  2. Execute the following commands:

    $ git clone https://github.com/geoconcerns/geoserver-vagrant.git
    $ cd geoserver-vagrant/
    $ vagrant up