CORRECTION: Previewer Update Announcement: ACTION REQUIRED for Dataverse instances using previewers hosted at github.io

[James Myers]

All,

Apologies for the errors. As Don points out, we already had versioning started in the old repo (up to v1.1.1) and the earlier email had typos. I’ve updated the gdcc repository and instructions to now use v1.2 as the latest release. I’m repeating the original email, with corrections in place below. Also – to answer the question Don raised: if you are running the previewers locally, the new v1.2 does has changes not in the v1.1.1 released in Dec 2020 so you should update if you want them.

 

-- Jim

 

Corrected email:

All,

As mentioned in recent community meetings (and farther back), there have been several updates to the Dataverse Previewers over the last year or so (contributors are acknowledged in the repository readme file). These have been available in source form from github but we have not made them available to those using the previewers hosted at the https://globaldataversecommunityconsoritum.github.io site.

With this email, I'm announcing that the updates are now available at a new hosted site. Details of how to use them are your installation are given below.

Also: our intent is to eventually (as early as the end of the year) shut down the existing site, so, even if you do not want to upgrade to the latest version of the previewers, you should follow the instructions below to change your configuration to get the current versions from the new site.

Thanks – if you have any questions, just let me know.

-- Jim

What's New:

- Improved instructions - customized to pre-v5.2 and v5.2+ Dataverse installations

- Improved internationalization

- Improved formatting and accessibility

- New location with shorter URLs ('globaldataversecommunityconsortium' -> 'gdcc')

- Reorganization to avoid everyone having to upgrade at the same time going forward

 Options for upgrading:

 Using the Dataverse API: Uninstall/Reinstall the Previewers as External Tools

 Use the Dataverse admin api to list and then delete all previewers registered with your instance:

curl http://localhost:8080/api/admin/externalTools

and, for each tool registered, delete them by id number:

curl -X DELETE http://localhost:8080/api/admin/externalTools/<id>

Then go to https://gdcc.github.io/dataverse-previewers. At the bottom of the page select the appropriate link for <= v5.1 or v5.2+ instructions. Cut/paste any/all of the example curl commands to register the new versions of the tools served from the gdcc.github.io site.

 Updating the Dataverse Database directly:

 The only change required to update currently registered previewers is to update the tool URLs to point to the new location and the new version. The following SQL command will do that:

update externaltool set toolurl=REPLACE(toolurl, 'globaldataversecommunityconsortium.github.io/dataverse-previewers/previewers', 'gdcc.github.io/dataverse-previewers/previewers/v1.2');

Options for Using the new gdcc.github.io site without updating to the new previewer versions:

The existing previewers are now also hosted in the /previewers/v1.0 directory of the repository. To change to use the new site without updating, you can use a modified form of either of the options above. Using the API, you'll need to modify the curl commands shown in the instructions to use "v1.1.1" instead of "v1.2" in the toolurl values. To use the sql update, change the last string to end in "v1.1.1" instead of "v1.2".

 Trouble?

If for some reason you have trouble registering the new previewer versions, feel free to reach out on the email list. You should also be able to temporarily restore using the previewers from the old repository, i.e. by deleting the new external tool entries and using the curl commands at the old site to re-register the original previewers.