Hyku with HyBridge Vagrant Box

Hyku using the HyBridge tool.

Requirements

• Vagrant 2.1.x
• VirtualBox 5.2.x
• Chrome
• CPU: Core i5/Ryzen 5 or higher
• RAM: 8GB or higher

Windows users will need Powershell version 3 or higher

The Chrome browser is required because of its support for subdomains on localhost *.localhost which Hyku Vagrant uses for repositories. Alternatively you can edit your hosts file and add 127.0.0.1 to any *.localhost domain.

Please note that the Hyrax stack can be resource-intensive and is not recommended for underpowered computers or on machines you intend to multi-task heavily with during your hyku testing.

Install

1. git clone https://github.com/Bridge2Hyku/hyku-hybridge-vagrant.git
2. cd hyku-hybridge-vagrant
3. vagrant up
4. Visit http://localhost:8080

Create super admin user

1. Visit http://localhost:8080/users/sign_up in your browser
2. Create a new account
3. Open a new terminal
4. cd hyku-hybridge-vagrant, or wherever you cloned hyku-hybridge-vagrant
5. vagrant ssh
6. cd /var/www/hyku
7. bundle exec rake hyku:superadmin:grant[user@email.org] where user@email.org is the email you registered
8. exit

Create a repository

1. Visit http://localhost:8080 and log in as super admin
2. Click "Get Started"
3. Enter example for the "Short name"
4. Register for the new repository admin account
5. Create a folder example.localhost in hyku-hybridge-vagrant/data_store
6. Your new repository will be at http://example.localhost:8080

Stopping vagrant

To stop vagrant run vagrant halt. To remove hyku vagrant and the virtual machine run vagrant destroy.

Environment

• Ubuntu 16.04 64-bit machine with:
  • Apache
  • HyBridge
  • Fedora 4.x at http://localhost:8984/fedora4/rest
  • Hyku at http://localhost:8080
  • ImageMagick
  • Passenger 5.1.4
  • Ruby 2.4.4
  • Solr 6.4.2 at http://localhost:8983/solr/
  • Tomcat 7
  • Zookeeper

Enable Sidekiq

If you need to view the status of jobs follow these steps to enable the Sidekiq interface:

1. cd hyku-hybridge-vagrant, or wherever your hyku-vagrant is
2. vagrant ssh
3. nano /var/www/hyku/config/routes.rb
4. Add the following lines to Line #2

require 'sidekiq/web'
mount Sidekiq::Web => '/sidekiq'

It should look something like this:

Rails.application.routes.draw do
  require 'sidekiq/web'
  mount Sidekiq::Web => '/sidekiq'
 
  if Settings.multitenancy.enabled

5. Hit Ctrl-X and then y to save changes and exit
6. sudo service apache2 restart
7. Visit http://example.localhost:8080/sidekiq

Maintainers

Current maintainers:

• Sean Watkins