Releases: gwu-libraries/scholarspace-hyrax
Version 1.0
Version 1.0 is the release of GW ScholarSpace which incorporates an upgraded Hyrax gem (v2.0.1) and is ready for adaptation as a repository for both ETD and Non-ETD content (although this will require some configuration and cosmetic updates, to come in Version 1.1).
Notable improvements include (but are not limited to):
- A working embargo management page, at /embargoes ( /leases is also available if useful in the future)
- Permissions on GWSS items are now managed via administrative sets.
- All of the bugs fixed as part of Hyrax 2.0.0 and Hyrax 2.0.1
Upgrade instructions
- Update application code:
As scholarspace
user:
git fetch
git pull origin master
git checkout 1.0
- Update gems:
bundle install
- Database migrations:
RAILS_ENV=production rails hyrax:install:migrations
RAILS_ENV=production rails db:migrate
-
Configure
config/initializers/hyrax.rb
-
Create default admin set:
RAILS_ENV=production rake hyrax:default_admin_set:create
- Rebuild assets:
RAILS_ENV=production rails assets:clean
RAILS_ENV=production rails assets:precompile
- Assign "In Copyright" as Rights Statement value for all ETDs.
At the [production] rails console (RAILS_ENV=production rails c
):
gwetds = GwEtd.all
gwetds.each do |e|
e.rights_statement = ["http://rightsstatements.org/vocab/InC/1.0/"]
e.save
end
-
Start up Apache, log in as administrator
-
Add
content-admin
group as a Manager of each Administrative Set. (If we were to add individuals instead, then they would only have rights to items added after the individuals were given Manager roles on the admin set.) -
May need to run the script to create default collection types - see Hyrax release notes
-
Reindex content:
RAILS_ENV=production rake gwss:reindex_everything
Code changes from v0.1 to v1.0
Version 0.1
This is the initial "soft rollout" version of GW ScholarSpace ETDs, built on Hyrax 1.0.5. It provides:
- Two item types,
GwWork
andGwEtd
. Initially we will be populating with onlyGwETD
items. - Multi-file works
- A rake task to ingest ETDs given paths to: a metadata json file, a primary file attachment (typically PDF), and supplementary files. The task can also update an existing ETD, which acts as an overwrite but retains the id of the item (but files do not retain their ids)
- Admin role and content-admin role for users. Content-admins can edit or delete all items ingested via ingest task (and can view these items' embargoed files). Admins can also access the administrative configuration page and can edit content blocks.
- Embargoes; the ingest task implements embargoes where ETD metadata is open-access, but associated files are embargoed.
- "Clean" alternate routes to items, as
/etd/{id}
or/etds/{id}
. Intended for citation URLs.
Known issues include:
- Embargoes do not automatically release (Hyrax behavior) (#78)
- Embargo management page link is broken (samvera/hyrax#1419)
- Certain ETDs fail ingest. Roughly 1% of GW's ETDs retrieved from ProQuest. Metadata issues cause this in some ETDs; in a greater proportion, failure occurs during file processing (for example, during full-text indexing of PDFs)
- TinyMCE controls for admin-editable content blocks (About, Help, etc.) do not render (#86)