Kinematic Digital | Digital Transformation & Engineering

Understanding Sitecore 10.4: What's New

Sitecore 10.4 represents a significant milestone in the platform's evolution, introducing enhanced performance, improved security features, and better integration capabilities. Before embarking on your upgrade journey, it's crucial to understand the new features and requirements that come with this version.

The latest release includes support for .NET 8, improved XM Cloud capabilities, enhanced personalization features, and significant performance optimizations that can reduce page load times by up to 40%.

Pre-Upgrade Requirements and Checklist

Before beginning your Sitecore 10.4 upgrade, ensure you meet the following requirements:

System Requirements: Windows Server 2019 or later, SQL Server 2019 or later, .NET 8 SDK installed
Current Version: Upgrading directly to 10.4 is supported from versions 10.0 and above. Earlier versions require intermediate upgrades
Database Backup: Complete backup of all Sitecore databases (Master, Web, Core, and custom databases)
License File: Ensure your license file supports Sitecore 10.4
Custom Code Audit: Review all custom modules, renderings, and integrations for compatibility
Environment Preparation: Set up a clean development and staging environment for testing

Step 1: Environment Preparation

Begin by creating a clean environment that mirrors your production setup:

Install Prerequisites: Install IIS with required features, .NET 8 Runtime, and SQL Server 2019+
Download Sitecore 10.4: Obtain the installation package from the Sitecore Developer Portal
Backup Everything: Create complete backups of databases, configuration files, and custom code
Document Current Configuration: Note all connection strings, API keys, and custom settings

Step 2: Database Upgrade Process

The database upgrade is critical and should be performed carefully:

Restore Databases: Restore your backed-up databases to the new SQL Server instance
Run Update Scripts: Execute the Sitecore-provided SQL update scripts in the correct order (Core → Master → Web → Custom)
Verify Schema Changes: Compare database schemas to ensure all changes were applied successfully
Update Connection Strings: Modify connection strings in configuration files to point to upgraded databases

Database Upgrade Script Order

Always run database upgrade scripts in this specific order:

Sitecore.Core.sql
Sitecore.Master.sql
Sitecore.Web.sql
Sitecore.Marketing.sql (if using xDB)
Sitecore.Processing.sql (if using xDB)

Step 3: Application Code Migration

Upgrading your Sitecore application code requires careful attention to breaking changes:

Configuration File Updates

Sitecore 10.4 introduces new configuration patterns and deprecates some older settings:

Review and update all custom .config files in App_Config/Include folder
Migrate from legacy configuration to the new configuration layer model
Update Solr or Azure Search configuration for new schema requirements
Verify all connection strings use the updated format

Breaking Changes to Address

Key breaking changes in Sitecore 10.4 that require code modifications:

API Changes: Several deprecated APIs have been removed. Use the migration guide to find replacements
Pipeline Updates: Some pipeline processors have new signatures or have been moved
Item Provider Changes: Custom item providers need to implement new interfaces
Security Updates: Updated authentication mechanisms require code changes in custom login implementations

Step 4: Search Index Configuration

Search configuration has evolved significantly in Sitecore 10.4:

Update Solr Cores: If using Solr, upgrade cores to the latest schema version
Rebuild Indexes: Perform a full rebuild of all search indexes after upgrade
Test Search Functionality: Thoroughly test all search-dependent features
Optimize Performance: Review and optimize index configuration for better performance

Step 5: Module and Integration Updates

Third-party modules and custom integrations often require updates:

Review Sitecore Marketplace for updated module versions compatible with 10.4
Test all custom modules in the development environment
Update NuGet packages to versions compatible with .NET 8
Verify all API integrations continue to function correctly
Update Sitecore PowerShell Extensions (SPE) to the latest compatible version

Step 6: Content Migration and Validation

After technical upgrades, validate your content:

Verify Item Integrity: Check that all items migrated successfully
Test Renderings: Verify all page components render correctly
Validate Links: Run link validation to ensure no broken internal links
Check Media Library: Verify all media items are accessible and display correctly
Test Workflows: Ensure custom workflows function as expected

Step 7: Performance Optimization

Sitecore 10.4 offers new performance optimization opportunities:

Enable New Caching Features: Configure the enhanced HTML cache settings
Optimize Database Queries: Review and optimize slow queries identified in logs
Configure CDN: Set up or update CDN configuration for static assets
Review Application Pools: Adjust IIS application pool settings for optimal performance
Enable Output Caching: Configure output caching for frequently accessed pages

