Configuring a Coveo .NET Front-End 12 Server to Use a CES 6.5 Back-End Server

The Coveo .NET Front-End version 12 that comes with the Coveo Platform 7 can also communicate with Coveo Enterprise Search (CES) 6.5 Back-End servers. This compatibility allows you to progressively migrate to the Coveo Platform 7 by starting to use the new .NET search interfaces with your existing CES 6.5 index.

Note: In a geographically distributed index (GDI) configuration, a Coveo .NET Front-End search interface can connect to multiple Back-End servers only when they are of the same major CES version, such as all CES 6.5, or all CES 7.0.

The main tasks to perform are:

If not already done, install the Coveo .NET Front-End components on a server of your choice (see Installing Coveo .NET Front-End).
Edit the Coveo .NET Front-End web.config file to instruct the search interface to communicate with a CES 6.5 Back-End Server (see Configuring the Front-End to Use a CES 6.5 Back-End ).
When you install the Coveo .NET Front-End 12 components on a server where the CES 6.5 Front-End components are installed, you must edit three web.config files to be able to use the .NET Interface Editor (see Editing web.config Files to Enable the Use of the .NET Interface Editor).

Configuring the Front-End to Use a CES 6.5 Back-End

Using an administrator account, connect to the Front-End server where you installed the Coveo .NET Front-End components.
Using a text editor:
1. Open the [.Net_Front-End_Path]\Web\web.config file.
  
  Example: By default, this file is in the C:\Program Files\Coveo .NET Front-End 12\Web\ folder.
2. In the <coveoEnterpriseSearch> section, edit the <server hostname="localhost" port="52800"/> line:
  1. When the CES 6.5 Master server is installed on another server, replace localhost by the name of the CES 6.5 Master server.
  2. When the CES 6.5 Master server uses a CES service port other than the default port, change the port= value accordingly (see About the CES Service Port).
    
    Tip: You can look in the web.config file on your Coveo Platform 6.5 Front-End server that you are replacing to find the hostname and port values to use.
  3. Add the enable65SearchAPI="true" case-sensitive attribute to activate the CES 6.5 compatibility mode.
  Example: The line is as follows when the server name is MyCES65Server and uses the default CES service port: <server hostname="MyCES65Server" port="52800" enable65SearchAPI="true" />
  
  Note: When Coveo .NET Front-End 12 is installed on a server different from the CES 6.5 Master server, you must also add the impersonate="true" attribute to the <server hostname="localhost" port="52800" enable65SearchAPI="true" impersonate="true"/> line, and on the CES 6.5 Master server, using the CES 6.5 Administration Tool, you must grant the impersonator permission to the user that runs the AppPool of the Coveo .NET Front-End 12 web application (see Granting Impersonator Privileges).
3. Save the file.
Using a browser, open the Coveo .NET Front-End search interface and perform searches to validate that it returns search results from the CES 6.5 Master server.

Editing web.config Files to Enable the Use of the .NET Interface Editor

Important: You must perform the following procedure only when you install the Coveo .NET Front-End 12 components on a server where the CES 6.5 Front-End components are also installed. The .NET Interface Editor is working out-of-the-box otherwise.

To modify the first web.config file:
1. Using an administrator account, connect to the Front-End server where you installed the Coveo .NET Front-End 12 components.
2. Using a text editor:
  1. Open the [.Net_Front-End_Path]\Web\web.config file.
    
    Example: By default, this file is in the C:\Program Files\Coveo .NET Front-End 12\Web\ folder.
  2. Above the </coveoEnterpriseSearch> line, add the following line:
```
<locations coveoPath="C:\Program Files\Coveo .NET Front-End 12\Web\Coveo\" searchUri="http://MyCES65Server:8080" searchAdminUri="http://MyCES65Server:8080/SearchAdmin" helpUri="http://MyCES65Server:8080/Help/"/>  
```
    where:
    - You edit the coveoPath= value when Coveo .NET Front-End is not installed in the default folder.
    - You replace MyCES65Server by the name of your server, or localhost when the Front-End and Back-End components are on the same server.
    - You replace 8080 by the appropriate port when your Coveo .NET Front-End server uses a port other than the default.
  3. Save the file.

To modify the second web.config file:

Using an administrator account, connect to the CES 6.5 Master server.

Using a text editor:

Open the Microsoft .NET Framework 2.0 web.config file.
Example: By default, the web.config file folder is:
- For a 64-bit system: C:\Windows\Microsoft.NET\Framework64\v2.0.xxxxx\CONFIG
- For a 32-bit system: C:\Windows\Microsoft.NET\Framework\v2.0.xxxxx\CONFIG

In the <sectionGroup name="coveoEnterpriseSearch"> section, locate and replace the following two lines:

<section name="additionalEditInterfacePages" type="Coveo.CES.Web.Search.Admin.AdditionalPagesConfigSection, Coveo.CES.Web.Search.SearchAdminSite, Version=6.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2"/>
<section name="taggersDefinition" type="Coveo.CES.Web.Search.Tagging.TaggersConfigSection, Coveo.CES.Web.Search, Version=6.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2"/></sectionGroup>

by the following two lines:

<section name="additionalEditInterfacePages" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
<section name="taggersDefinition" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/></sectionGroup>

Save the file.

To modify the third web.config file, still on the CES 6.5 Master server, using a text editor:

Open the [CES_Path]\Web\web.config file.

Example: By default, this file is in the C:\Program Files\Coveo Enterprise Search 6\Web\ folder.

Above the </coveoEnterpriseSearch> line, add the following line:

<locations coveoPath="C:\Program Files\Coveo Enterprise Search 6\Web\Coveo\" searchUri="http://MyCES65Server:8080" searchAdminUri="http://MyCES65Server:8080/SearchAdmin" helpUri="http://MyCES65Server:8080/Help/"/>

where:

You edit the coveoPath= value when CES 6 is not installed in the default folder.
You replace MyCES65Server by the name of your server, or localhost when the Front-End and Back-End components are on the same server.
You replace 8080 by the appropriate port when your Coveo .NET Front-End server uses a port other than the default.

Example: The complete section looks like:

<coveoEnterpriseSearch>
  <server hostname="localhost" impersonate="false" mirrorName="default" port="52800"/>
  <database enabled="false" connectionString="mongodb://localhost/databaseName"/>
  <analytics enabled="false" connectionString="Data Source=yourServerName;Initial Catalog=CoveoAnalytics;Integrated Security=SSPI;"/>
  <locations coveoPath="C:\Program Files\Coveo Enterprise Search 6\Web\Coveo\" searchUri="http://MyCES65Server:8080" searchAdminUri="http://MyCES65Server:8080/SearchAdmin" helpUri="http://MyCES65Server:8080/Help/"/>
</coveoEnterpriseSearch>

Save the file.

To validate that you can open the .NET Interface Editor, using a browser:
1. Open the Coveo .NET Front-End search interface.
2. On the Do more menu, select Edit this Interface to access the .NET Interface Editor.

Ask your questions on connect.coveo.com.

People who viewed this topic also viewed

Community

Product DocsMenu

Configuring a Coveo .NET Front-End 12 Server to Use a CES 6.5 Back-End Server

Configuring the Front-End to Use a CES 6.5 Back-End

Editing web.config Files to Enable the Use of the .NET Interface Editor