Pulmap

GeoBlacklight for Princeton University Library

Initial Setup

git clone https://github.com/pulibrary/pulmap.git
cd pulmap
bundle install
yarn install

Setup server

1. Install Lando DMG from https://github.com/lando/lando/releases
2. To start: bundle exec rake servers:start
3. For test:
   • bundle exec rspec
4. For development:
   • bundle exec rails s
   • Access Pulmap at http://localhost:3000/
5. To stop: bundle exec rake servers:stop or lando stop

Deployment

There are two methods for deploying Pulmap:

1. Deploy from Ansible Tower (preferred).
2. Deploy using Capistrano.
   • Connect to the Princeton VPN
   • bundle exec cap staging deploy
   • bundle exec cap production deploy

Reindex from figgy

The reindex is triggered on the figgy side.

Production

$ ssh deploy@figgy-worker-prod1
$ tmux new -t [yourname]
$ cd /opt/figgy/current
$ BULK=true bundle exec rails c
> GeoResourceReindexer.reindex_geoblacklight

Staging

$ ssh deploy@figgy-web-staging1
$ tmux new -t [yourname]
$ cd /opt/figgy/current
$ BULK=true bundle exec rails c
> GeoResourceReindexer.reindex_geoblacklight

It takes a few minutes to get all the complete georesources. Then it invokes the updated event on each, which sends them to rabbitmq.

Then you'll start to see output like "Indexed into GeoBlacklight:..."

We usually run this overnight.

Auto-update from external services

Pulmap can listen for events published on a RabbitMQ fanout exhange. In order to use them, do the following:

1. Configure the events settings in config/pulmap.yml
2. Run WORKERS=GeoblacklightEventHandler rake sneakers:run

This will subscribe pulmap to the events and update geoblacklight records when they're created, updated, or deleted.