1 Introduction

The SolrCloud Search Service Adapter connects the Intershop Commerce Management (ICM) with a Solr server that runs in cloud mode. It replaces the Solr search service adapter delivered with the ICM release and uses a more recent version of Solr and its features. The search index configuration and maintenance in the ICM back office is almost the same but uses the Schema- and ConfigSet-REST-APIs provided by the newer Solr server version. Thus, the Solr Server is separated and independent of the ICM application server cluster.

1.1 References

• Overview - Search
• Concept - Search Services
• Recipe - Setup Project Using Solr Cloud (ICM version 7.10.10 or later)
• Cookbook - Deployment of Solr Search Adapters (ICM version 7.10.16.6 or later)
• Guide - Deployment Solr Cloud Server
• Guide - Solr Replication
• Guide - Migration Solr4 to Solr Cloud Adapter

1.2 Version Information and Dependencies

Solr 8.8.* does not work with the adapter yet. There is an issue with the configuration Set Backup/Restore that prevents a successful replication of configuration changes. In 8.8.0 there is a backward compatibility issue with SolrJ, see SOLR-15145. Solr 8.6.3/Solr 8.7 requires additional configuration, see ISSEA-167.

Listed Solr server versions were tested to work with the listed SolrCloud Adapter version. In general, minor and patch version upgrades of the Solr server are usually compatible with the adapter.

The following table lists the cartridges contained in the SolrCloud Adapter:

Cartridge	Description	Required
ac_solr_cloud	The main implementation cartridge of the adapter defining and registering the search service.
ac_solr_cloud_bo	Additional functionality for the Commerce Management application. It provides additional configuration options for the index management, especially for suggest and spell-check.
solrcloud_config	Additional configuration to be deployed to share.

2 Deployment

The cartridges need to be deployed as a replacement of the Solr cartridges delivered by default (ac_search_solr, ac_search_solr_bo). These are part of the ICM component set f_business or (better to say) intershop7 assembly. Starting with ICM version 7.10.16.6, the Responsive Starter Store is preconfigured to use the SolrCloud Search Service Adapter by default. Please see the Cookbook - Deployment of Solr Search Adapters on how to setup your project using ICM 7.10.16.6 and higher. For previous ICM versions please follow the Recipe - Setup project using Solr Cloud. The deployment of the SolrCloud Adapter 2.0.0 requires additional deployment of solrcloud_config. Add the 'com.intershop.solrcloud:solrcloud_config' line to the includes of the share host type.

The SolrCloud Search Service Adapter requires a Solr server that runs in cloud mode. Please see the Guide - Deployment Solr Cloud Server on how to setup a Solr server for development or production. This guide also provides information on how to configure ICM to use a Solr server.

3 Data Replication

The data replication of indexes has changed with this adapter implementation. The standard ICM file replication is not used anymore to replicate the index data. Instead, the adapter comes with its own replication decorator that uses the backup/restore collection API functionality of Solr. Please see Guide - Solr Replication for the description and configuration of the index replication with the SolrCloud server.

4 Changelog

4.1 Release 2.3.4

4.1.1 Bugfixes

4.2 Release 2.3.3

4.2.1 Bugfixes

4.3 Release 2.3.2

4.3.1 Bugfixes

4.4 Release 2.3.1

4.4.1 Improvements

4.4.2 Bugfixes

4.5 Release 2.3.0

4.5.1 Updated Intershop Commerce Management Base Version

The base ICM version of the adapter is now 7.10.23.1 The adapter is built and tested with this version. Thus it is recommended to update ICM 7.10.23.1 or higher to use this adapter.

4.5.2 Custom Code Migration

With reworking the SolrCloudClient caching to use a single client object, the following changes were required. Custom code based on these classes must be changed:

• com.intershop.adapter.search_solr.server.SolrServerProvider
  Removed methods: get(SolrIndex index) and get(Domain domain, String indexName, String node) Always use the added method get() instead.
• com.intershop.adapter.search_solr.server.Server was moved to com.intershop.adapter.search_solr.server.SolrServer
• Methods that send requests to the Solr server that require a collection name do have an additional string parameter. The collection name is to be retrieved with SolrCollectionAdmin.getCollectionName(domainName, indexID).

• Instead of:

  Old Code

  	QueryResponse queryResponse = provider.get(idx).query(solrQuery, METHOD.POST);

  use:

  New Code

  	String collectionName = SolrCollectionAdmin.getCollectionName(idx.getDomain().getDomainName(), idx.getIndexID());	
  	QueryResponse queryResponse = provider.get().query(collectionName, solrQuery, METHOD.POST);

The BackupAndRestoreSolrCloudIndexesDecorator was changed:

• The deprecated method com.intershop.adapter.search_solr.server.staging.BackupAndRestoreSolrCloudIndexesDecorator#readAndInstantiateSearchIndexesOfSite(Domain site) is removed.

• The BackupAndRestoreSolrCloudIndexesDecorator keeps track of the backed up edit system indexes now. Indexes that are deleted in the edit system are not available in the backup anymore and will be deleted in the live system as well. In addition, the restored collections are now checked to contain the document count of the backup. The respective methods for restoring the index in the decorator and in the com.intershop.adapter.search_solr.server.impl.SolrCollectionAdmin do have an additional parameter expectedNumFound and old restore methods are deprecated now. (ISSEA-155)

4.5.3 Improvements

4.5.4 Bug Fixes

4.6 Release 2.2.1

4.6.1 Bug Fixes

4.7 Release 2.2.0

4.7.1 Solr Server 8.6

The Solr Server version 8.6.0 in conjunction with data replication requires to set the backup location as an allowed path for the Solr server cluster. You can specify the allowed paths by setting a system property via environment in the startup script:

SOLR_OPTS="$SOLR_OPTS -Dsolr.allowPaths=/mnt/solr_backup"

Please see also the respective Solr Upgrade Notes.

4.7.2 Improvements

4.7.3 Bug Fixes

4.8 Release 2.1.2

4.8.1 Bug Fixes

4.9 Release 2.1.1

4.9.1 Bug Fixes

4.10 Release 2.1.0

4.10.1 Improvements

4.10.2 Bug Fixes

4.11 Release 2.0.3

4.11.1 Bug Fixes

4.12 Release 2.0.2

4.12.1 Improvements

4.12.2 Bug Fixes

4.13 Release 2.0.0

4.13.1 Improvements

4.13.2 Bug Fixes