|
| 1 | +# Dataverse Software 5.11.1 |
| 2 | + |
| 3 | +This is a bug fix release of the Dataverse Software. The .war file for v5.11 will no longer be made available and installations should upgrade directly from v5.10.1 to v5.11.1. To do so you will need **to follow the instructions for installing release 5.11 using the v5.11.1 war file**. (Note specifically the upgrade steps 6-9 from the 5.11 release note; most importantly, the ones related to the citation block and the Solr schema). **If you had previously installed v5.11** (no longer available), follow the simplified instructions below. |
| 4 | + |
| 5 | +## Release Highlights |
| 6 | + |
| 7 | +Dataverse Software 5.11 contains two critical issues that are fixed in this release. |
| 8 | + |
| 9 | +First, if you delete a file from a published version of a dataset that has restricted files, the file will be deleted from the file system (or S3) and lose its "owner id" in the database. For details, see Issue #8867. |
| 10 | + |
| 11 | +Second, if you are a superuser, it's possible to click "Delete Draft" and delete a published dataset if it has restricted files. For details, see #8845 and #8742. |
| 12 | + |
| 13 | +## Notes for Dataverse Installation Administrators |
| 14 | + |
| 15 | +### Identifying Datasets with Deleted Files |
| 16 | + |
| 17 | +If you have been running 5.11, check if any files show "null" for the owner id. The "owner" of a file is the parent dataset: |
| 18 | + |
| 19 | +``` |
| 20 | +select * from dvobject where dtype = 'DataFile' and owner_id is null; |
| 21 | +``` |
| 22 | + |
| 23 | +For any of these files, change the owner id to the database id of the parent dataset. In addition, the file on disk (or in S3) is likely gone. Look at the "storageidentifier" field from the query above to determine the location of the file then restore the file from backup. |
| 24 | + |
| 25 | +### Identifying Datasets Superusers May Have Accidentally Destroyed |
| 26 | + |
| 27 | +Check the "actionlogrecord" table for DestroyDatasetCommand. While these "destroy" entries are normal when a superuser uses the API to destroy datasets, an entry is also created if a superuser has accidentally deleted a published dataset in the web interface with the "Delete Draft" button. |
| 28 | + |
| 29 | +## Complete List of Changes |
| 30 | + |
| 31 | +For the complete list of code changes in this release, see the [5.11.1 Milestone](https://github.com/IQSS/dataverse/milestone/105?closed=1) in GitHub. |
| 32 | + |
| 33 | +For help with upgrading, installing, or general questions please post to the [Dataverse Community Google Group ](https://groups.google.com/forum/#!forum/dataverse-community) or email [email protected]. |
| 34 | + |
| 35 | +## Installation |
| 36 | + |
| 37 | +If this is a new installation, please see our [Installation Guide](https://guides.dataverse.org/en/5.11.1/installation/). Please also contact us to get added to the [Dataverse Project Map](https://guides.dataverse.org/en/5.11.1/installation/config.html#putting-your-dataverse-installation-on-the-map-at-dataverse-org) if you have not done so already. |
| 38 | + |
| 39 | +## Upgrade Instructions |
| 40 | + |
| 41 | +0\. These instructions assume that you've already successfully upgraded from Dataverse Software 4.x to Dataverse Software 5 following the instructions in the [Dataverse Software 5 Release Notes](https://github.com/IQSS/dataverse/releases/tag/v5.0). After upgrading from the 4.x series to 5.0, you should progress through the other 5.x releases before attempting the upgrade to 5.11.1. **To upgrade from 5.10.1, follow the instructions for installing release 5.11 using the v5.11.1 war file**. If you had previously installed v5.11 (no longer available), follow the simplified instructions below. |
| 42 | + |
| 43 | +If you are running Payara as a non-root user (and you should be!), **remember not to execute the commands below as root**. Use `sudo` to change to that user first. For example, `sudo -i -u dataverse` if `dataverse` is your dedicated application user. |
| 44 | + |
| 45 | +In the following commands we assume that Payara 5 is installed in `/usr/local/payara5`. If not, adjust as needed. |
| 46 | + |
| 47 | +`export PAYARA=/usr/local/payara5` |
| 48 | + |
| 49 | +(or `setenv PAYARA /usr/local/payara5` if you are using a `csh`-like shell) |
| 50 | + |
| 51 | +1\. Undeploy the previous version. |
| 52 | + |
| 53 | +- `$PAYARA/bin/asadmin list-applications` |
| 54 | +- `$PAYARA/bin/asadmin undeploy dataverse<-version>` |
| 55 | + |
| 56 | +2\. Stop Payara and remove the generated directory |
| 57 | + |
| 58 | +- `service payara stop` |
| 59 | +- `rm -rf $PAYARA/glassfish/domains/domain1/generated` |
| 60 | + |
| 61 | +3\. Start Payara |
| 62 | + |
| 63 | +- `service payara start` |
| 64 | + |
| 65 | +4\. Deploy this version. |
| 66 | + |
| 67 | +- `$PAYARA/bin/asadmin deploy dataverse-5.11.1.war` |
| 68 | + |
| 69 | +5\. Restart Payara |
| 70 | + |
| 71 | +- `service payara stop` |
| 72 | +- `service payara start` |
0 commit comments