|
| 1 | +# Dataverse 6.10.1 |
| 2 | + |
| 3 | +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). |
| 4 | + |
| 5 | +## Complete List of Changes |
| 6 | + |
| 7 | +For the complete list of code changes in this release, see the [6.10.1 milestone](https://github.com/IQSS/dataverse/issues?q=milestone%3A6.10.1+is%3Aclosed) in GitHub. |
| 8 | + |
| 9 | +## Getting Help |
| 10 | + |
| 11 | +For help with upgrading, installing, or general questions please see [getting help](https://guides.dataverse.org/en/latest/installation/intro.html#getting-help) in the Installation Guide. |
| 12 | + |
| 13 | +## Installation |
| 14 | + |
| 15 | +If this is a new installation, please follow our [Installation Guide](https://guides.dataverse.org/en/latest/installation/). Please don't be shy about [asking for help](https://guides.dataverse.org/en/latest/installation/intro.html#getting-help) if you need it! |
| 16 | + |
| 17 | +Once you are in production, we would be delighted to update our [map of Dataverse installations around the world](https://dataverse.org/installations) to include yours! Please [create an issue](https://github.com/IQSS/dataverse-installations/issues) or email us at support@dataverse.org to join the club! |
| 18 | + |
| 19 | +You are also very welcome to join the [Global Dataverse Community Consortium](https://www.gdcc.io/) (GDCC). |
| 20 | + |
| 21 | +## Upgrade Instructions |
| 22 | + |
| 23 | +Upgrading requires a maintenance window and downtime. Please plan accordingly, create backups of your database, etc. |
| 24 | + |
| 25 | +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](https://github.com/IQSS/dataverse/tags) 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. |
| 26 | + |
| 27 | +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. |
| 28 | + |
| 29 | +Also, we assume that Payara is installed in `/usr/local/payara7`. If not, adjust as needed. |
| 30 | + |
| 31 | +1. Undeploy Dataverse, if deployed, using the unprivileged service account ("dataverse", by default). |
| 32 | + |
| 33 | + `sudo -u dataverse /usr/local/payara7/bin/asadmin list-applications` |
| 34 | + |
| 35 | + `sudo -u dataverse /usr/local/payara7/bin/asadmin undeploy dataverse-6.10` |
| 36 | + |
| 37 | +1. Deploy the Dataverse 6.10.1 war file. |
| 38 | + |
| 39 | + `wget https://github.com/IQSS/dataverse/releases/download/v6.10.1/dataverse-6.10.1.war` |
| 40 | + |
| 41 | + `sudo -u dataverse /usr/local/payara7/bin/asadmin deploy dataverse-6.10.1.war` |
| 42 | + |
| 43 | +1. Check that you get a version number from Dataverse. |
| 44 | + |
| 45 | + This is just a sanity check that Dataverse has been deployed properly. |
| 46 | + |
| 47 | + `curl http://localhost:8080/api/info/version` |
| 48 | + |
| 49 | +1. For installations with internationalization or text customizations: |
| 50 | + |
| 51 | + Please remember to update translations via [Dataverse language packs](https://github.com/GlobalDataverseCommunityConsortium/dataverse-language-packs). |
| 52 | + |
| 53 | + If you have text customizations you can get the latest English files from <https://github.com/IQSS/dataverse/tree/v6.10/src/main/java/propertyFiles>. |
0 commit comments