Content Delivery Role upgrade reference for upgrades from SDL Tridion 2013 SP1 HR1
As of SDL Web 8, you set up Content Delivery server-side software components as a set of microservices, with which you interact using client-side APIs and Web application extensions. The preferred upgrade plan (and the only option if you use .NET) is to replace all your existing Content Delivery Web applications with standalone microservices. You also always need to install a new Role (microservice): the Discovery Service. On the client side, an upgrade means continuing to use the deprecated in-process API.
Upgrading your Java/JSP Web application-based Content Delivery
If you currently run all your Content Delivery software as Java/JSP Web applications (and Windows services or Java processes), you can continue to use your in-process API Server Role and turn your server-side Java/JSP Web applications into standalone microservices.
| Current software component | Tasks to perform |
|---|---|
| API | Update the resources of this software component (now known as API (in-process), a legacy Role) |
| Cache Channel Service | Uninstall this Role and reinstall it as a standalone microservice |
| Content Delivery Web service | Uninstall this Role and reinstall it as a standalone microservice called the Content Service |
| Content Deployer (HTTP or HTTPS) | Uninstall this Role and install two standalone microservices: the Content Deployer endpoint and the Content Deployer worker. |
| Monitoring Agent | Uninstall this Role and reinstall it as a standalone microservice |
| Monitoring Agent Web service | Uninstall this Role and reinstall it as a standalone microservice |
| Session Preview Web service | Uninstall this Role and reinstall it as a standalone microservice called the Preview Service |
| Session Preview Web extension | Update the resources of this Role, which is now known as Preview Web extension |
| UGC Community Service | Uninstall this Role and reinstall it as a standalone microservice |
| UGC Moderation Service | Uninstall this Role and reinstall it as a standalone microservice |
| UGC Content Deployer extension | Update the resources of this Role |
| UGC Web site extension | Update the resources of this Role |
| Context Engine service | Uninstall this Role and reinstall it as a standalone microservice |
| Context Engine Web application extension | Update the resources of this Role |
While the possibility to run microservices inside a Java/JSP Web application does exist, this kind of implementation is actively discouraged and not available in the product deliverable itself. If you do select this option, your Web application-based microservice must be a separate Web application from your own, and from a Web application that contains Content Delivery API/client software.
Upgrading your .NET Web application-based Content Delivery
| Current Server Role software component | Tasks to perform |
|---|---|
| API | Update the resources of this Role. Your API Server Role is now the legacy API (in-process) Role. |
| Cache Channel Service | Uninstall this Role and reinstall it as a standalone microservice |
| Content Delivery Web service | Uninstall this Role and install the new Content Service Role as a standalone microservice. If you want, use a reverse proxy to make your .NET Web application redirect to it. |
| Content Deployer (HTTP or HTTPS) | Uninstall this Role and reinstall it as a standalone microservice. If you want, use a reverse proxy to make your .NET Web application redirect to it. |
| Monitoring Agent | Uninstall this Role and reinstall it as a standalone microservice |
| Monitoring Agent Web service | Update the resources of this Role |
| Session Preview Web service | Uninstall this Role and reinstall it as the standalone Preview Service microservice. If you want, use a reverse proxy to make your .NET Web application redirect to it. |
| Session Preview Web extension | Update the resources of this Role, which is now called the Preview Web extension. |
| UGC Community Service | Uninstall this Role and reinstall it as a standalone microservice. If you want, use a reverse proxy to make your .NET Web application redirect to it. |
| UGC Moderation Service | Uninstall this Role and reinstall it as a standalone microservice. If you want, use a reverse proxy to make your .NET Web application redirect to it. |
| UGC Content Deployer extension | Update the resources of this Role |
| UGC Web site extension | Update the resources of this Role |
| Context Engine service | Uninstall this Role and reinstall it as a standalone microservice |
| Context Engine Web application extension | Update the resources of this Role |