-
Notifications
You must be signed in to change notification settings - Fork 124
Configuring an OS X Samvera Dev Environment
Adam J. Arling edited this page Sep 7, 2017
·
2 revisions
Note: This is intended primarily as a means to share notes prior to the Spring 2017 Hyrax Bootcamp. Consult the README.md for the official steps.
Tested on Ruby 2.3.1 and OS X 10.12.3
- Imagemagick:
brew install imagemagick --with-openjpeg
- run
convert -list format
in terminal and ensure that there is a JP2 entry, imagemagick has been successfully installed with JPEG-2000 support
- LibreOffice and Ghostscript:
- install LibreOffice
brew cask install libreoffice
- install ghost script
brew install ghostscript
- install LibreOffice
- FITS
- install fits
brew install fits
, note that homebrew currently installs 0.8.6 (which works currently), but Hydra Derivatives is known to be good with up to 1.0.5. To install a newer FITS follow these instructions. - ensure fits is installed (via brew),
fits -v
should show the version number
- install fits
- Redis:
- install:
brew install redis
- run:
redis-server
- alternatively:
brew services start redis
to launch redis on boot
- install:
- clone hyrax:
git@github.com:projecthydra-labs/hyrax.git
- enter the folder:
cd hyrax
- install gems:
bundle install
- generate the test app:
rake engine_cart:generate
- enter the test app:
cd .internal_test_app/
- start solr:
solr_wrapper
- ensure that
http://127.0.0.1:8983/solr/#/hydra-development
resolves in your browser
- ensure that
- start fedora:
fcrepo_wrapper
- ensure that
http://127.0.0.1:8984/rest
resolves in your browser
- ensure that
- ensure you are in the
.internal_test_app
dir - configure a workflow:
rails hyrax:workflow:load
- configure an admin_set:
rails hyrax:default_admin_set:create
- configure fits
- if you installed via homebrew:
- open
config/initializers/hyrax.rb
and findconfig.fits_path
- uncomment that line and change it to read
config.fits_path = "fits"
- open
- if you installed by some other method and
fits.sh
works in terminal, no action is needed - if you installed by some other method and neither
fits
norfits.sh
works in terminal, you need to editconfig.fits_path
(located inconfig/initializers/hyrax.rb
) to point tofits.sh
in your installation. You may also need to makefits.sh
executable.
- if you installed via homebrew:
- configure background jobs:
- open
config/application.rb
- beneath the line
class Application < Rails::Application
addconfig.active_job.queue_adapter = :inline
- open
- (optional): if you want to be an admin user
- open
config/role_map.yml
- edit your
development:
block so that it looks like:
development: archivist: - archivist1@example.com admin: - archivist1@example.com
- open
- if needed start solr, fedora, and redis:
- solr:
solr_wrapper
- fedora:
fcrepo_wrapper
- redis:
redis-server
- solr:
- launch the application:
- rails web server:
rails s
- rails console:
rails c
- rails web server:
- create a new user:
- with the server running visit
http://localhost:3000/users/sign_up?locale=en
- create a user whose email address is
archivist1@example.com
and use any password you want - you will then be able to log in and self deposit word, you will also have admin rights if you granted them to archivist1 in the optional step above
- with the server running visit
Go up a level to the hyrax
directory and make changes as you would when doing normal rails development, changes should be reflected in your app. Of course you make need to restart the server for some changes to be picked up.