Sitefinity ASP.NET Core Renderer and Sitefinity CMS are two decoupled applications that communicate via REST API calls. The communication is one-way, only the Renderer recognizes that there is an Sitefinity CMS instance and stores its URL in the appsettings.json file.
appsettings.json
When you have two applications working together, it is important to upgrade them in a way that you avoid downtime. Therefore, Sitefinity CMS is backward compatible with older versions of Sitefinity ASP.NET Core Renderer. This way, you can first upgrade the CMS application an afterwards – the Renderer. The newly upgraded CMS will continue running with the old Renderer, while you are upgrading it. This ensures that there is no downtime during the upgrade process.
IMPORTANT: Sitefinity CMS 14.4 is backward compatible with Sitefinity ASP.NET Core Renderer 14.0, 14.1. 14.2 and 14.3.
Only the built-in features of Sitefinity CMS are backward compatible. If you have any custom widgets or endpoints, you must ensure that they will continue to work with the old Sitefinity ASP.NET Core Renderer versions.
We recommended first upgrading Sitefinity CMS, and then the Sitefinity ASP.NET Core Renderer. When you start your upgrade process with the CMS and the Renderer running the same version, you should perform the following general steps:
With Sitefinity CMS 14.4, the following interfaces and classes for the Renderer are moved from Progress.Sitefinity.AspNetCore.Widgets.Models.Common to Progress.Sitefinity.AspNetCore.Models.Common namespace:
Progress.Sitefinity.AspNetCore.Widgets.Models.Common
Progress.Sitefinity.AspNetCore.Models.Common
IHasMargins
IHasPaddings
OffsetSize
OffsetStyleBase
If your project is created with a version prior to 14.4 and you are referring any of them, you must change namespace Progress.Sitefinity.AspNetCore.Widgets.Models.Common to Progress.Sitefinity.AspNetCore.Models.Common.
With Program.cs file style entry point, the following line of code is no longer required: app.UseEndpoints(endpoints => { endpoints.MapSitefinityEndpoints(); });
Program.cs
app.UseEndpoints(endpoints =>
{ endpoints.MapSitefinityEndpoints(); });
Output cache is no longer configured via Startup.cs.
Startup.cs
For more information, see Configure cache.
Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.
This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.
This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.
The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.
To submit feedback, please update your cookie settings and allow the usage of Functional cookies.
Your feedback about this content is important