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
- Access the machine on which you installed Fredhopper Access Server.
- Access the Experience Optimization installation media.
- On your Experience Optimization installation media, navigate to Content Delivery\roles\fredhopper\deployment-service\
- 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.
- Deploy the WAR file, SmartTargetDeploymentWebService.war, in your Web application server.
- If your Web application server is IBM WebSphere (with the Liberty profile enabled, as required), install the JAX-WS feature as follows:
- Stop the WebSphere service.
- Open a command prompt.
- Navigate to WEBSPHEREROOT\wlp-webProfile7-java8-win-x86_64-8.5.8\wlp\bin\, where WEBSPHEREROOT\ is your WebSphere root directory.
- Install the feature by entering the following command:
installUtility install jaxws-2.2WebSphere installs the feature after you accept all prompts. - Open your WebSphere server.xml for editing.
- In the
<featureManager>section, add a new<feature>subelement set to the valuejaxws-2.2. - Restart the WebSphere service.
- Verify that the Web service is working by opening a browser and entering:
http://localhost:8080/SmartTargetDeploymentWebServiceIf you are accessing the Web service from a different machine replace
localhostwith the domain name of the machine you are running the Web service on. - On your Fredhopper machine, navigate to the WEB-INF\classes\ subfolder of the root folder of the Web application you just deployed.
- Open SmartTargetDeploymentWebService_conf.xml for editing.
- 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).
- Save and close SmartTargetDeploymentWebService_conf.xml.
- Open logback.xml for editing.
- Set the
log.folderproperty to a value of your choice, for example:<property name="log.folder" value="BASE_DIRECTORY/data/instancesINDEXER/log"/> - Save and close logback.xml
- Optional: Set up authentication:
- Set up username/password based authentication for the Web service in your servlet container.
- Open the
smarttarget_conf.xmlconfiguration file in a text editor and specify the username and password in the<IndexServer>element.
- Configure Experience Optimization in the Content Deployer to point to the Experience Optimization Deployment Web Service:
- On the machine that contains Content Deployer, navigate to the Content Deployer configuration location and open
smarttarget_conf.xmlfor editing. - Change the
<Location>element to point to the Experience Optimization Deployment Web Service:<Location>http://Machine:8080/SmartTargetDeploymentWebService/SmartTargetDeploymentWebService?wsdl</Location> - Save and close smarttarget_conf.xml.
- On the machine that contains Content Deployer, navigate to the Content Deployer configuration location and open