jmcglone / heliotrope

Hydra-based digital publisher platform

heliotrope

Hydra-based digital publisher platform

Development

Initial setup

• clone the repository
• run bundle install
• run bundle exec bin/setup
• install redis

Create an admin user

There is a rake task you can use to create a superadmin user. It will prompt you for an email address and password, and then create a user with the correct role.

bundle exec rake admin

If you need to run this when the app has been deployed, run:

RAILS_ENV=production bundle exec rake admin

Run the application

Run this command to start Fedora, Solr and Rails servers:

rake hydra:server

Or, if you prefer to start each server individually: (you must use this alternate option if runnig on a VM)

  $ redis-server /usr/local/etc/redis.conf
  $ bundle exec fcrepo_wrapper -p 8984 --no-jms
  $ bundle exec solr_wrapper -p 8983 -d solr/config/ --collection_name hydra-development
  $ bundle exec bin/rails s

Explain Partials

Set the EXPLAIN_PARTIALS environment variable to show partials being rendered in source html of your views (view this info using your browser's inspect element mode)

$ EXPLAIN_PARTIALS=true bundle exec bin/rails s

NOTE: Because this feature can add a fair bit of overhead, it is restricted to only run in development mode.

Testing

run rake ci

Alternatively, you can start up each server individually. This may be preferable because rake ci starts up and tears down Fedora and Solr before/after the test suite is run.

1. Start up FCrepo

   fcrepo_wrapper -p 8986 --no-jms

2. Start up Solr

   solr_wrapper -p 8985 -d solr/config/ --collection_name hydra-test

3. Run tests

   rspec