Below you can find information about the changes that have been made to the solrfacetsearch extension for version 5.7.
Validity
This document is valid for users who use the 5.7 hybris version.
Overview
The hybris version 5.7 introduces new features to the solrfacetsearch extension. The most important areas of improvement are:
- Solr Server: the embedded mode was removed and the Solr server was updated to version 5.3;
- Indexing and Search: new indexing and search mechanisms were introduced, see below how to easily enable or disable the new mechanisms;
- solrfacetsearch extension: major refactoring along with the changes in the source code.
Below you will find details of the changes introduced for hybris version 5.7.
Solr Server
Due to the fact that Solr has deprecated the embedded mode and in order to support the most current version of Solr server,
the embedded mode and embedded Solr server were removed. It means that every environment still using the embedded
mode should be migrated accordingly. To make the transition easier we have introduced the solrserver extension.
This extension includes a standalone Solr server which may be automatically configured, started and stopped together with the Platform.
- Solr Server: the embedded mode was removed and the Solr server was updated to version 5.3;
- Indexing and Search: new indexing and search mechanisms were introduced, see below how to easily enable or disable the new mechanisms;
- solrfacetsearch extension: major refactoring along with the changes in the source code.
Below you will find useful information on migrating a configuration from embedded mode to standalone mode.
1 Configure a standalone Solr server.
SolrFacetSearch - Installation Guide
2 You cannot update the existing SolrServerConfig object because the attribute mode is write protected.
A new SolrServerConfig object needs to be created with the mode attribute set to standalone.
Example:
- ImpEx before:
INSERT_UPDATE SolrServerConfig;name[unique=true];mode(code);embeddedMaster ;electronicsSolrServerConfig;embedded;true
- ImpEx after:
INSERT_UPDATE SolrServerConfig;name[unique=true];mode(code);embeddedMaster ;electronicsSolrServerConfig;standalone;false; INSERT_UPDATE SolrEndpointUrl;solrServerConfig(name)[unique=true];url[unique=true];master[unique=true,default=false] ;electronicsSolrServerConfig;http://localhost:8983/solr;true
Managing Solr Search Configuration3 Make sure your SolrFacetSearchConfig object uses the new SolrServerConfig object.
Updating Solr Index4 Perform the reindexing operation.
Updating Solr Index (Backoffice)
SolrClient Instead of SolrServer
The way in which the platform communicates with Solr server was also changed internally. The SolrServer type has been completely removed and SolrClient type should be used instead.
Indexer Config
The IndexConfig type has a new attribute called legacyMode which controls how the index process behaves.
The default value for the legacyMode attribute is false.