Installing a server role as a .NET Web application—universal procedure

To install a server role as a .NET Web application, you need to set up the correct Web application directory structure then copy over the necessary JAR files, .NET libraries, configuration files and other resources. You then need to perform configuration, remove recycling of the IIS worker process, set up .NET server controls, and install a license.

Before you begin

Read the Content Delivery prerequisites before installing a server role.

Procedure

  1. Create a new .NET Web application.
  2. Create the Web application directory structure:
    1. In the root folder, create a bin\ subfolder.
    2. In the bin\ folder, create subfolders config\ and lib\.
    The Web application should have the following folder structure:
    root\
       +--bin\
          +--config\
          +--lib\
  3. Access the SDL Tridion installation media.
  4. Navigate to the Content Delivery\ folder.
  5. Access the dotNet\ subfolder for the specific role you are installing:
    FolderServer role
    roles\api\dotNet\API
    roles\deployer\dotNet\Content Deployer
    roles\upload\dotNet\HTTP Upload
    roles\webservice\dotNet\dll\Content Delivery Web service
  6. Depending on the system architecture of your target system, go to the x86\ (x86 architecture) or x86_64\ (x64 architecture) subfolder.
  7. Copy all assemblies from this folder to the bin\ folder of your Web application.
  8. Navigate to the Content Delivery\ directory and access the java\ Java subfolder for the specific role you are installing:
    FolderServer role
    roles\api\java\API
    roles\deployer\java\Content Deployer
    roles\upload\java\HTTP Upload
    roles\webservice\java\Content Delivery Web service
  9. Access the lib\ subfolder and copy all the JAR files into the lib\ folder of your Web application.
  10. Access the third-party-lib\ subfolder and copy all the JAR files into the lib\ folder of your Web application.
  11. If you intend to use the Ambient Data Framework with this Server Role, and your lib folder does not yet contain cd_ambient.jar, copy this file from Content Delivery\roles\api\java\lib\ to your lib folder.
  12. If you store published content in a database, download the JDBC driver (JAR file) required for your specific database vendor and Java version, and copy it into the lib folder:
    Database vendorJDBC DriverFile to download when using Java 5File to download when using Java 6
    Microsoft SQL ServerMicrosoft SQL Server JDBC Driver 3.0sqljdbc.jarsqljdbc4.jar
    Oracle

    Oracle JDBC driver 11.2.0.2.0 or

    Oracle JDBC driver 11.2.0.1.0 (deprecated)

    ojdbc5.jarojdbc6.jar
    IBM DB2IBM Data Server Driver for JDBC and SQLJdb2jcc.jardb2jcc.jar
  13. Navigate to resources\configurations\.
  14. Copy logback.xml from that folder to the config folder.
  15. Check the JAR files in your Web application's lib subfolder that begin with cd_. You need to copy the corresponding configuration files to the config (.NET) or classes (Java) directory of your Web application and rename them as follows:
    JAR fileCorresponding configuration fileRenamed configuration file
    cd_ambient.jarcd_ambient_conf_sample.xmlcd_ambient_conf.xml
    cd_deployer.jarcd_deployer_conf_sample.xmlcd_deployer_conf.xml
    cd_datalayer.jarcd_storage_conf_sample.xmlcd_storage_conf.xml
    cd_dynamic.jarcd_dynamic_conf_sample.xmlcd_dynamic_conf.xml
    cd_linking.jarcd_link_conf_sample.xmlcd_link_conf.xml
    cd_monitor.jarcd_monitor_conf_sample.xmlcd_monitor_conf.xml
    cd_wai.jarcd_wai_conf_sample.xmlcd_wai_conf.xml
    cd_webservice.jarcd_webservice_conf_sample.xmlcd_webservice_conf.xml
  16. Open cd_ambient_conf.xml (if using) in a plain-text or XML editor.
  17. Find the <Security> section and enclose it in comments. This element is only needed if you intend to set up OAuth authentication.
  18. Save and close cd_ambient_conf.xml.
  19. Copy cd_licenses.xml, your Content Delivery license file available from SDL Tridion Customer Support, to the config (.NET) or classes (Java) 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.
  20. Configure logging.
  21. If your configuration files include a cd_storage_conf.xml, configure the Storage Layer and optionally encrypt sensitive strings.
  22. Open IIS Manager, navigate to Application Pools > DefaultAppPool and open the Properties window. Deselect Recycle worker process (in minutes) and all other recycle options, commit your changes and restart IIS.