Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 25 additions & 24 deletions doc/release-notes/6.2-release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -269,75 +269,76 @@ In the following commands we assume that Payara 6 is installed in `/usr/local/pa

(or `setenv PAYARA /usr/local/payara6` if you are using a `csh`-like shell)

1\. Undeploy the previous version.
1\. Usually, when a Solr schema update is released, we recommend deploying the new version of Dataverse, then updating the `schema.xml` on the solr side. With 6.2, we recommend to install the base schema first. Without it Dataverse 6.2 is not going to be able to show any results after the initial deployment. If your instance is using any custom metadata blocks, you will need to further modify the schema, see the laset step of this instruction (step 8).

- Stop Solr instance (usually `service solr stop`, depending on Solr installation/OS, see the [Installation Guide](https://guides.dataverse.org/en/5.14/installation/prerequisites.html#solr-init-script))

- Replace schema.xml

- `cd /usr/local/solr/solr-9.3.0/server/solr/collection1/conf`
- `wget https://raw.githubusercontent.com/IQSS/dataverse/master/conf/solr/9.3.0/schema.xml`

- Start Solr instance (usually `service solr start`, depending on Solr/OS)

2\. Undeploy the previous version.

- `$PAYARA/bin/asadmin undeploy dataverse-6.0`

2\. Stop Payara and remove the generated directory
3\. Stop Payara and remove the generated directory

- `service payara stop`
- `rm -rf $PAYARA/glassfish/domains/domain1/generated`

3\. Start Payara
4\. Start Payara

- `service payara start`

4\. Deploy this version.
5\. Deploy this version.

- `$PAYARA/bin/asadmin deploy dataverse-6.1.war`

As noted above, deployment of the war file might take several minutes due a database migration script required for the new storage quotas feature.

5\. Restart Payara
6\. Restart Payara

- `service payara stop`
- `service payara start`

6\. Update Geospatial Metadata Block.
7\. Update the standard Metadata Blocks:

7a\. Update Geospatial Metadata Block.

```
wget https://github.com/IQSS/dataverse/releases/download/v6.1/geospatial.tsv

curl http://localhost:8080/api/admin/datasetfield/load -H "Content-type: text/tab-separated-values" -X POST --upload-file @geospatial.tsv
```

6a\. Update Citation Metadata Block.
7b\. Update Citation Metadata Block.

```
wget https://github.com/IQSS/dataverse/releases/download/v6.2/citation.tsv

curl http://localhost:8080/api/admin/datasetfield/load -H "Content-type: text/tab-separated-values" -X POST --upload-file scripts/api/data/metadatablocks/citation.tsv
```

6b\. Update Astrophysics Metadata Block.
7c\. Update Astrophysics Metadata Block.

```
wget https://github.com/IQSS/dataverse/releases/download/v6.2/astrophysics.tsv

curl http://localhost:8080/api/admin/datasetfield/load -H "Content-type: text/tab-separated-values" -X POST --upload-file scripts/api/data/metadatablocks/astrophysics.tsv
```

6c\. Update Biomedical Metadata Block (to make Alternative Title repeatable)
7d\. Update Biomedical Metadata Block (to make Alternative Title repeatable)

```
wget https://github.com/IQSS/dataverse/releases/download/v6.2/biomedical.tsv

curl http://localhost:8080/api/admin/datasetfield/load -H "Content-type: text/tab-separated-values" -X POST --upload-file scripts/api/data/metadatablocks/biomedical.tsv
```

7\. Upate Solr schema.xml. See specific instructions below for those installations without custom metadata blocks (7a) and those with custom metadata blocks (7b).

7a\. For installations without custom or experimental metadata blocks:

- Stop Solr instance (usually `service solr stop`, depending on Solr installation/OS, see the [Installation Guide](https://guides.dataverse.org/en/6.2/installation/prerequisites.html#solr-init-script))

- Replace schema.xml

- `cp /tmp/dvinstall/schema.xml /usr/local/solr/solr-9.3.0/server/solr/collection1/conf`

- Start Solr instance (usually `service solr start`, depending on Solr/OS)

7b\. For installations with custom or experimental metadata blocks:
8\. For installations with custom or experimental metadata blocks:

- Stop Solr instance (usually `service solr stop`, depending on Solr installation/OS, see the [Installation Guide](https://guides.dataverse.org/en/6.2/installation/prerequisites.html#solr-init-script))

Expand All @@ -354,7 +355,7 @@ OR, alternatively, you can edit the following line in your schema.xml by hand as

- Restart Solr instance (usually `service solr restart` depending on solr/OS)

8\. Run ReExportAll to update dataset metadata exports. Follow the directions in the [Admin Guide](http://guides.dataverse.org/en/6.2/admin/metadataexport.html#batch-exports-through-the-api).
9\. Run ReExportAll to update dataset metadata exports. Follow the directions in the [Admin Guide](http://guides.dataverse.org/en/5.14/admin/metadataexport.html#batch-exports-through-the-api).

***

Expand Down Expand Up @@ -405,4 +406,4 @@ OR, alternatively, you can edit the following line in your schema.xml by hand as
> - dataverse.mail.mta.allow-utf8-addresses
> - Plus many more for advanced usage and special provider requirements. See [configuration guide for a full list](https://guides.dataverse.org/en/6.2/installation/config.html#dataverse-mail-mta).

[⬅️ Go back](#simplified-smtp-configuration)
[⬅️ Go back](#simplified-smtp-configuration)