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 Experience Optimization 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 Experience Optimization 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 change the navigation index in Fredhopper, you need to reindex your data. (Fredhopper indexes data using live attributes that you have added to the navigation index.) - Configuring Experience Optimization logging on Fredhopper
Thelog4j.xmlfile is the configuration file for the logging framework used by Fredhopper.