Installation/Setup

Installation Prerequisites

Install Rails

Currently hydra-head is compatible with Rails 3.2

gem install 'rails' --version '~>3.2.2'

Generate a new rails application:

rails new my_hydra_head
cd my_hydra_head

Install Dependencies

First, add them to the Gemfile of your application. You may already have a Gemfile in the new rails application you just generated; in that case, be sure to add blacklight, hydra-head, devise and the development/test group per below:

source 'http://rubygems.org'
gem 'rails', '~>3.2.3'
gem 'blacklight', '~> 3.3.2'
gem 'hydra-head', '~> 4.0.0'
# We will assume that you're using sqlite3 for testing/demo,
# but in a production setup you probably want to use a real sql database like mysql or postgres
gem 'sqlite3'
# We will assume you're using devise in tutorials/documentation.
# You are free to implement your own User/Authentication solution in its place.
gem 'devise'
# Rails uses asset pipeline. You will need these gems for used your assets in development.
# However, you won't need them in production because they will be precompiled.
group :assets do
gem 'sass-rails', '~> 3.2.0'
gem 'compass-rails', '~> 1.0.0'
gem 'compass-susy-plugin', '~> 0.9.0'
gem 'jquery-rails'
end
# You will probably want to use these to run the tests you write for your hydra head
# For testing with Cucumber
group :cucumber do
gem 'cucumber'
gem 'cucumber-rails'
end
# For testing with rspec
group :development, :test do
gem 'rspec-rails', '>=2.9.0'
gem 'jettywrapper'
gem 'database_cleaner'
end

To install all of the dependencies, run:

bundle install

On some systems, you will have to install system libraries that various gems rely on. For example, in order to install the curl gem on ubuntu you have to first install libcurl4-openssl-dev and then re-run bundler.

Even if all of the dependencies are satisfied, this will take a very long time the first time you run it. IF you become impatient, hit Ctl+C then enter this:

Modifying and Testing the hydra-head Gem

Acknowledgements

Design & Strategic Contributions

The Hydra Framework would not exist without the extensive design effort undertaken by representatives of repository initiatives from Stanford University, University of Virginia, University of Hull and MediaShelf LLC. Contributors to that effort include Tom Cramer, Lynn McRae, Martha Sites, Richard Green, Chris Awre, and Matt Zumwalt.

Thorny Staples from Fedora Commons & DuraSpace deserves special thanks for putting all of these people in the same room together.