Documentation Center

Adding the Context Expression Extension Cartridge to your Content Service or Session-enabled Content Service

Add the Context Expression Extension Cartridge to your Content Service or Session-enabled Content Service to enable Web developers to retrieve and respond to the published context expressions.

Before you begin

Procedure

  1. In the services\ subfolder of the Content Service or of the Session-enabled Content Service (if using), create a new folder called CEE.
  2. On your SDL Web installation media, navigate to Content Delivery\roles\expression\extension-cartridge\lib\.
  3. Copy all files from this location into the CEE\ folder you just created.
  4. Navigate to the bin\config\ (.NET) or WEB-INF/classes/ (Java) subdirectory of your Web site.
  5. Open cd_storage_conf.xml for editing.
  6. In the <Storages> section, find the <StorageBindings> section and add the following inside it:
    <Bundle src="storage_extension_dao_bundle.xml" />
  7. Save and close cd_storage_conf.xml.
  8. Open cd_ambient_conf.xml for editing.
  9. In the <Cartridges> section, add the following:
    <Cartridge File="cx_ambient_cartridge.xml" />
  10. In the <GloballyAcceptedClaims> section, add the following:
    <Claim Uri="taf:request:headers" />
    <Claim Uri="taf:request:full_url" />
  11. To ensure that forwarded cookies are accepted, ensure that the following is present:
    <Cookies>
      <Cookie Type="ADF" Name="TAFContext" />
    </Cookies>
  12. Save and close cd_ambient_conf.xml.
  13. Reinstall the Content Service or Session-enabled Content Service by doing one of the following:
    • If you installed the service using the installService.ps1 PowerShell cmdlet, uninstall it by running uninstallService.ps1. Then run installService.ps1 again, with the same parameter-value pairs you used originally.
    • If you installed the service using the start.ps1 PowerShell cmdlet, kill the process. Then run start.ps1 again, with the same parameter-value pairs you used originally.
    • If you installed the service using the start.sh shell command, uninstall it by running stop.sh. Then run start.sh again, with the same parameter-value pairs you used originally.