IQSS/dataverse v4.4

on GitHub

Overview:

This release contains feature enhancements for embedding content using widgets, downloading guestbook data for a dataverse in a consolidated fashion, and introduces a new feature, support for remote authentication using Shibboleth.

• Two new widgets: dataset and citation in addition to the existing widgets, dataverse listing and search box.
• Improved widget navigation: child objects open within widgets rather than redirecting to Dataverse.
• A new dataset metadata field, alternativeURL, can be used to link a dataset to an author's website.
• Shibboleth for remote authentication is now officially supported.
• Downloading guestbook data is now easier: all guestbook data for all datasets within a dataverse can be downloaded by one click.

Please see the <a href=https://github.com/IQSS/dataverse/issues?q=is%3Aissue+milestone%3A4.4+is%3Aclosed>4.4 milestone issues list for more information.

Installation:

If this is a new installation, please see our Installation Guide.

Upgrade:

If you are upgrading from v4.x, you must upgrade to each intermediate version before installing this version. When upgrading from the previous version, you will need to do the following:

1. Undeploy the previous version.
   • /glassfish4/bin/asadmin list-applications
   • /glassfish4/bin/asadmin undeploy dataverse
2. Deploy this version.
   • /glassfish4/bin/asadmin deploy dataverse-4.4.war
3. Restart glassfish.
   • service glassfish stop
   • service glassfish start
4. Update the citation.tsv file
   • place the tsv file on the web server.
   • run the api command to update the citation metadata block:
     curl http://localhost:8080/api/admin/datasetfield/load -X POST --data-binary @citation.tsv -H "Content-type: text/tab-separated-values"
5. Replace the Solr schema.xml file
   • stop solr
   • replace schema.xml
   • start solr
6. Run the incremental index to correct the targeting for citation links.
   • Remove last index times from the database:
     update dvobject set indextime=null;
     update dvobject set permissionindextime=null;
   • From the glassfish console, run the incremental index:
     curl -X GET "http://localhost:8080/api/admin/index/continue?numPartitions=1&partitionIdToProcess=0"

If you are upgrading from v3.x, you will need to perform a migration to v4.x since our application was redesigned and the database schema are completely different. This is a significant undertaking. Please contact us (support at dataverse.org) before beginning. Also refer to our migration google group for additional support and information: https://groups.google.com/d/msgid/dataverse-migration-wg

Please note: v4.x does not currently support creating new handles though it will support existing ones. We intend to add this feature but have not yet scheduled this work.

If you install Two Ravens or have an older version of Two Ravens configured and upgrade Two Ravens and Dataverse, you will need to update the preprocess.R file from the Two Ravens project:

1. Update preprocess.R
   replace the current preprocess.R file in:
   /usr/local/glassfish4/glassfish/domains/domain1/applications/dataverse-4.4/WEB-INF/classes/edu/harvard/iq/dataverse/rserve/scripts/preprocess.R

with the one from:

https://raw.githubusercontent.com/IQSS/TwoRavens/master/rook/preprocess/preprocess.R

1. Remove any existing preprocess files

cd /usr/local/glassfish4/glassfish/domains/domain1/files
rm -f find . -name '*.prep'

Note the special apostrophe in the rm statement, it is not a single quote. Copy and pasting is the easiest way.

1. Restart glassfish