Dataverse 6.10.1

This is a bug fix release for Dataverse 6.10 that fixes download bug #12251 that was fixed in pull request #12252. The bug caused single-file downloads (as opposed to multi-file zip download) to silently fail from the web interface (the API was unaffected).

Complete List of Changes

For the complete list of code changes in this release, see the 6.10.1 milestone in GitHub.

Getting Help

For help with upgrading, installing, or general questions please see getting help in the Installation Guide.

Installation

If this is a new installation, please follow our Installation Guide. Please don't be shy about asking for help if you need it!

Once you are in production, we would be delighted to update our map of Dataverse installations around the world to include yours! Please create an issue or email us at support@dataverse.org to join the club!

You are also very welcome to join the Global Dataverse Community Consortium (GDCC).

Upgrade Instructions

You only need to follow the redeployment instructions below if you had deployed the originally released dataverse-6.10.war in the few days before it was removed from the release page. If you followed the 6.10 instructions in their current form, you should already be running dataverse-6.10.1 below and do not need to do anything else.

Upgrading requires a maintenance window and downtime. Please plan accordingly, create backups of your database, etc.

Note: These instructions assume that you are upgrading from the immediate previous version. That is to say, you've already upgraded through all the 6.x releases and are now running Dataverse 6.10. See tags on GitHub for a list of versions. If you are running an earlier version, the only supported way to upgrade is to progress through the upgrades to all the releases in between before attempting the upgrade to this version.

If you are running Payara as a non-root user (and you should be!), remember not to execute the commands below as root. By default, Payara runs as the dataverse user. In the commands below, we use sudo to run the commands as a non-root user.

Also, we assume that Payara is installed in /usr/local/payara7. If not, adjust as needed.

1. Undeploy Dataverse, if deployed, using the unprivileged service account ("dataverse", by default).

   sudo -u dataverse /usr/local/payara7/bin/asadmin list-applications

   sudo -u dataverse /usr/local/payara7/bin/asadmin undeploy dataverse-6.10

2. Deploy the Dataverse 6.10.1 war file.

   wget https://github.com/IQSS/dataverse/releases/download/v6.10.1/dataverse-6.10.1.war

   sudo -u dataverse /usr/local/payara7/bin/asadmin deploy dataverse-6.10.1.war

3. Check that you get a version number from Dataverse.

   This is just a sanity check that Dataverse has been deployed properly.

   curl http://localhost:8080/api/info/version

4. For installations with internationalization or text customizations:

   Please remember to update translations via Dataverse language packs.

   If you have text customizations you can get the latest English files from https://github.com/IQSS/dataverse/tree/v6.10.1/src/main/java/propertyFiles.