search

samvera / hyrax

Hyrax is a Ruby on Rails Engine built by the Samvera community. Hyrax provides a foundation for creating many different digital repository applications.
http://hyrax.samvera.org/
Apache License 2.0
185 stars 124 forks source link

Issues in Readme – Hyrax Setup Guide #3946

Closed julianklotz closed 3 years ago

julianklotz commented 5 years ago

Descriptive summary

The Hyrax repository contains a README file that explains how to set up a Hyrax installation for development. Some of the instructions did not work for me. Relates to using the installation template v3.0.0.pre.beta2 and 2.5.1.

Rationale

I followed the README setup guide on https://github.com/samvera/hyrax, using a fresh MacOS install running OS 10.14.6.

  1. Installing ffmpeg: the options --with-fdk-aac --with-libvpx --with-libvorbis are not valid options in current versions of Homebrew (tested on September 2nd, 2019)

  2. Following the instructions using the installation template v3.0.0.pre.beta2/template.rb, the installation on MacOS fails. There are dependencies that can’t be resolved. Tested with Ruby 2.6.4 and Rails 5.1. I switched to using the 2.5.1 template, which worked like a charme.

  3. When running bin/rails hydra:server, Solr 8 will be installed automatically. Running hydra:server fails, telling you that the fedora-development core couldn’t be created. This is because Solr 8 isn’t supported at the moment: “[…] Please be aware that the Solr field schema bundled with Hyrax does not yet support Solr 8.0.x releases. […]”. I had to specify the Solr version by adding version: 7.7.2 to the .solr_wrapper file.

    1. In the quickstart section, Hyrax Vagrant is mentioned, but this project is deprecated.
no-reply commented 5 years ago

The template issue (2) and Solr 8 support are fixed by using the current master instructions, which is to be released as beta3 in #3949.

no-reply commented 5 years ago

Thanks for this!

As far as I know, this is the first report of the ffmpeg issue. I can't diagnose it, since I don't have access to an OS X machine. Can someone try to find a working ffmpeg install process, or should we just drop the homebrew instructions?

no-reply commented 5 years ago

for (4), I'm just dropping the Quickstart section. If someone has a proposal for another easy launch (docker-compose?), I'd be happy to re-add it.

julianklotz commented 5 years ago

Quick check concerning the ffmpeg Homebrew formula:

brianmcbride commented 5 years ago

@no-reply We forked the old samvera-vagrant repository a while ago and we maintain a version here We use the samvera-vagrant to conduct a lot of our newspaper_works testing and will continue to do so for the foreseeable future. It would be easy for us to maintain a samvera-vagrant setup if there is a need within the community.

no-reply commented 3 years ago

maybe this one can be closed with all the documentation work that happened late last year?

julianklotz commented 3 years ago

Sure.

rjkati commented 3 years ago

@jlhardes I think the consensus on this ticket is that the issue has been addressed. Seems like this can be moved to "Done."