HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Install and deploy search service

Describes how to install and deploy search service.

📘

Note

The Full-text Search Service applies to Optimizely Content Management System (CMS 11) and is not supported on Optimizely Digital Experience Platform (DXP) and other cloud service deployments. It is a legacy feature that will be removed in future versions.
This section is not supported for ASP.NET Core-based applications.

The Search service is deployed through the NuGet package EPiServer.Search. You can install the package on an existing site (the service then runs inside the same application as the site), or you can install the package on an empty web project. The NuGet package updates the configuration file with default settings for the service.

The search integration with CMS is deployed through the NuGet package EPiServer.Search.Cms and should always be installed in an CMS website; it contains the required funcionality to query the search service and to integrate with the user interface in CMS.

📘

Note

The EPiServer.Search.Cms NuGet package was introduced in CMS 11; previously, this functionality was included in the core platform. This package is to be used when the basic search functionality is used.

Client configuration (EPiServer.Search.Cms package)

Configure the search client on the website to use the service. Set the attribute baseUri attribute to the endpoint for the service. The following example shows a default configuration:

<episerver.search active="true">
      <namedIndexingServices defaultService="serviceName"> 
         <services> 
           <add name="serviceName" 
                baseUri="http://sitehost/IndexingService/IndexingService.svc" 
                accessKey="local" /> 
         </services>
      </namedIndexingServices> 
      <searchResultFilter defaultInclude="true">
         <providers /> 
      </searchResultFilter> 
</episerver.search>

Service configuration (EPiServer.Search package)

The default configuration allows local connections; that is, requests originated from the same server are allowed. If you deploy the Search service to another machine than the site, then the specify the ipAddress and ip6Address attributes  as follows:

<episerver.search.indexingservice> 
      <clients> 
        <add name="local" 
             description="local" 
             allowLocal="true" 
             ipAddress="<ipaddress here>" 
             readonly="false"/> 
      </clients> 
      <namedIndexes defaultIndex="default"> 
        <indexes> 
          <add name="default" 
               directoryPath="[appDataPath]\Index" 
               readonly="false"/> 
        </indexes> 
      </namedIndexes> 
</episerver.search.indexingservice>

You also can configure the service to accept requests from all IP addresses and use an access key instead; useful in cloud environments where IP addresses are not known. In that case, the client configuration on the site should specify an access key and a client configuration  with same name as the accessKey should exist on the service configuration, as shown in the following example:

Client configuration:

<episerver.search active="true">
      <namedIndexingServices defaultService="serviceName">
        <services>
          <add name="serviceName" 
               baseUri="http://<yoursearchsite>/IndexingService/IndexingService.svc" 
               accessKey="C7184E3ED7134895B3E95AB3AB4F4AE5" />
        </services>
      </namedIndexingServices>
      <searchResultFilter defaultInclude="true">
        <providers />
      </searchResultFilter>
    </episerver.search>

Server configuration:

<episerver.search.indexingservice>
      <clients>
        <add name="C7184E3ED7134895B3E95AB3AB4F4AE5" 
             description="local" 
             allowLocal="false" 
             ipAddress="0.0.0.0/0" 
             ip6Address="::/0" 
             readonly="false" />
      </clients>
      <namedIndexes defaultIndex="default">
        <indexes>
          <add name="default" 
               directoryPath="[appDataPath]\Index" 
               readonly="false" />
        </indexes>
      </namedIndexes>
    </episerver.search.indexingservice>

Deploy the site

When you deploy the site to production, update the baseUri to the production search service. When you deploy the Search service to production, you might need to update the allowed IP addresses if that configuration is used.

Host the service in IIS

To host the service in IIS you need to enable the Windows feature HTTP Activation (on Windows server: typically Roles and Features > .NET Framework 4/4.5 Featues > WCF Service).

Logging

The search indexing service uses the Logging. Make sure there is a provider such as EPiServer.Logging.Log4Net installed to enable logging.