Upgrading from Fredhopper 7.5.0.x to 7.5.1.x

When upgrading from SmartTarget 2014, 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. Capture the instance configuration:
    • On Windows, run the following command:
      bin\capture-export.bat INDEXER <PATH>/SmartTarget_upgrade.zip -c -i -x -l
    • On UNIX, run the following command:
      bin/capture-export.sh INDEXER <PATH>/SmartTarget_upgrade.zip -c -i -x -l
    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.
  2. Stop the Deployment Agent by running the following command from the <BASE_DIRECTORY> in a command prompt:
    • On Windows, run the following command:
      bin/deployment-agent-client stop-agent
    • On UNIX, run the following command:
      bin\deployment-agent-client stop-agent
  3. Rename your old Fredhopper installation folder.
  4. Download and install the Fredhopper Deployment Package.
  5. Copy over your topology.txt file form your old installation.
  6. Run the following command to start your deployment agent:
    bin\deployment-agent
  7. Run the following command to create your Fredhopper cluster:
    bin\setup-cluster
  8. 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
  9. In the <BASE_DIRECTORY>\data\instances\<INDEXER>\custom directory, delete the following JAR files:
    • smarttarget_api_extension.jar
    • configuration-management-rest-extension.jar
  10. Access the SmartTarget installation media.
  11. Install the SmartTarget 2014 SP1 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 Fredhopper 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
  12. 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>
  13. 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
  14. Copy your trigger-types.xml and business.xml to your live instance in the following Fredhopper installation directory:
    <BASE_DIRECTORY>\data\instances\<INDEXER>\config
  15. Run the following command to update the configured live servers with the current index and configuration:
    bin\fresh-index-to-live <INDEXER>