Installing Experience Optimization Deployment Web Service

When the Fredhopper Access Server is installed on a different machine than Content Delivery, Content Delivery communicates with Fredhopper Access Server through the Experience Optimization Deployment Web Service.

Procedure

  1. Access the machine on which you installed Fredhopper Access Server.
  2. Access the Experience Optimization installation media.
  3. On your Experience Optimization installation media, navigate to Content Delivery\roles\fredhopper\deployment-service\
  4. Do one of the following:
    • If your Java Web application server is J2EE-compliant, navigate to the j2ee\ subfolder.
    • If your Java Web application server is not J2EE-compliant, navigate to the non-j2ee\ subfolder.
  5. Deploy the WAR file, SmartTargetDeploymentWebService.war, in your Web application server.
  6. If your Web application server is IBM WebSphere (with the Liberty profile enabled, as required), install the JAX-WS feature as follows:
    1. Stop the WebSphere service.
    2. Open a command prompt.
    3. Navigate to WEBSPHEREROOT\wlp-webProfile7-java8-win-x86_64-8.5.8\wlp\bin\, where WEBSPHEREROOT\ is your WebSphere root directory.
    4. Install the feature by entering the following command:
      installUtility install jaxws-2.2
      WebSphere installs the feature after you accept all prompts.
    5. Open your WebSphere server.xml for editing.
    6. In the <featureManager> section, add a new <feature> subelement set to the value jaxws-2.2.
    7. Restart the WebSphere service.
  7. Verify that the Web service is working by opening a browser and entering:
    http://localhost:8080/SmartTargetDeploymentWebService

    If you are accessing the Web service from a different machine replace localhost with the domain name of the machine you are running the Web service on.

  8. On your Fredhopper machine, navigate to the WEB-INF\classes\ subfolder of the root folder of the Web application you just deployed.
  9. Open SmartTargetDeploymentWebService_conf.xml for editing.
  10. Give the <Location> element the following value:
    <Location>BASE_DIRECTORY/INDEXER/data/fas-xml-incremental/CATALOG</Location>
    where:
    • BASE_DIRECTORY is the Fredhopper Access Server
    • INDEXER is the name of the Index Server
    • CATALOG is the name of the Fredhopper catalog (typically catalog01).
  11. Save and close SmartTargetDeploymentWebService_conf.xml.
  12. Open logback.xml for editing.
  13. Set the log.folder property to a value of your choice, for example:
    <property name="log.folder" value="BASE_DIRECTORY/data/instancesINDEXER/log"/>
  14. Save and close logback.xml
  15. Optional: Set up authentication:
    1. Set up username/password based authentication for the Web service in your servlet container.
    2. Open the smarttarget_conf.xml configuration file in a text editor and specify the username and password in the <IndexServer> element.
  16. Configure Experience Optimization in the Content Deployer to point to the Experience Optimization Deployment Web Service:
    1. On the machine that contains Content Deployer, navigate to the Content Deployer configuration location and open smarttarget_conf.xml for editing.
    2. Change the <Location> element to point to the Experience Optimization Deployment Web Service:
      <Location>http://Machine:8080/SmartTargetDeploymentWebService/SmartTargetDeploymentWebService?wsdl</Location>
    3. Save and close smarttarget_conf.xml.