To install the Ambient Data Framework for a Content Delivery Java Web application, copy JAR files, copy a configuration file, and modify web.xml. Note that the Ambient Data Framework does not work in combination with a classic ASP Web site.
Procedure
- Copy the following files from the installation media to the WEB-INF/lib folder of your Web application:
- From the Content Delivery\roles\api\java\lib\ folder: cd_ambient.jar
- From the Content Delivery\roles\api\java\third-party-lib\ folder: json-smart.jar
Note: If the API Server Role is installed in this Web application, these JAR files are already present.
- Copy cd_ambient_conf_sample.xml from the Content Delivery\resources\configurations\ folder to your WEB-INF/classes folder and rename the file to cd_ambient_conf.xml.
- Open cd_ambient_conf.xml for editing.
- Find the
<Security> section and enclose it in comments. This element is only needed if you intend to set up OAuth authentication.
- Save and close cd_ambient_conf.xml.
- Enable the Ambient Data Framework by adding the following to your web.xml:
<filter>
<filter-name>Ambient Data Framework</filter-name>
<filter-class>com.tridion.ambientdata.web.AmbientDataServletFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>Ambient Data Framework</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
- If you are setting up the Ambient Data Framework in the Content Deployer (HTTP or HTTPS), and you want to enable the Framework for the Deployer only, rather than for the entire Web application, replace this line:
<url-pattern>/*</url-pattern>
with this line:
<servlet-name>httpupload</servlet-name>
This enables the Ambient Data Framework for the Content Deployer (HTTP or HTTPS) only.
- Restart the Web application.