Installing Experience Optimization on premise
Experience Optimization provides API extensions, a Kettle job, and default Fredhopper configuration files to install in your Fredhopper installation.
Procedure
- Download and install the Fredhopper Deployment Package.
- Edit your
topology.txtfile to identify your , for example:INDEXER|localhost|1|-|Indexer and Preview environment for demo setup QUERY|localhost|2|INDEXER|Live Query Server for demo setup - Run the following command to start your deployment agent:
bin\deployment-agent - Run the following command to create your Fredhopper cluster:
bin\setup-cluster - Create the following directories:
- In the BASE_DIRECTORY\data\instances\INDEXER directory, create a directory called \custom.
- In the BASE_DIRECTORY\INDEXER\data\fas-xml-incremental\ directory, create a directory called the name of your universe, for example, BASE_DIRECTORY\INDEXER\data\fas-xml-incremental\CATALOG
- Add
metadata.xmlto the following Fredhopper installation directory: BASE_DIRECTORY\INDEXER\data\fas-xml-incremental\CATALOGThemetadata.xmlis available on the Experience Optimization installation media in the Fredhopper extensions\data folder - Add
trigger-types.xmlandbusiness.xmlto the following Fredhopper installation directory: BASE_DIRECTORY\data\instances\INDEXER\configThe trigger-types.xml and business.xml files are available on the Experience Optimization installation media in the Fredhopper extensions\configuration folder - Run the following command to start the Indexer instance:
bin\instance INDEXER start - Install the API extensions:
- Access the SDL Web installation media.
- In the Fredhopper extensions folder, copy the following JAR files to the \custom directory:
smarttarget_api_extension.jarconfiguration-management-rest-extension-<version>.jarThe following versions of the extension are available, depending on the Fredhopper version you have installed:configuration-management-rest-extensionversionFredhopper Deployment Package version (on premise) -1.0.jar7.5.0.x-1.1.jar7.5.1.x
BASE_DIRECTORY\data\instances\INDEXER\custom - Restart the Query Server running on the Index Server:
bin\deployment-agent-client --location localhost invoke INDEXER qserver stop bin\deployment-agent-client --location localhost invoke INDEXER qserver start
- Add the Kettle job to your Fredhopper installation:
- Access the SDL Web installation media.
- In the Fredhopper extensions folder, copy the STJob.kjb file to the following directory:
BASE_DIRECTORY\data\instances\etl - Load the
metadata.xmlfile by running the following command, on one line, from the root of the Fredhopper installation:bin\run-etl-job STJob.kjb "-DINSTANCE=INDEXER" "-DTRIGGER=load-data" "-DUNIVERSE=catalog01" "-DEXECUTIONPATH=BASE_DIRECTORY/data/instances/INDEXER/custom/"
- Reindexing data
When you make changes to the structure of promotional content in the Content Manager or you change the navigation index in Fredhopper, you need to reindex your data. - Configuring Experience Optimization logging on Fredhopper
Thelog4j.xmlfile is the configuration file for the logging framework used by Fredhopper.