Documentation Center

Installing policy files and .NET assemblies for .NET web applications compiled against old DLLs

If you have a .NET web application that was compiled against DLLs from an earlier release of this product, you need to copy policy files and new DLLs to your Windows assembly in order to resolve DLL versioning conflicts and in order for your .NET web application to keep working.

About this task

Use these policy files if you compiled against DLLs from any of the following products:
  • SDL Web 8.5
  • SDL Tridion Sites 9
  • SDL Tridion Sites 9.1
There are policy files for the following .NET libraries and APIs:
  • Content Interaction Libraries (CILs)
  • Context CILs
  • Experience Optimization API
  • Audience Manager and Outbound E-mail

Procedure

  1. Access the Windows machine on which your .NET web application runs.
  2. To install policy files for CILs or Context CILs, from the Tridion Sites installation media folder Content Delivery\resources\policies\, copy the following files to the c:\Windows\assembly\ folder on your Windows machine:
    • If your web application compiled against SDL Web 8.5 DLLs, copy all files that start with policy.8.5.
    • If your web application compiled against SDL Tridion Sites 9 DLLs, copy all files that start with policy.9.0.
    • If your web application compiled against SDL Tridion Sites 9.1 DLLs, copy all files that start with policy.9.1.
  3. On the installation media, navigate to Content Delivery\roles\api\rest\dotnet\bin\ and copy the following files to the c:\Windows\assembly\ folder on your Windows machine:
    • Tridion.ContentDelivery.AmbientData.dll
    • Tridion.ContentDelivery.dll
  4. If your .NET web application contains the deprecated in-process API, also navigate to Content Delivery\roles\api\in-process\dotnet\bin\ and copy these files:
    • Tridion.ContentDelivery.AmbientData.Interop.dll
    • Tridion.ContentDelivery.Common.Interop.dll
    • Tridion.ContentDelivery.Configuration.dll
    • Tridion.ContentDelivery.Interop.dll
    • xmogrt.dll
  5. To install policy files for Experience Optimization, from the Tridion Sites installation media folder Content Delivery\roles\xo\resources\policies\, copy the following files to the c:\Windows\assembly\ folder on your Windows machine:
    • If your web application compiled against SDL Web 8.5 DLLs, copy all files that start with policy.8.5.
    • If your web application compiled against SDL Tridion Sites 9 DLLs, copy all files that start with policy.9.0.
    • If your web application compiled against SDL Tridion Sites 9.1 DLLs, copy all files that start with policy.9.1.
  6. On the installation media, navigate to Content Delivery\roles\xo\api\rest\dotnet\bin\ and copy Tridion.SmartTarget.dll to the c:\Windows\assembly\ folder on your Windows machine.
  7. If your .NET web application contains the deprecated in-process API, navigate to Content Delivery\roles\api\in-process\dotnet\bin\ and also copy Sdl.Tridion.SmartTarget.Interop.dll.
  8. To install policy files for Audience Manager and Outboud E-mail, from the Tridion Sites installation media folder Audience Manager\resources\publish policies\, copy the following files to the c:\Windows\assembly\ folder on your Windows machine:
    • If your web application compiled against SDL Web 8.5 DLLs, copy all files that start with policy.8.5.
    • If your web application compiled against SDL Tridion Sites 9 DLLs, copy all files that start with policy.9.0.
    • If your web application compiled against SDL Tridion Sites 9.1 DLLs, copy all files that start with policy.9.1.
  9. On the installation media, navigate to Audience Manager\roles\api\rest\dotnet\bin\ and copy the following file to the c:\Windows\assembly\ folder on your Windows machine:
    • Tridion.OutboundEmail.ContentDelivery.dll
  10. On the installation media, navigate to Audience Manager\roles\in-process\dotnet\bin\ and copy the following file to the c:\Windows\assembly\ folder on your Windows machine:
    • Tridion.OutboundEmail.ContentDelivery.JuggerNetProxies.dll