Introduction

The SolrCloud Search Service Adapter connects the Intershop Commerce Management (ICM) to a Solr server running in cloud mode. The search index configuration and maintenance in the ICM back office uses the Schema and ConfigSet REST APIs provided by Solr. As a result, the Solr server is separate and independent of the ICM application server cluster.

References

• Overview - Search

• Cookbook - Solr Cloud Server

• Concept - Search Services

Version Information and Dependencies

Please see Reference - ICM 14 Release Versions for versions that are released and tested together.

Delivery

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

Setup

1. Follow the basic setup of ICM 14 customization described in Concept - Customization - Deployment - ICM 11+ to add the customization cartridges to ICM and to the cartridge list.

2. Add the ft_solr_cloud feature to the cartridge list:

     environment:
       CARTRIDGE_LIST: "ft_demo_search ft_headless ft_solr_cloud"

3. Add the Solr adapter to the customizations section of the helm chart:

   ...
   customizations:
       solrcloud:
         repository: intershophub/icm-as-customization-f_solrcloud:6.0.0
   ....
   

The following environment variables show the setup of the most common options:

  environment:
    SOLR_CLOUDSOLRSERVERURLS: "https://slr-test-slr-test-solrcloud.test.intershop.com/solr"
    SOLR_CLUSTERINDEXPREFIX: "cstmr-int-ed"
    SOLR_COLLECTIONREPLICATIONFACTOR: 2
    SOLR_CLOUDBACKUPLOCATION: "/var/solr/data/backup-restore/local-collection-backups-1"   
    SOLR_BASICAUTH: "solr:SolrIsAwesome!"

The environment variables in detail (from top to bottom):

• With SolrCloud Adapter 7, it is required to configure a common Solr service URL using SOLR_CLOUDSOLRSERVERURLS instead of a connection to a list of Zookeeper hosts. (This configuration is required.)

• The cluster index prefix is required to distinguish the indexes from multiple ICM systems, e.g., if data replication is used (optional on development environment).

• The recommendation for the replication factor is 2 to have redundancy of indexes on two nodes. This ensures an index remains online even during a rolling restart of the Solr cluster. (Set to 1 if there is only a single Solr, e.g., in development environments.)

• A backup location is needed if data replication for search indexes is used.

• In general, basic authentication is used for the connection from ICM to the Solr server. To configure basic authentication, add the user and password to the environment.

The basic authentication credentials can also be retrieved from a generic secret instead of being stored as plain text in the environment:

  secrets:
    - env: SOLR_BASICAUTH
      name: icm-secrets
      key: solr_basicauth
 

The adapter comes with an initial Solr configset configuration that is prepared in sites/root/1/solrcloud. If the customization is added after database initialization, it is important to execute the initialization for the ac_solr_cloud to make this configuration available.

Configuration

1. Enable the managed services in Intershop Organization Management (Operations), see Intershop Organization Management User Manual | Managing Services.

2. Create search services in the organization and channels, see Intershop Commerce Management User Manual | Managing Search Index Services.

3. Create and manage search indexes, see Intershop Commerce Management User Manual | Managing Search Indexes.

Feature Overview

The SolrCloud Search Service Adapter 7 connects Intershop Commerce Management (ICM) to Apache Solr to provide integrated search and navigation capabilities based on ICM's managed search service integration framework. The adapter provides the full backend feature set as described in Feature List - Intershop Commerce Management B2X 7.10 | Search and Navigation. However, some features (display of spell-checking results, search redirects, object suggest search) are no longer integrated out of the box into the ICM 12 standard storefront (PWA).

Changelog

Release 7.0.0

Features

Bugfixes