Step 2: Installing Fredhopper (deprecated)

Install Fredhopper (deprecated) on your target machine as part of your setup for this quick installation.

Before you begin

Make sure you have the Java Development Kit (JDK) 8 installed and have set JAVA_HOME in your computer environmental variables.

Procedure

  1. Contact SDL Customer Support to obtain a Fredhopper deployment ZIP file. Typically, this file is around 1 GB in size.
  2. Unzip the package to a directory of your choosing on your target machine, for example, c:\fredhopper\.
  3. In the config\ subfolder of the target folder, say, c:\fredhopper\config\, create a plain-text file with the following contents:
    # The topology file defines your indexing and live servers 
    # instance name | host | preset | indexer | comment 
    ExperienceOptimization|localhost|1|-|Indexer and Preview environment for demo setup 
    ExperienceOptimizationLive|localhost|2|ExperienceOptimization|Live Query Server for demo setup
    Where:
    • ExperienceOptimization is the Indexer Server (for getting content into Fredhopper)
    • ExperienceOptimizationLive is the Query Server (for getting content out of Fredhopper)
  4. Open a command prompt and run the following command in the target folder to start the deployment agent:
    bin\deployment-agent
  5. Open up another command prompt and run the following command to create your instances as specified in the topology file (in this case, ExperienceOptimization and ExperienceOptimizationLive):
    bin\setup-cluster
  6. In the \data\instances\ExperienceOptimization\ subfolder of your target folder, create a subfolder called custom\.
  7. On the SDL Tridion Sites installation media, navigate to the folder Content Delivery\roles\fredhopper\extensions\.
  8. Copy the following files to the custom\ folder you just created on the target machine:
    • smarttarget_api_extension.jar
    • If you use Fredhopper 14 or later, configuration-management-rest-extension-1.1.jar
    • If you use Fredhopper 13 or earlier, configuration-management-rest-extension-1.0.jar
  9. In the ExperienceOptimization\data\fas-xml-incremental\ subfolder of your target folder, create a subfolder called catalog01\.
  10. From the installation media folder called Content Delivery\roles\fredhopper\extensions\data\, copy metadata.xml file to the catalog01\ folder you just created.
    The metadata.xml file has the set of default fields needed by Experience Optimization to use Fredhopper. You can run a command to process the file as described in the main Experience Optimization documentation, but it will also be processed when you first publish Components to Fredhopper.
  11. From the installation media folder called Content Delivery\roles\fredhopper\extensions\configuration\, copy trigger-types.xml and business.xml to the data\instances\ExperienceOptimization\config\ subfolder of your target folder.
  12. From the installation media folder called Content Delivery\roles\fredhopper\extensions\, copy STJob.kjb to the data\instances\etl\ subfolder of your target folder.
  13. Start up the ExperienceOptimization or ExperienceOptimizationLive instance using the command:
    bin\instance ExperienceOptimization
    or
    bin\instance ExperienceOptimizationLive
  14. Copy the configurations and data across from one instance to another (that is, from ExperienceOptimization to ExperienceOptimizationLive) using the command:
    bin\fresh-index-to-live ExperienceOptimization
  15. Publish some content to Fredhopper.
  16. Browse to the Fredhopper Business Manager:
    http://localhost:8180/fredhopper/admin/ 
    Use the credentials admin/admin to log on. (The Business Manager connects to the Index Server.)