diff --git a/documentation/content/en/chapters/upgrade_guide.xml b/documentation/content/en/chapters/upgrade_guide.xml
index fdaff09d..54807b32 100644
--- a/documentation/content/en/chapters/upgrade_guide.xml
+++ b/documentation/content/en/chapters/upgrade_guide.xml
@@ -264,15 +264,6 @@
For those comfortable using the patch utility, patch files are available.
-
- If you have previously abandoned an update attempt to try a different method, you will need to remove the following files from the server:
-
- store/install_config.php
- store/io_lock.lock
-
-
-
-
@@ -313,6 +304,14 @@
Update the database:
+
+ If you have previously attempted to update using a different method, you will need to remove the following files from the server before updating the database:
+
+ store/install_config.php
+ store/io_lock.lock
+
+
+
For large boards, you may wish to update via the command line instead of using a web browser. From your board's root, execute the following command: php ./bin/phpbbcli.php db:migrate --safe-mode
@@ -366,6 +365,14 @@
Upload the contents of the selected sub-archive
Update the database:
+
+ If you have previously attempted to update using a different method, you will need to remove the following files from the server before updating the database:
+
+ store/install_config.php
+ store/io_lock.lock
+
+
+
For large boards, you may wish to update via the command line instead of using a web browser. From your board's root, execute the following command: php ./bin/phpbbcli.php db:migrate --safe-mode
@@ -412,6 +419,14 @@
Upload the vendor/ directory
Run the updater:
+
+ If you have previously attempted to update using a different method, you will need to remove the following files from the server before updating the database:
+
+ store/install_config.php
+ store/io_lock.lock
+
+
+
For large boards, you may wish to update the database via the command line instead of using a web browser. From your board's root, execute the following command: php ./bin/phpbbcli.php db:migrate --safe-mode
@@ -469,6 +484,14 @@
Update the database:
+
+ If you have previously attempted to update using a different method, you will need to remove the following files from the server before updating the database:
+
+ store/install_config.php
+ store/io_lock.lock
+
+
+
For large boards, you may wish to update via the command line instead of using a web browser. From your board's root, execute the following command: php ./bin/phpbbcli.php db:migrate --safe-mode