10018---SolrFacetSearch - Installation Guide

Below you can find information about the installation ofsolrfacetsearch extension.

Overview

The solrfacetsearch is an extension developed by hybris. Once you have installed the hybris Commerce Suite the extension is available in

 the /hybris/bin/ext-commerce/ directory.

Note

Make sure you have enabled the solrfacetsearch extension for the hybris Commerce Suite by editing the localextensions.xml in the /hybris/config/ directory.

Configuring the Solr Server

In order for the extension to work properly, it needs to be connected to a running Solr server. You can read more about various configuration possibilities in the next sections.

solrserver Extension

To support running of the Solr server, the embedded mode was removed along with hybris version 5.7. To make the transition easier we have introduced the solrserver extension. For details refer to solrserver Extension.

Using the solrserver Extension

By enabling the solrserver extension in your localextensions.xml you will have a standalone Solr server ready to be used. The default configuration ensures that a Solr server is configured, started and stopped together with the Platform. This is very convenient in CI or developer environments.

Configuring a Standalone Server

The solrserver extension contains an already configured server that you can use, the server is available under 

hybris/bin/ext-commerce/solrserver/resources/solr/.

This is a standard Solr server with some modifications to make it lightweight and compatible with hybris. The server needs to be started and stopped manually.

Note

For the list of changes refer to the HYBRIS_README.txt file. It is recommended to copy it to another directory and run it from there. 

Note

On unix-based systems the bin/solr script may not be executable by default. To make it executable, run the following command in the Solr server root directory:

# chmod +x bin/solr

Using a Standalone Server from a Previous Release

It is recommended to use the Solr server bundled together with a specific hybris version, however in some cases it is still possible to connect to a Solr server from a previously released version.

Info

To use the Solr server from an hybris version prior to 5.7, please enable the legacy mode attribute in the indexer configuration.