Documentation Center

Upgrading from Fredhopper 7.1.2 or 7.1.9 to 7.5.0.x or 7.5.1.x

When upgrading from SmartTarget 2011 (SP1, SP2 or SP3) to upgrade your Fredhopper version: make a capture your configuration files and upgrade to the latest version of the Fredhopper Deployment Package. You then need to reinstall your configuration files and install the SmartTarget API extensions and Kettle job.

Before you begin

This task summarizes the instructions for installing the Fredhopper Deployment Package: refer to the Fredhopper Learning Center for detailed information, including prerequisites.

About this task

The following variables are used in this section:
VariableDescription
<BASE_DIRECTORY>The Fredhopper Deployment Package base directory, for example C:\fredhopper. Execute scripts in the <BASE_DIRECTORY> of the server.
<INDEXER>The name of your Index Server specified in the topology.txt file
<CATALOG01>The name of your default universe.

Procedure

  1. Stop the Index Server by running the following command, from the fredhopper\instance\FAS directory, in a command prompt:
    bin\stoploader
  2. Stop the Query Server by running the following command, from the fredhopper\instance\FAS directory, from the command prompt:
    bin\qserver stop
  3. Capture the instance configuration:
    • On Windows, run the following command:
      bin\capture -d <PATH>/ -c 
    • On UNIX, run the following command:
      bin/capture -d <PATH>/ -c 
    where <PATH> is the file system folder where you want create the file to use. Ensure that the output folder exists.
    The capture command generates a ZIP file using the format MachineName-ciD-timestamp.zip in the specified location. The file is referred to as SmartTarget_upgrade.zip in the import step below.
  4. Rename your Fredhopper installation folder.
  5. Download and install the Fredhopper Deployment Package.
  6. Edit your topology.txt file, for example:
    <INDEXER>|localhost|1|-|Indexer and Preview environment for demo setup
    <QUERY>|localhost|2|<INDEXER>|Live Query Server for demo setup
  7. Run the following command to start your deployment agent:
    bin\deployment-agent
  8. Run the following command to create your Fredhopper cluster:
    bin\setup-cluster
  9. Create the following directories:
    1. In the <BASE_DIRECTORY>\data\instances\<INDEXER> directory, create a directory called \custom.
    2. 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\<CATALOG01>
    3. In the <BASE_DIRECTORY>\<INDEXER>\data\fas-xml\ directory, create a directory called the name of your universe, for example:
      <BASE_DIRECTORY>\<INDEXER>\data\fas-xml\<CATALOG01>
  10. Import the instance configuration:
    • On Windows, run the following command:
      bin\capture-import <INDEXER> <PATH>/SmartTarget_upgrade.zip
    • On UNIX, run the following command:
      bin/capture-import <INDEXER> <PATH>/SmartTarget_upgrade.zip
  11. Delete the styles folder in the following location:
    <BASE_DIRECTORY>\data\instances\<INDEXER>\config\styles
  12. Go to your old Fredhopper installation and copy the XML files in the following directory:
    fredhopper\instance\FAS\data\xml\processed\batch
    Paste the files into the following folder:
    <BASE_DIRECTORY>\<INDEXER>\data\fas-xml\<CATALOG01>
  13. Install the API extensions:
    1. Access the SmartTarget installation media.
    2. In the Fredhopper extensions folder, copy the following JAR files to the \custom directory:
      • smarttarget_api_extension.jar
      • configuration-management-rest-extension-<version>.jar The following versions of the extension are available, depending on the FAS version you have installed:
        configuration-management-rest-extension versionFredhopper Deployment Package version (on premise)
        -1.0.jar7.5.0.x
        -1.1.jar7.5.1.x
      <BASE_DIRECTORY>\data\instances\<INDEXER>\custom
  14. Add the Kettle job to your Fredhopper installation:
    1. Access the SmartTarget installation media.
    2. In the Fredhopper extensions folder, copy the STJob.kjb file to the following directory:
      <BASE_DIRECTORY>\data\instances\etl
  15. Run the following command to recreate the index:
    bin\reindex <INDEXER>
  16. Copy your trigger-types.xml and business.xml to your live instance in the following Fredhopper installation directory:
    <BASE_DIRECTORY>\data\instances\<INDEXER>\config
  17. Run the following command to update the configured live servers with the current index and configuration:
    bin\fresh-index-to-live <INDEXER>