Dev Env Notes

GitHub Tip

Fork https://github.com/mlibrary/umrdr.git

git clone https://github.com/<your_github>/umrdr.git
cd /path/to/umrdr
git remote add upstream https://github.com/mlibrary/umrdr.git

Repeat after me...

• pull from upstream
• push to origin
• create pull request from origin to upstream

Bundler Tip

Running in development mode:

bundle install --without production --path=.bundle 

(Useful when gems like ClamAV is added in production block)

Need only do once

cd /path/to/umrdr/config
cp analytics.yml.sample analytics.yml
cp blacklight.yml.sample blacklight.yml
cp database.yml.sample database.yml
cp ezid.yml.sample ezid.yml
cp mcommunity.yml.sample mcommunity.yml
cp redis.yml.sample redis.yml
cp secrets.yml.sample secrets.yml
cp solr.yml.sample solr.yml

cd /path/to/umrdr
bundle exec rake db:migrate
# Failure to do the following can cause a database uniqueness exception when submitting metadata:
# "UNIQUE constraint failed: permission_templates.admin_set_id"
bundle exec rake hyrax:default_admin_set:create

Running locally (http://localhost:3000/)

run servers in separate tabs:

bundle exec fcrepo_wrapper -p 8984
bundle exec solr_wrapper -d solr/config/ --collection_name hydra-development
redis-server
bundle exec rails server

Running tests

bundle exec rake ci

Or run servers in separate tabs...

bundle exec fcrepo_wrapper -p 8986
bundle exec solr_wrapper -p 8985 -d solr/config/ --collection_name hydra-test

...to run individual specs.

bundle exec rspec ./spec/directory/file_spec.rb