From ce0234086ea98ab5c5bb015574206179df286857 Mon Sep 17 00:00:00 2001 From: kjac Date: Wed, 18 Dec 2024 14:23:47 +0100 Subject: [PATCH 1/2] Document opt-in for parallel content migration of block editors --- .../migrate-content-to-umbraco-15.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md index 2b03fbc5e2b..83cbdccd34b 100644 --- a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md +++ b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md @@ -13,6 +13,34 @@ You can track the progress of the migration in the logs. It is advised to [clean up old content versions](../../../../fundamentals/data/content-version-cleanup.md) before upgrading. This will make the migration run faster. +## Parallelizing the content migration + +It is possible to parallelize the content migration. This will significantly speed up the migration for large sites. + +For certain content structures, parallel content migration will fail. Therefore, parallel content migration is strictly opt-in. + +If parallel content migration fails, the database state will be rolled back to the last known good state. You can then disable parallel content migration, and try the migration again. + +To enable parallel content migration, add an `IComposer` implementation to configure the `ConvertBlockEditorPropertiesOptions` before initiating the upgrade process: + +```csharp +using Umbraco.Cms.Core.Composing; +using Umbraco.Cms.Infrastructure.Migrations.Upgrade.V_15_0_0; + +namespace UmbracoDocs.Samples; + +public class DisableBlockEditorMigrationComposer : IComposer +{ + [Obsolete] + public void Compose(IUmbracoBuilder builder) + => builder.Services.Configure(options => + { + // setting this to true will parallelize the migration of all Block Editors + options.ParallelizeMigration = true; + }); +} +``` + ## Opting out of the content migration It is strongly recommended to let the migration run as part of the upgrade. However, if you are upgrading to Umbraco versions 15, 16, or 17, you _can_ opt out of the migration. Your site will continue to work, albeit with a certain degree of performance degradation. From e0fec66d8212d7d00c66099cfe3ef4aaa306e8f1 Mon Sep 17 00:00:00 2001 From: kjac Date: Wed, 18 Dec 2024 14:30:33 +0100 Subject: [PATCH 2/2] Make the linter happy --- .../upgrading/version-specific/migrate-content-to-umbraco-15.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md index 83cbdccd34b..0992507869c 100644 --- a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md +++ b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md @@ -15,7 +15,7 @@ It is advised to [clean up old content versions](../../../../fundamentals/data/c ## Parallelizing the content migration -It is possible to parallelize the content migration. This will significantly speed up the migration for large sites. +It is possible to parallelize the content migration. This will speed up the migration for large sites. For certain content structures, parallel content migration will fail. Therefore, parallel content migration is strictly opt-in.