Make Your Sitefinity Update Seamless (ProgressNEXT 2018)

Make Your Sitefinity Update Seamless Dev Guide & War Story
Denis Kyashif Software Engineer & Consultant June 1, 2018

affiliates. All rights reserved.  53% of users abandon sites that take longer than 3 seconds to load  22% will never return to the slow site  Page load time is factored into search engine results  The average page size ~ 3MB Infographic

affiliates. All rights reserved. What happens during an update?  Update assemblies and the references to them.  Update the configuration files, templates and front-end assets  Merge settings from the new version’s web.config file to your existing web.config.  Execute the database migrations.

affiliates. All rights reserved. Keep in mind  Before update - back up everything!  Clean all the error logs.  You must not manually change the Sitefinity version numbers stored in your configuration files.  Information about the Sitefinity version is stored both in the database and in the configuration files.  At any time, the configuration files must match your database scheme.

affiliates. All rights reserved. The Solution 1. Backup! 2. Edit the .csproj file to remove all the references to assemblies in bin\ 3. Delete the assemblies in bin\ 4. Add the Sitefinity Nuget Server as a package source 5. Install Telerik.Sitefinity.All – the version should match with the local Sitefinity version 6. When there’s a file conflict – Overwrite 7. Reload and Rebuild 8. Resolve the assembly binding errors (hope there won’t be any)

affiliates. All rights reserved. References  Documentation: https://docs.sitefinity.com/upgrade-a-project-that- has-nuget-packages  Migrate to NuGet Packages: https://www.newventuresoftware.com/blog/migrate-sitefinity- assembly-references-from-bin-to-nuget-packages  Resolve assembly binding errors: https://www.newventuresoftware.com/blog/resolving-sitefinity- assembly-binding-errors-after-upgrade

affiliates. All rights reserved. Keep in mind  Reduce the risk of introducing breaking changes by updating often.  Do not customize existing widget templates. Create your own instead.  Upgrade with NuGet

affiliates. All rights reserved. The Problem  10+ year old website  Over 300 pages  Unusable on mobile devices  Lots of custom code using legacy APIs  No unit tests & documentation  Needs to be merged with another 3.7 website with 2500+ pages  The content of a Wordpress blog needs to be imported into the new site  Needs to be updated to the latest version (9.1 at the time)

affiliates. All rights reserved. The Foundations  Implement Front-End build system with Gulp  Create Bootstrap-based common page layout templates  Identify similar pages and represent them as content items  Use MVC only rendering mode  Integrate OpenGraph and TwitterCard

affiliates. All rights reserved. URL Rewrites  The 3.7 websites’ page URLs were not semantic and didn’t follow the page structure.  Most of them were manually set thus impossible to map to the URLs in the new site.  The old URLs must lead to the same page on the new site.  ~3000 URLs in total

affiliates. All rights reserved. Removing the Noise <body> <h1>Bacon Ipsum</h1> <section class="content"> Cow kevin salami pork loin spare ribs meatloaf kielbasa strip steak. </section> <footer> Andouille porchetta drumstick capicola. </footer> </body>

affiliates. All rights reserved. The URL Mapping Procedure  Pick a page from the old website and scrape its HTML  Clean the data by removing HTML, CSS and JS code  Calculate Minimum Edit Distance with every page from the new site  Pick the one with the lowest score  Generate a rewrite rule

affiliates. All rights reserved. Community and Roadmap  plus.google.com/communities/101682685148530961591  sitefinity.com/developer-network/knowledge-base  knowledgebase.progress.com  sitefinity.com/timeline  sitefinityinsider.com  github.com/Sitefinity  newventuresoftware.com/blog

Make Your Sitefinity Update Seamless (ProgressNEXT 2018)

Make Your Sitefinity Update Seamless (ProgressNEXT 2018)

More Decks by Denis Kyashif

Other Decks in Programming

Featured

Transcript