Step 8: Security Hardening

Apply Sitecore 10.4 security best practices:

Update admin credentials and enforce strong password policies
Configure HTTPS and SSL certificates
Review and update CORS policies
Enable security headers (CSP, X-Frame-Options, etc.)
Configure IP restrictions for admin areas
Enable two-factor authentication for admin accounts

Testing and Quality Assurance

Comprehensive testing is essential before production deployment:

Functional Testing

Test all critical user journeys
Verify form submissions and data capture
Test personalization rules and A/B tests
Validate e-commerce functionality (if applicable)
Test all third-party integrations

Performance Testing

Conduct load testing to ensure performance under typical traffic
Test response times for key pages
Monitor database performance and query execution
Verify caching is working effectively

UAT (User Acceptance Testing)

Involve content editors to test the Experience Editor
Verify all admin interfaces function correctly
Test content publishing workflows
Validate reporting and analytics functionality

Step 9: Production Deployment

Plan your production deployment carefully:

Deployment Window: Schedule during low-traffic periods
Rollback Plan: Prepare detailed rollback procedures
Communication: Notify stakeholders of deployment schedule and potential downtime
Monitoring: Set up enhanced monitoring for the deployment period
Deployment Checklist: Follow a detailed checklist to ensure nothing is missed

Deployment Steps

Enable maintenance mode
Backup production databases and files
Stop IIS application pools
Deploy upgraded databases
Deploy application files
Update configuration files with production settings
Clear all caches
Rebuild search indexes
Start application pools
Smoke test critical functionality
Disable maintenance mode
Monitor application health

Post-Upgrade Monitoring

After go-live, intensive monitoring is crucial:

Error Logs: Monitor Sitecore logs for any errors or warnings
Performance Metrics: Track response times, server resources, and database performance
User Feedback: Collect feedback from content editors and end users
Analytics: Monitor traffic patterns and user behavior for anomalies
Health Checks: Perform regular health checks using Sitecore's built-in tools

Common Issues and Troubleshooting

Issue: Publishing Fails After Upgrade

Solution: Clear the event queue, rebuild the link database, and verify publish configurations are correct for Sitecore 10.4.

Issue: Slow Page Load Times

Solution: Review cache configuration, optimize database queries, and ensure indexes are rebuilt and optimized.

Issue: Experience Editor Not Loading

Solution: Verify JavaScript files are loading correctly, check browser console for errors, and ensure all renderings are updated for the new version.

Issue: Authentication Failures

Solution: Update authentication configuration files, verify connection to membership provider, and check identity server settings.

Sitecore 10.4 Upgrade Cost Considerations

Understanding the cost implications of upgrading to Sitecore 10.4:

Licensing: Verify your license covers Sitecore 10.4 or budget for license upgrade
Development Time: Plan for 4-8 weeks for a typical upgrade, depending on customization complexity
Testing Resources: Budget for comprehensive QA and UAT
Infrastructure: May require server upgrades to meet new system requirements
Training: Invest in training for new features and updated workflows

Best Practices for Sitecore 10.4

Adopt Helix Principles: Organize code following Sitecore Helix guidelines for better maintainability
Use SXA (Sitecore Experience Accelerator): Leverage SXA for faster site building and better maintainability
Implement Continuous Integration: Set up CI/CD pipelines for automated deployments
Regular Updates: Stay current with Sitecore patches and security updates
Performance Monitoring: Implement Application Insights or similar tools for ongoing monitoring

Conclusion

Upgrading to Sitecore 10.4 is a significant undertaking that requires careful planning, thorough testing, and attention to detail. By following this comprehensive guide, you can minimize risks and ensure a smooth transition to the latest version.

The benefits of Sitecore 10.4—including improved performance, enhanced security, and new features—make the upgrade worthwhile for organizations looking to maintain a competitive edge in their digital experience delivery.

Remember to allocate sufficient time for planning, testing, and training. Engage with Sitecore implementation partners if you need expertise or additional resources to ensure a successful upgrade.

Need Help with Your Sitecore 10.4 Upgrade?

Kinematic Digital specializes in Sitecore implementations and upgrades. Our team of certified Sitecore developers can help you plan, execute, and optimize your Sitecore 10.4 upgrade with minimal disruption to your business operations.

Sitecore 10.4 Upgrade Guide: Step-by-Step Migration Process