Install Voyager, the Smithsonian 3D Viewer on demo.dataverse.org for user testing

[cmbz]

Overview

• @qqmyers Performed work to implement the Smithsonian 3D previewer called Voyager as a Dataverse previewer
• This is a beta test of Voyager as a Dataverse previewer.
• Related issues below have been merged, including support for required 3D MIME type
• Next steps:
  • Install the previewer on demo.dataverse.org
  • Make available for testing by users with 3D data, including @sbarbosadataverse and @Cook4986

Sample Datasets

• Cluny Capital
• Medical Training Head
• DeelFontein Meteorite
• Camera Obscura

Installation Instructions

Installing the previewer follows the standard pattern:

• Run the curl command at https://github.com/gdcc/dataverse-previewers/blob/develop/6.1curlcommands.md#smithsonian-voyager-3d-model-previewer-beta

To enable Dataverse to recognize the MIME type for *.glb files, you can either:

• Cherry pick all of #10760
• Edit the local MimeType* files (in the exploded war's WEB-INF/classes/propertyFiles dir to add the same 3 lines as in #10760 and restart the server

Note #10760 has been merged, so it should be on the beta server. The Dataverse update step wouldn't be needed there.

Related

• https://github.com/gdcc/dataverse-previewers/issues/57
• https://github.com/Smithsonian/dpo-voyager/issues/297 (please note fixes made by Smithsonian team)
• https://github.com/IQSS/dataverse/pull/10760
• https://github.com/gdcc/dataverse-previewers/pull/77

[stevenwinship]

Voyager viewer is now available on beta.dataverse.org and demo.dataverse.org

The Open in New Window is failing:

[qqmyers]

Good catch! The example curl command at https://github.com/gdcc/dataverse-previewers/blob/develop/6.1curlcommands.md#smithsonian-voyager-3d-model-previewer-beta was incorrect - fixed now. You'll need to delete the external tool you added via that command and rerun the curl command to fix things. (Or could edit the db). Should be able to GET http://localhost:8080/api/admin/externalTools to see the installed tools and get the ID of the existing voyager entry and then DELETE http://localhost:8080/api/admin/externalTools/{id} . (From memory - if there are problems those calls should be in the giude.)

[stevenwinship]

I updated both beta and demo databases with the new external tool config. They both work now when clicking on "Open in New Window"

[cmbz]

2024/08/14

• Closing now, testing will continue and we'll open new issues if needed.