Documentation Center

Setting up the Ambient Data Framework in a Java Web application

To install the Ambient Data Framework for a Content Delivery Java Web application, copy JAR files, copy a configuration file, and modify web.xml.

Procedure

  1. Copy Content Delivery\roles\api\in-process\java\lib\cd_ambient.jar from the installation media to the WEB-INF/lib folder of your Web application.
  2. Copy cd_ambient_conf.xml from the Content Delivery\roles\api\in-process\config\ folder to your WEB-INF/classes folder.
  3. Open cd_ambient_conf.xml for editing.
  4. Find the <Security> section and enclose it in comments. This element is only needed if you intend to set up OAuth authentication.
  5. Save and close cd_ambient_conf.xml.
  6. 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.

  7. Restart the Web application.