search

curationexperts-deprecated / tenejo-v1

Tenejo is a general purpose Digital Repository/Asset Management System.
Other
3 stars 2 forks source link

readme

Tenejo: a General Purpose Digital Repository

Tenejo gives you the most commonly used Samvera features and functions in an easy to use hosted solution.

CircleCI Apache 2.0 License Maintainability

Development

Prerequisites

  1. Ensure you have the prerequisites from https://github.com/samvera/hyrax, although you do not need a separately running Solr or Fedora instance in order to begin in development, since these are packaged with this application, in the form of solr_wrapper and fcrepo_wrapper.

Installing

  1. git clone https://github.com/curationexperts/tenejo.git

  2. cd ./tenejo then check out a working branch git checkout -b my_working_branch

  3. Copy .env.sample to .env.development if you want to override any default settings in your local development environment.

  4. Setup your database. We use PostgreSQL. To support the test and development environments, you'll need have Postgres installed and running.

  5. Set up your gemset using rvm (it's possible you'll need to download a new Ruby, depending on the project - rvm install [ruby-version])

    rvm list rubies
* ruby-2.5.1 [ x86_64 ]
=> ruby-2.6.3 [ x86_64 ]

# => - current
# =* - current && default
#  * - default

rvm use gemset ruby-2.6.3@tenejo --create
ruby-2.6.3 - #gemset created /Users/max/.rvm/gems/ruby-2.6.3@tenejo
ruby-2.6.3 - #generating tenejo wrappers.........
Using /Users/max/.rvm/gems/ruby-2.6.3 with gemset tenejo

  6. Run bundle install

  7. Run bundle exec rails db:setup to setup the development database and schema.

  8. Start the servers, one per terminal window/tab - bundle exec fcrepo_wrapper, bundle exec solr_wrapper, bundle exec rails server, and bundle exec sidekiq

    User and workflow setup

  9. (optional) Create standard accounts: bundle exec rails tenejo:standard_users_setup.

  10. Create default collection types: bundle exec rails hyrax:default_collection_types:create

  11. bundle exec rails hyrax:default_admin_set:create

Testing

  1. Start the test servers, one per terminal window / tab - bundle exec fcrepo_wrapper --config config/fcrepo_wrapper_test.yml, bundle exec solr_wrapper --config config/solr_wrapper_test.yml
  2. Run the tests using bundle exec rspec or bundle exec rspec spec/PATH_TO_TEST

Production

  1. Set IIIF_SERVER_URL=http://SERVERNAME/cantaloupe/iiif/2/ to use an external cantaloupe IIIF server