Release Notes This page documents the manual steps required to upgrade an existing eMuseum installation.
Previous Version Changes
Before applying changes specific to eMuseum 6. found in the sections below, all changes required to upgrade earlier versions of 6.0, 6.1, 6.2, 6.3 and 6.5 must be applied. Those changes can be found in the corresponding release notes.
6.5
System Requirements
eMuseum 6.5 does not support Java 11. When upgrading to v6.5, you must update to Java 17 or 21.
In addition to Java 17, Java 21 is now supported
Solr Changes
If the data folder within the eMuseum home directory is used (<EMUSEUM_HOME>/solr/), adjust the Solr configuration to point to <EMUSEUM_HOME>/solr/solr8 for Solr 8 or to <EMUSEUM_HOME>/solr/solr9 for Solr 9.
If a separate Solr data folder is used (instead of <EMUSEUM_HOME>/solr/), copy over the files from <EMUSEUM_HOME>/solr/solr8 for Solr8 or from <EMUSEUM_HOME>/solr/solr9 for Solr 9.
Template Changes
Template updates are only required for custom skins.
For each custom skin (sub-folders in the <EMUSEUM_HOME>/skins/ folder), apply the following changes. Please note that custom skins only contain files for custom changes. If a mentioned file does not exist in the custom skin’s folder, no changes need to be done.
Merge changes on the following template files (if present):
com/gallerysystems/emuseum/core/base/components/AbstractViewFieldConfig.tml
com/gallerysystems/emuseum/core/base/pages/AbstractDetailsPage.tml
com/gallerysystems/emuseum/core/base/view/page/AbstractViewPage.tml
com/gallerysystems/emuseum/core/components/CollectionLink.tml
com/gallerysystems/emuseum/core/components/DetailActions.tml
com/gallerysystems/emuseum/core/components/DetailsBlock.tml
com/gallerysystems/emuseum/core/components/ExportButton.tml
com/gallerysystems/emuseum/core/components/FieldLabel.tml
com/gallerysystems/emuseum/core/components/GroupChooser.tml
com/gallerysystems/emuseum/core/components/GroupMediaChooser.tml
com/gallerysystems/emuseum/core/components/IIIFLink.tml
com/gallerysystems/emuseum/core/components/Layout.tml
com/gallerysystems/emuseum/core/components/Logo.tml
com/gallerysystems/emuseum/core/components/PersonName.tml
com/gallerysystems/emuseum/core/components/RelatedField.tml
com/gallerysystems/emuseum/core/components/favorites/FavoritesBar.tml
com/gallerysystems/emuseum/core/components/media/MediaDownload.tml
com/gallerysystems/emuseum/core/components/media/MediaInfo.tml
com/gallerysystems/emuseum/core/components/media/viewers/AudioViewer.tml
com/gallerysystems/emuseum/core/components/media/viewers/DocumentViewer.tml
com/gallerysystems/emuseum/core/components/media/viewers/ImageViewer.tml
com/gallerysystems/emuseum/core/components/media/viewers/VideoViewer.tml
com/gallerysystems/emuseum/core/components/pageviews/PageView.tml
com/gallerysystems/emuseum/core/components/pageviews/bibliography/Detail.tml
com/gallerysystems/emuseum/core/components/pageviews/bibliography/Images.tml
com/gallerysystems/emuseum/core/components/pageviews/bibliography/List.tml
com/gallerysystems/emuseum/core/components/pageviews/bibliography/Table.tml
com/gallerysystems/emuseum/core/components/pageviews/events/Detail.tml
com/gallerysystems/emuseum/core/components/pageviews/events/Images.tml
com/gallerysystems/emuseum/core/components/pageviews/events/List.tml
com/gallerysystems/emuseum/core/components/pageviews/events/Table.tml
com/gallerysystems/emuseum/core/components/pageviews/exhibitions/Detail.tml
com/gallerysystems/emuseum/core/components/pageviews/exhibitions/Images.tml
com/gallerysystems/emuseum/core/components/pageviews/exhibitions/List.tml
com/gallerysystems/emuseum/core/components/pageviews/exhibitions/Table.tml
com/gallerysystems/emuseum/core/components/pageviews/loans/Detail.tml
com/gallerysystems/emuseum/core/components/pageviews/loans/Images.tml
com/gallerysystems/emuseum/core/components/pageviews/loans/List.tml
com/gallerysystems/emuseum/core/components/pageviews/loans/Table.tml
com/gallerysystems/emuseum/core/components/pageviews/media/Detail.tml
com/gallerysystems/emuseum/core/components/pageviews/media/Images.tml
com/gallerysystems/emuseum/core/components/pageviews/media/List.tml
com/gallerysystems/emuseum/core/components/pageviews/media/Table.tml
com/gallerysystems/emuseum/core/components/pageviews/objects/Detail.tml
com/gallerysystems/emuseum/core/components/pageviews/objects/Images.tml
com/gallerysystems/emuseum/core/components/pageviews/objects/List.tml
com/gallerysystems/emuseum/core/components/pageviews/objects/Table.tml
com/gallerysystems/emuseum/core/components/pageviews/people/Detail.tml
com/gallerysystems/emuseum/core/components/pageviews/people/Images.tml
com/gallerysystems/emuseum/core/components/pageviews/people/List.tml
com/gallerysystems/emuseum/core/components/pageviews/people/Table.tml
com/gallerysystems/emuseum/core/components/pageviews/sites/Detail.tml
com/gallerysystems/emuseum/core/components/pageviews/sites/Images.tml
com/gallerysystems/emuseum/core/components/pageviews/sites/List.tml
com/gallerysystems/emuseum/core/components/pageviews/sites/Table.tml
com/gallerysystems/emuseum/core/components/profile/AddCustomFieldConfigModal.tml
com/gallerysystems/emuseum/core/components/profile/CustomFields.tml
com/gallerysystems/emuseum/core/components/profile/DefaultFields.tml
com/gallerysystems/emuseum/core/components/profile/FieldConfigModulePicker.tml
com/gallerysystems/emuseum/core/components/profile/QuickSearchFieldConfig.tml
com/gallerysystems/emuseum/core/components/profile/SimilarFieldConfig.tml
com/gallerysystems/emuseum/core/components/profile/ViewConfigFieldConfig.tml
com/gallerysystems/emuseum/core/components/rdf/RDFBibliographyViewRecord.tml
com/gallerysystems/emuseum/core/components/rdf/RDFEventViewRecord.tml
com/gallerysystems/emuseum/core/components/rdf/RDFExhibitionViewRecord.tml
com/gallerysystems/emuseum/core/components/rdf/RDFLoanViewRecord.tml
com/gallerysystems/emuseum/core/components/rdf/RDFMediaViewRecord.tml
com/gallerysystems/emuseum/core/components/rdf/RDFObjectViewRecord.tml
com/gallerysystems/emuseum/core/components/rdf/RDFPersonViewRecord.tml
com/gallerysystems/emuseum/core/components/rdf/RDFSiteViewRecord.tml
com/gallerysystems/emuseum/core/components/related/RecordPeople.tml
com/gallerysystems/emuseum/core/components/search/FilterPanel.tml
com/gallerysystems/emuseum/core/components/xml/XMLDetailsRecord.tml
com/gallerysystems/emuseum/core/components/xml/XMLViewRecord.tml
com/gallerysystems/emuseum/core/pages/About.tml
com/gallerysystems/emuseum/core/pages/advancedsearch/AdvancedsearchResults.tml
com/gallerysystems/emuseum/core/pages/collections/CollectionsDetails.tml
com/gallerysystems/emuseum/core/pages/collections/CollectionsIndex.tml
com/gallerysystems/emuseum/core/pages/favorites/FavoritesDetails.tml
com/gallerysystems/emuseum/core/pages/favorites/FavoritesEdit.tml
com/gallerysystems/emuseum/core/pages/favorites/FavoritesIndex.tml
com/gallerysystems/emuseum/core/pages/favorites/FavoritesObjects.tml
com/gallerysystems/emuseum/core/pages/favorites/FavoritesPrivate.tml
com/gallerysystems/emuseum/core/pages/groups/GroupsDetails.tml
com/gallerysystems/emuseum/core/pages/groups/GroupsIndex.tml
com/gallerysystems/emuseum/core/pages/groups/GroupsResults.tml
com/gallerysystems/emuseum/core/pages/search/SearchResults.tml
com/gallerysystems/emuseum/core/pages/users/UsersEdit.tml
com/gallerysystems/emuseum/core/pages/users/UsersIndex.tml
com/gallerysystems/emuseum/core/pages/users/UsersPasswordRecover.tml
com/gallerysystems/emuseum/core/pages/users/UsersPasswordReset.tml
com/gallerysystems/emuseum/core/pages/users/UsersPrivacyPolicy.tml
com/gallerysystems/emuseum/core/pages/users/UsersRegister.tml
Configuration Changes
The following parameters have been removed from the context descriptor (C:\eMuseum\Tomcat9\conf\Catalina\localhost\ROOT.xml on Windows and /var/opt/emuseum/bin/ROOT.xml on Linux per default installation). These options can now be configured in the administration section of eMuseum.
solr.serverUrl
Dashboard → Search and Filtering → Solr Server → Server URL
solr.corePrefix
Dashboard → Search and Filtering → Solr Server → Core Prefix
tapestry.supported-locales
Dashboard → General Settings → Languages
Please set these settings to the values you find in the context descriptor.
