You need to install Experience Optimization presentation server-side components (DLL files, JAR files and config files) in the .NET web application that contains API (in-process).
Before you begin
You have configured your web application to connect to the online Content Interaction Libraries (CILs) to ensure that your web application makes use of the latest versions of the CILs. For .NET, you do this by connecting to the Tridion Sites Delivery NuGet package from Visual Studio.
Procedure
- On the Experience Optimization installation media, go to the following directory:
api\in-process\dotnet\bin
- Copy the following files from your installation media to the indicated subdirectory of your web application.
| Source from the installation media | Target subdirectory of your web application |
|---|
| all DLL files from the bin\ folder | bin/ |
| entire lib\ folder | bin/lib/ |
| all contents of the cartridges\ folder | lib/ |
- Go to the config\ subfolder of the installation media, and copy or merge files to the config/ subdirectory of the web application, as follows:
- smarttarget_conf.xml — Copy the file. You will configure settings in the file in a later task.
- smarttarget.referrers.xml — (Optional) Copy the file if you want to use search terms extracted from the referrer in the search of your website.
- logback.xml — Merge the file with the existing file in your web application.
- cd_ambient_conf.xml — If you have an existing file in your web application, merge the contents of the
<Cartridges> section into the existing file.
Your
Cartridges section must contain the following Cartridge configurations:
<Cartridge File="/session_cartridge_conf.xml"/>
If you have installed the Audience Manager cartridge, make sure it is also configured:
<Cartridge File="/audiencemanager_cartridge_conf.xml"/>
- cd_client_conf.xml — If you have an existing file in your web application, merge the file with the existing file. Additional configuration will be needed in the next step.
- From the config\ folder of the installation media, copy the cd_client_conf.xml file to the config/ subdirectory of your web application, and open it for editing.
- Locate the
QueryClient element, which should look similar to the following:
<?xml version="1.0" encoding="UTF-8"?>
<ServiceConfig Version="10.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="schemas/xo-search-conf.xsd"
ConnectionTimeout="${indexconnectiontimeout:-10000}"
ReadTimeout="${indexreadtimeout:-30000}"
WriteTimeout="${indexwritetimeout:-30000}"
MaxIdleConnections="${indexmaxidleconnections:-30}">
<QueryClient class="com.sdl.tridion.xo.query.client.embedded.EmbeddedQueryClient" Embedded="true">
<QueryProvider Type="elasticsearch">
<Properties>
<Property Name="index.common.name.prefix" Value=""/>
<Property Name="es.host" Value="localhost"/>
<Property Name="es.port" Value="9200"/>
</Properties>
</QueryProvider>
</QueryClient>
- Edit the parameters es.host and es.port with values appropriate for your Elasticsearch instance.
- Save and close cd_client_conf.xml.
Results
You have installed
Experience Optimization in a .NET web application.