Hyku Test Environment Hints

SSH to server

All staff members should have SSH access (via your personal SSH key).

ssh [email protected]

Start / Stop Hyku

NOTE: Fedora, Solr, and Postgres all start/stop automatically (on server boot). However, Hyku is currently a manual start/stop process.

Just use the provided start/stop script to start/stop Hyku:

# Start Hyku (on port 3000)
~/start-hyku

# Stop Hyku
~/stop-hyku

Afterwards, Hyku should be visible at: http://ec2-34-230-187-85.compute-1.amazonaws.com:3000/

Creating the default Admin Set (in Fedora)

1. SSH into the server
2. cd ~/hyku/
3. Run this command:

SOLR_URL="http://127.0.0.1:8983/solr/hyku-development" FEDORA_URL="https://627cys77vl.execute-api.us-east-1.amazonaws.com/dev/" bundle exec rake hyrax:default_admin_set:create

Pointing Hyku at a different Fedora

The Fedora being used by Hyku is configured in Hyku's /config/fedora.yml

• If you simply need to change the location of the Fedora, that can be achieved by updating the FEDORA_URL environment variable in our ~/start-hyku script. Simply edit that script, and change the value of FEDORA_URL.
• If the Fedora requires authentication, the username/password can be found in the /config/fedora.yml configuration file.

Hyku, Fedora and Solr

Hyku:

• URL: http://[email protected]:3000/
• Installation Directory: /home/ubuntu/hyku/
• Admin User: [email protected] (For password, see our Slack channel)

Fedora:

• URL: http://[email protected]:8080/fcrepo-webapp-4.7.4/rest/
• Data directory: /var/lib/tomcat8/fcrepo4-data/
• Webapp: /var/lib/tomcat8/webapps/fcrepo-webapp-4.7.4/
• Start/Stop via Tomcat: sudo service tomcat8 [start|stop|restart]

Solr:

• URL: http://[email protected]:8983/solr/
• Installation directory: /opt/solr/
• Data directory: /var/solr/data/
• Start/Stop: sudo service solr [start|stop|restart]

Debugging Tips

Clearing out data

Clearing the Solr index

SSH into the server (or run remotely by replacing localhost with the server name) and run:

curl http://localhost:8983/solr/hyku-development/update?commit=true -H "Content-Type: text/xml" --data-binary '<delete><query>*:*</query></delete>'

Clearing the Postgres database

1. SSH into the server
2. ~/stop-hyku
3. cd ~/hyku
4. bundle exec rake db:drop db:create db:migrate
5. ~/start-hyku
6. You will need to recreate the default Admin user, by simply registering a new account in the Hyku UI (the first registered account is given admin privileges).

Clearing out DynamoDB

Simply visit the DynamoDB UI, select all items and select "Delete" from the Actions.