Content Delivery search feature additional prerequisites
In addition to the general Content Delivery microservice prerequisites, there are additional prerequisites that must be satisfied specifically for the IQ Indexing Service .
The search feature requires an Elasticsearch database with a number of plugins enabled.
- If you are performing a fresh install of SDL Tridion Sites, and you do not have SDL Tridion Docs installed, simply download and install Elasticsearch, install the required plugins, and follow the instructions for installing the IQ Indexing Service.
- If you are performing a fresh install of SDL Tridion Sites, and you do have SDL Tridion Docs installed, you can reuse its IQ Indexing Service, and, as a result, also the Elasticsearch instance of SDL Tridion Docs.
- If you are upgrading from SDL Tridion Sites 9 or SDL Tridion Sites 9.1, and if your installation includes the Experience Optimization feature, and you do not have SDL Tridion Docs installed, then you already have an Elasticsearch instance running as part of SDL Tridion Sites, and you only need to create new Elasticsearch indexes for the Content Delivery search feature in the existing Elasticsearch instance by running the IQ bootstrap scripts as explained in the instructions for installing the IQ Indexing Service.
- If you are upgrading from SDL Tridion Sites 9 or SDL Tridion Sites 9.1, and if your installation includes the Experience Optimization feature, and you do have SDL Tridion Docs installed, then you may have two separate Elasticsearch instances running side by side. In this case, do not use the bootstrap script, but migrate the Docs indexes into the existing Elasticsearch database you already were using for Experience Optimization in Sites, by running the IQ migration scripts instead.
You can install Elasticsearch on-premises or in the Cloud. Install Elasticsearch version 7.7 (on-premises version or Cloud version). Elasticsearch is free to download from Elastic at https://www.elastic.co/.
- Ingest Attachment Processor Plugin, documented here: https://www.elastic.co/guide/en/elasticsearch/plugins/7.7/ingest-attachment.html
- ICU Analysis Plugin, documented here: https://www.elastic.co/guide/en/elasticsearch/plugins/7.7/analysis-icu.html
- You can only use Elastic Stack if you run Elasticsearch yourself, either on-premises or in your own Cloud environment.
- Some features in Elastic Stack require a paid license included in an Elasticsearch Gold or Platinum subscription.
- Set the initial and maximum memory allocation pools to the same value.
- Set both pools to a minimum of 1024 megabytes each (we recommend higher).
-Xms1024m
-Xmx1024m