2.2.1

This release includes improvements to the Bulkrax loader, a fix to the license field, and improved test setup.

Bulkrax

• Bulkrax upgraded from version 2.3 to 8.1, in order to leverage functionality for adding embargoed files.
• Rake task gwss:ingest_pq_etds added for converting Proquest ETD metadata and zipped files to the format required for a Bulkrax ingest.

License field

• Previously, the license field, although required, did not display in the UI when viewing works. This has been fixed.
• The URI previously used for the "All rights reserved" license has been deprecated. Accordingly, this authority has been replaced by the string All rights reserved.
• A rake task, gwss:replace_license_value, can be used to replace the deprecated value with the new value for those works bearing the "All rights reserved" license.

Improvements to test setup

• More comprehensive and consistent seeding of works has been added, leveraging the factories and fixtures from the Hyrax repository.

Other improvements

• The non-Ruby dependencies (ImageMagick, etc.) has been packaged as a separate Docker image, which reduces build time for changes to the application image.
• The H1 header font has been changed to reflect stakeholder input.
• The application footer has been updated for compliance with GW standards.

2.2.0

2.2.0

Version 2.2.0 includes new features requested by stakeholders, including an advanced search and the ability to limit results by a range of dates.

Filtering by date range (#474)

• Implements the blacklight_range_limit gem to provide a facet for restricting catalog search results to a range of dates.
• Creates an integer-valued index field from the date_created field by converting (where possible) a four-digit string value representative of a year.
• Where the date_created field contains something other than a four-digit value, a null value is used for the year indexer.
• Implements a slider facet in the UI, allowing the user to select works within a range of dates and/or to view works where the date created is Unknown (i.e., not a four-digit year).
• Patches a bug where the wrong Blacklight params were passed to the controller for the range limit search.
• Note that implementation of this feature requires a re-index of the repository.

Advanced search (#551)

• Implements the blacklight_advanced_search gem to provide the ability to search the repository by multiple fields.

Bug fixes

• Batch editing works from the dashboard no longer throws an error (#316).

UI changes

2.1.1

2.1.1 is a point release that fixes a bug in the meta tags that are required for indexing by Google Scholar.

Enhancements

• Fixes citation_publication_date and dc.issued to pull value from date_created (#440

2.1.0

Version 2.1.0 is a release that included a major front-end refactoring, SSO for GW users, continuous deployment/continuous integration to the test environment, Google Scholar compliance, and more.

Enhancements this release include:

Single Sign-On

• Integration with GW's identity provider (IdP) supports single signon for both staff and non-staff GW users (#488).
  • SAML metadata lookup occurs on the email address in the uid field of the User record; an initial data migration is necessary (see below under "User account updates").
  • Authenticated users with non-elevated access can view GW-only works but cannot access the ScholarSpace dashboard.

Google Scholar compliance

• Improved Google Scholar compliance which we hope will enable indexing by Google Scholar (#343)
  • Reassign ETD types from Thesis or Dissertation to Master's Thesis or Disseration by inferring from degree value (#542)
  • New Google Scholar-compliant sitemap (based on schoolie) (#343, #461)
  • Adds <meta> tags in landing page HTML for ETDs only
  • Replaces sitemap with new sitemap which includes entries for ETDs only, and uses timestamp for <lastmod> and PDF download link for <loc>

UI improvements

• Major refactoring of home, about, terms, search pages (#473, #475, #498, #503, #522, #525), adding:
  • completely new home page
  • orientation/welcome language
  • browse by category
  • browse everything button
  • browse all collections
  • new styling of spotlighted collections
  • new styling across all pages
  • navbar improvements
• Restructuring of About page (#522)
  • remove accordions from About page, except for Q&A
• Restructuring of Deposit page (#471, #478, #522)
  • content edits to Deposit page
  • use accordion-style Q&A

Bug fixes

• More reliable sitemap generation (#343)
• Passenger version pin in Dockerfile (#500)

Infrastructure and other technical improvements

• Continuous integration / Continuous deployment (#491, #521)
  • Pushing to master triggers rebuild and redeployment to https://test.scholarspace.library.gwu.edu
• Gem version upgrades (#505, #494)
• Remove browse_everything mount (#499)
• Put sidekiq behind user permissions (#483)

Upgrade Instructions

Database migrations

From the app container, run RAILS_ENV=production rails db:migrate.

SAML configuration

1. Generate the key and certificate:

   openssl genrsa -out gwss.pem 2048
   openssl req -new -key gwss.pem -out gwss.csr
   openssl x509 -req -days 365 -in gwss.csr -signkey gwss.pem -out gwss.crt
   

2. Move the key and certificate to the directories indicated by the NGINX_KEY_DIR and NGINX_CERT_DIR variables in the .env file.
3. Update the .env file:
   • Add the names of the .pem and .crt files created above under the SP_KEY and SP_CERT variables.
   • Provide a temporary file name in the .env file for the IDP_CERT_PEM variable. This file need not exist. (The app will create it if is missing.)
4. Launch the application.
5. Visit https://test.scholarspace.library.gwu.edu/users/auth/saml/metadata to obtain the XML metadata, which you will need to send to your IdP before proceeding with the SSO integration.
6. Upon receipt from the IdP of the metadata, extract the certificate value and store it in a file in the NGINX_CERT_DIR with the name used in the .env file.
7. Update the .env file with the URI's provided by the IdP for SSO and SLO.
8. If testing SSO with your GW email account, and if you are already a ScholarSpace user, it is recommended to run the Rake task for updating user accounts (see below) before logging in. Otherwise, your SSO login will create a new user, not connected to your previous user account.

ETD resource_type updates

1. Run the gwss:enumerate_degree_types rake task and, observing the output, confirm that each of the listed degree names is included in config/etd_degree_map.yml. If there are any that are not, we will need to add to config/etd_degree_map.yml. Note the number of ETDs with blank degree names.
2. Run the gwss:reassign_etd_resource_types rake task and, observing the output, note the IDs of any ETDs which were not able to be reassigned due to blank degree names.
3. Through the UI, manually update the degree values for the ETDs identified in the previous step; also make sure to update their resource_type values to Master's Thesis or Dissertation as appropriate.

User account updates

1. Run the gwss:update_users_sso Rake task (with RAILS_ENV=production) to migrate metadata for GW user accounts and delete other accounts with non-elevated access.

Code diff

2.0.1...2.1.0

2.0.1

A minor release with some UI fixes, added documentation, and configuration refinements.

• Improved readability on About, Help, and Terms pages (#419)
• Patched Blacklight bug that prevented sorting on Colllections pages (#411)
• Fixed bugs in Dashboard styling (#412, #417)
• Includes Rake task to fix keywords with empty strings (#416)
• Includes detailed instructions for non-Docker development mode (#342)
• Nginx configured t support Jekyll journal sites (#465)

Version 2.0.0

Version 2.0.0 is a major release that updates the deployment to a set of Docker containers, updates the Hyrax gem to 3.6.0 (from 2.9.5), and refreshes the user interface.

Issues addressed in this release include:

UI improvements:

• Overall UI refresh to align the GW ScholarSpace theme with other LAI web properties (#390)
• Hide the language selector (#395)
• Contact form default issue type now reads "Select Issue Type" (previously was blank) (#393)
• Improve 404 Error screen (#231)

Accessibility improvements

• Contact form Message field has been made non-resizable (#394)

Bug fixes

• Fixed issue where some PDF thumbnails were rendered in triplicate (#379)

Technical improvements

• Dockerize deployment (#99, #380, #378)
• Prune Tomcat and other files no longer needed in the code (#392)
• Upgrade hyrax gem to 3.6.0 (was 2.9.5) (#384, #313)
• Deploy repository server on Ubuntu 18 (was 16) (#269)

1.7.0...2.0.0

Version 1.7.0

Enhancements

• "Display in Browser" button added to file and work views to allow inline viewing.
• OAI/PMH endpoint for ETD works, using modified Dublin Core metadata.

Other

• Gemfile development and testing dependencies grouped for clarity.
• Documentation for deployment on Ubuntu 20.

1.6.4

• Adds reCAPTCHA version 3 (#360)
• updates loofah and rails-html-sanitizer

upgrade instructions

• bundle install
• Add reCAPTCHA v3 values to .env as per .env.example

1.6.3

• Adds mitigation for spam contact form submissions (#353)

Upgrade instructions

bundle install

1.6.2

In this release:

• Makes all fields except title no longer required for Journal Issue work type (#341)
• Security updates (#338)
• Hides download button on embargoed items (#335)
• Adds concern/file_sets/#{id} link for accessibility (#329)

Upgrade instructions
bundle install