samvera-newspapers-vagrant

A Vagrant environment to quickly setup Newspaper_Works Hyrax

Host System Requirements (install these before proceeding)

• Vagrant version 1.8.3+
• VirtualBox version 5.1.38+
• vagrant-disksize (optional)

Test Environment Setup (provisioning of virtual machine)

1. git clone https://github.com/marriott-library/samvera-newspapers-vagrant
2. cd samvera-newspapers-vagrant
3. vagrant up

You can shell into the machine with vagrant ssh or ssh -p 2222 vagrant@localhost

• The default disk for the Vagrant VM is 10gb. If you need more disk space, modify the vagrant file and uncomment line 11 #config.disksize.size = "15GB" and set the preferred disk size. Then go back to step 3.

Testing the Newspaper_works Application

1. Ensure you're in the samvera-newspapers-vagrant directory

2. Shell into the vagrant box three times using vagrant ssh

3. Using the first shell start fcrepo_wrapper

   cd /home/vagrant/newspaper_works && fcrepo_wrapper --config config/fcrepo_wrapper_test.yml

4. Using the second shell start solr_wrapper

   cd /home/vagrant/newspaper_works && solr_wrapper --config config/solr_wrapper_test.yml

5. Use the third shell for testing and development

   • before running tests ensure the previous two tasks have completed and you see the following text in the shell windows
     • first shell http://127.0.0.1:8986/
     • second shell http://127.0.0.1:8985/solr/

6. Using the third shell you can run spec tests

   cd /home/vagrant/newspaper_works && rake spec

7. Using the third shell you can run rails console

   cd /home/vagrant/newspaper_works/ && rails c test

Evaluation Environment for Newspaper_works

1. Ensure you're in the samvera-newspapers-vagrant directory

2. Shell into vagrant box three times vagrant ssh

3. Using the first shell start fcrepo_wrapper

   cd /home/vagrant/newspaper_works/.internal_test_app && fcrepo_wrapper

4. Using the second shell start solr_wrapper

   cd /home/vagrant/newspaper_works/.internal_test_app && solr_wrapper

5. Using the third shell create the default admin set

   cd /home/vagrant/newspaper_works/.internal_test_app/ && bin/rails hyrax:default_admin_set:create

6. Using the third shell create workflows

   cd /home/vagrant/newspaper_works/.internal_test_app/ && bin/rails hyrax:workflow:load

7. Using the third shell run the rails web server

   cd /home/vagrant/newspaper_works/.internal_test_app && rails s -b 0.0.0.0

Optional

• Developers, before you bring up this box for the first time: consider whether you want to edit files from tools on your host machine. If so, opt-in to enable a synced folder in Vagrantfile by uncommenting the config.vm.synced_folder setting.

• Run rails console

  cd /home/vagrant/newspaper_works/.internal_test_app && rails c

Environment

• Ubuntu 18.04 LTS 64-bit
• Newspaper_works 1.0
• Hyrax 2.6.0 : http://localhost:3000
• Apache Solr 7.7.2 : http://localhost:8983/solr/
• Fedora Commons 4.7.3 : http://localhost:8984/
• Ruby 2.5.5
• Rails 5.1.7

Newspaper_works Dependencies

• FITS
• tesseract-ocr
• libreoffice
• ghostscript
• poppler-utils
• libcurl3
• libopenjp2-tools
• libgbm1
• Google Chrome (running tests)

Thanks

This VM is a modified version of the Fedora 4 Vagrant, with borrowings from the UCSD DAMS Vagrant.