From a245d0c98fd3ccf0bc66c4efdd56024b51cfda6e Mon Sep 17 00:00:00 2001 From: bergice Date: Sat, 9 Feb 2019 05:19:25 +0100 Subject: [PATCH 1/4] Add file migration system requirements. See https://github.com/silverstripeltd/open-sourcerers/issues/45 for more information on how these estimates were obtained. --- .../14_Files/05_File_Migration.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md b/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md index 0fd19dc04..3530722b9 100644 --- a/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md +++ b/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md @@ -100,3 +100,16 @@ SilverStripe\Core\Injector\Injector: ``` You can also set this to `0` to disable the limit. + +## System Requirements + +The approach to running your file migration depends on your system and how many files you are migrating. + +Please use the following estimates to decide how you will run your file migration: + +| Number of files | Method | Expected Execution Time | Expected Memory Usage | +| --- | --- | --- | --- | +| < 150 | Web Request | 30 seconds | 6 MB | +| < 500 | Queued Job | 120 seconds | 8 MB | +| < 10000 | Command Line | 10000 seconds | 916 MB | +| 10000+ | Command Line or contact support | n/a | n/a | From 2e84e9a18fa5a2c12657df3452a6237e726312b6 Mon Sep 17 00:00:00 2001 From: Maxime Rainville Date: Wed, 13 Feb 2019 15:00:08 +0100 Subject: [PATCH 2/4] Round up expected memory usage Co-Authored-By: bergice --- docs/en/02_Developer_Guides/14_Files/05_File_Migration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md b/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md index 3530722b9..b0b793a8c 100644 --- a/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md +++ b/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md @@ -111,5 +111,5 @@ Please use the following estimates to decide how you will run your file migratio | --- | --- | --- | --- | | < 150 | Web Request | 30 seconds | 6 MB | | < 500 | Queued Job | 120 seconds | 8 MB | -| < 10000 | Command Line | 10000 seconds | 916 MB | +| < 10000 | Command Line | 10000 seconds | 950 MB | | 10000+ | Command Line or contact support | n/a | n/a | From 62e3a2f58210925600e046a0f98b7b84e71ff14f Mon Sep 17 00:00:00 2001 From: Maxime Rainville Date: Wed, 13 Feb 2019 15:01:04 +0100 Subject: [PATCH 3/4] "Approximate" makes it clearer the expected memory usage may vary Co-Authored-By: bergice --- docs/en/02_Developer_Guides/14_Files/05_File_Migration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md b/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md index b0b793a8c..d14372c49 100644 --- a/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md +++ b/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md @@ -107,7 +107,7 @@ The approach to running your file migration depends on your system and how many Please use the following estimates to decide how you will run your file migration: -| Number of files | Method | Expected Execution Time | Expected Memory Usage | +| Number of files | Method | Expected Execution Time | Approximate Memory Usage | | --- | --- | --- | --- | | < 150 | Web Request | 30 seconds | 6 MB | | < 500 | Queued Job | 120 seconds | 8 MB | From 5c5d8639c6602ab6e3d9107485495e2db05a93c4 Mon Sep 17 00:00:00 2001 From: Maxime Rainville Date: Thu, 14 Feb 2019 15:38:00 +1300 Subject: [PATCH 4/4] DOCS Encourage peopel to contact the CWP/SSP helpdesk if they need to run the migration from the CLI --- docs/en/02_Developer_Guides/14_Files/05_File_Migration.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md b/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md index d14372c49..57effd0a5 100644 --- a/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md +++ b/docs/en/02_Developer_Guides/14_Files/05_File_Migration.md @@ -105,7 +105,7 @@ You can also set this to `0` to disable the limit. The approach to running your file migration depends on your system and how many files you are migrating. -Please use the following estimates to decide how you will run your file migration: +Use the following estimates to decide how you will run your file migration: | Number of files | Method | Expected Execution Time | Approximate Memory Usage | | --- | --- | --- | --- | @@ -113,3 +113,5 @@ Please use the following estimates to decide how you will run your file migratio | < 500 | Queued Job | 120 seconds | 8 MB | | < 10000 | Command Line | 10000 seconds | 950 MB | | 10000+ | Command Line or contact support | n/a | n/a | + +Your exact experience will vary based on your host server, the size of your files and other conditions. If your site is hosted on a managed environement (e.g.: [Common Web Platform](https://www.cwp.govt.nz/service-desk) or [SilverStripe Platform](https://docs.platform.silverstripe.com/support/)), you may not have access to the command line to manually run the migration task. Contact your hosting provider's helpdesk if that's your case.