Installing the Content Delivery Web service as a .NET Web application

Install the Content Delivery Web service Server Role to give third parties access to your published content. The Experience Manager Web service and the two User Generated Content Web services already include the Content Delivery Web service, so if you already installed either of these, you have already installed the Content Delivery Web service.

Procedure

  1. Ensure that all the prerequisites for a Content Delivery Server Role are met on your target system.
  2. Access the SDL Tridion installation media.
  3. Navigate to the Content Delivery\roles\ folder.
  4. Access the webservice\dotNET\webapp\ subfolder.
  5. Do one of the following:
    • To install a 32-bit .NET Web application, access the x86\ subfolder.
    • To install a 64-bit .NET Web application, access the x86_64\ subfolder.
  6. If this is a 32-bit .NET Web application running in combination with Java 6, then in the advanced system properties of your machine, select Environment Variables to see and edit your environment variables, and ensure that your PATH variable contains the bin\ subfolder of the Java instance you are using. This location contains the file MSVCR71.DLL.
  7. On your Windows machine, start up the Server Manager and do one of the following:
    • If this Web application runs under Windows 2012 or Windows 2012 R2, start up the Add Roles and Features Wizard. Step through the wizard until you reach the Features screen. Now do one of the following:

      • If you use .NET 4.5, expand the item .NET Framework 4.5 Features and the subitem WCF Services.
      • Alternatively, if you use .NET 3.5, expand the item .NET Framework 3.5 Features.
    • Alternatively, if this Web application runs under Windows 2008 R2 SP1, under Features Summary, select Add Features. In the Add Features dialog that opens, expand the item .NET Framework 3.5.1 Features and the subitem WCF Activation.

    If the option HTTP Activation is not listed as installed, select it. Then click Next and Install to install the feature.
  8. Unzip the Zip file in this location to the location on your target system where you want to place the .NET Web application.
  9. If you store published content in a database, download the JDBC driver (JAR file) required for your specific database vendor and copy it into the bin\lib folder of your Web application:
    VendorJDBC DriverRequired JAR
    Microsoft SQL ServerMicrosoft SQL Server JDBC Driver 4.0

    sqljdbc42.jar for Java 8

    sqljdbc4.jar for Java 6 or Java 7

    OracleOracle JDBC driver 11.2.0.3 (deprecated)

    ojdbc6.jar for Java 6 or Java 7

    OracleOracle JDBC driver 12.1.0.1

    ojdbc7-12.1.0.1.jar for Java 8

    ojdbc7.jar for Java 7

    ojdbc6.jar for Java 6

    IBM DB2IBM Data Server Driver for JDBC and SQLJ (9.7 GA) (deprecated)

    Not supported with Java 8

    db2jcc.jar for Java 6 or Java 7

    You can download JDBC drivers from the following locations:
  10. Navigate to \Content Delivery\resources\configurations\.
  11. Copy logback.xml from that folder to the bin\config folder of your Web application.
  12. Copy and rename the following configuration files to the bin\config folder of your Web application:
    Corresponding configuration fileRenamed configuration file
    cd_ambient_conf_sample.xmlcd_ambient_conf.xml
    cd_dynamic_conf_sample.xmlcd_dynamic_conf.xml
    cd_storage_conf_sample.xmlcd_storage_conf.xml
    cd_link_conf_sample.xmlcd_link_conf.xml
    cd_webservice_conf_sample.xmlcd_webservice_conf.xml
    cd_wai_conf_sample.xmlcd_wai_conf.xml
  13. Open cd_ambient_conf.xml for editing.
  14. Find the <Security> section and enclose it in comments. This element is only needed if you intend to set up OAuth authentication.
  15. Save and close cd_ambient_conf.xml.
  16. Copy cd_licenses.xml, your Content Delivery license file available from SDL Tridion Customer Support, to the bin\config directory of your Web application.
    If you want to name the file differently or put it in a different location, you need to update the License element in your configuration files.
  17. Optional: Configure logging.
  18. Configure the Storage Layer and optionally encrypt sensitive strings.
  19. Open Web.config for editing in the root folder of this Web application.
  20. To enable the Ambient Data Framework, do the following:
    Application Pool in Classic Mode

    Ensure the presence of the following inside the <httpModules> section inside the <system.web> section (create an <httpModules> element if it does not yet exist):

    <add type="Tridion.ContentDelivery.AmbientData.HttpModule" 
    	name="Tridion.ContentDelivery.AmbientData.HttpModule" />

    To enable the Ambient Data Framework for static Web pages, also do the following:

    • Ensure the presence of the following inside the <handlers> section inside the <system.webServer> section (create a <handlers> section if it does not yet exist):

      <remove name="StaticFile" />
      <add name="StaticFile" path="" verb="" modules="IsapiModule,StaticFileModule,DefaultDocumentModule,DirectoryListingModule"
        scriptProcessor="c:\PATH\TO\DOTNET\aspnet_isapi.dll" resourceType="Either" requireAccess="Read" preCondition="bitness64" />

      where c:\PATH\TO\DOTNET\ is the path to your .NET Framework root folder, for example, C:\Windows\Microsoft.NET\Framework64\v4.0.30319\.

      If you run 32-bit .NET, remove the preCondition attribute.

    • Ensure the presence of the following inside the <httpHandlers> section inside the <system.web> section (create an <httpHandlers> section if it does not yet exist):

      <add verb="GET" path="*" type="System.Web.StaticFileHandler" />
    Application Pool in Integrated Mode

    Add the following inside the <modules> section inside the <system.webServer> section (create a <modules> element if it does not yet exist):

    <add type="Tridion.ContentDelivery.AmbientData.HttpModule" 
    	name="Tridion.ContentDelivery.AmbientData.HttpModule" />
  21. Save and close Web.config.
  22. Disable recycling of the Application Pool of this Web application by doing the following:
    1. Open IIS Manager.
    2. From the tree on the left, select the current machine and navigate to the Web application you just created.
    3. Click Advanced settings to open a dialog with the application's properties, and note down the value of Application Pool.
    4. Close the dialog.
    5. From the tree on the left, under the current machine, now select the Application Pools node.
    6. From the list on the right, select the Application Pool you just noted down.
    7. Select Recycling in the Edit Application Pool area on the right.
    8. In the dialog that opes, deselect Regular time intervals, then click Next and Finish to commit your change.
    9. Restart IIS.
  23. Restart the Web application.