This is a project to help automate the insertion of links to digitized records into EAD finding aids.

The code lives in the Berkman Center's GitHub repo.

User documentation exists in the doc folder.

• Git
• Ruby >= 2
• Bundler
• PostgreSQL (including -dev packages)
• Redis server

Bundler should take care of the rest.

• Install requirements (see above)
• Checkout the code
  • git clone https://github.com/berkmancenter/linkomatic
  • cd linkomatic
• Install libraries
  • bundle install
• Configure the database
  • cp config/database.yml.example config/database.yml
  • Setup a postgres user and update config/database.yml accordingly
  • rake db:create
  • rake db:setup
• Configure the websockets server
  • If you're using Apache, you'll need to setup config/initializers/websocket_rails.rb according to this
  • Configure config.websocket_url somewhere in your app config, probably in the various config/environments/
  • Again, if you're using Apache, you'll need to run rake websocket_rails:start_server
• Start sidekiq workers
  • sidekiq --daemon --concurrency 10 --logfile tmp/sidekiq.log
• Update the devise configs
  • Use rake secret to generate a new secret key and add it to config/initializers/devise.rb
  • Update the config.mailer_sender in config/initializers/devise.rb
• Create an admin user
  • Sign up for an account
  • Use the console (rails c) to set the admin attribute on that user, e.g. User.find(3).update_attribute('admin', true)

• Phusion Passenger, Ruby 2.1.2, Apache 2.2, Ubuntu 12.04 LTS
• Phusion Passenger, Ruby 2.1.4, Apache 2.4, Ubuntu 14.04 LTS

We maintain a closed-to-the-public issue tracker. Any additional issues can be added to the GitHub issue tracker.

The generous support of the Harvard Library Lab, the Harvard Library Office for Scholarly Communication, the Berkman Center for Internet & Society and the Arcadia Fund

• Rails
• Bootstrap
• PostgreSQL
• Redis

Justin Clark

Apache 2.0 - See the LICENSE file for details.

Copyright © 2014 President and Fellows of Harvard College