diff --git a/phpBB/docs/INSTALL.html b/phpBB/docs/INSTALL.html index 2d97373721..657e0c29fb 100644 --- a/phpBB/docs/INSTALL.html +++ b/phpBB/docs/INSTALL.html @@ -269,11 +269,11 @@
The full package is normally meant for new installations only, but if you want to replace all source files, this package comes in handy.
+Updating using the full package is the recommended update method for boards without modifications to core phpBB files.
-First, you should make a copy of your existing config.php
file; keep it in a safe place! Next, delete all the existing phpBB files, you may want to leave your files/
, images/
and ext/
directories in place, otherwise you will lose your file attachments, uploaded images and get error due to missing extension files. You can leave alternative styles in place too. With this complete, you can upload the new phpBB files (see New installation for details if necessary). Once complete, copy back your saved config.php
, replacing the new one. Another method is to just replace the existing files with the files from the full package - though make sure you do not overwrite your config.php file.
First, you should make a copy of your existing config.php
file; keep it in a safe place! Next, delete all the existing phpBB files, you should leave your files/
, images/
and ext/
directories in place, otherwise you will lose your file attachments, uploaded images and get errors due to missing extension files. You can leave alternative styles in place too. With this complete, you can upload the new phpBB files (see New installation for details if necessary). Once complete, copy back your saved config.php
, replacing the new one. Another method is to just replace the existing files with the files from the full package - though make sure you do not overwrite your config.php file.
You should now got to /install/app.php/update
which will display a warning: No valid update directory was found, please make sure you uploaded the relevant files. Beneath that warning you will see a radion button Update database only, just click Submit. Depending on your previous version this will make a number of database changes. You may receive FAILURES during this procedure. They should not be a cause for concern unless you see an actual ERROR, in which case the script will stop (in this case you should seek help via our forums or bug tracker). If you have shell access to your server, you may wish to update via the command line interface. From your board's root, execute the following command: php bin/phpbbcli.php --safe-mode db:migrate
.
You should now got to /install/app.php/update
which will display a warning: No valid update directory was found, please make sure you uploaded the relevant files. Beneath that warning you will see a radio button Update database only, just click Submit. Depending on your previous version this will make a number of database changes. You may receive FAILURES during this procedure. They should not be a cause for concern unless you see an actual ERROR, in which case the script will stop (in this case you should seek help via our forums or bug tracker). If you have shell access to your server, you may wish to update via the command line interface. From your board's root, execute the following command: php bin/phpbbcli.php --safe-mode db:migrate
.
Once /install/app.php/update
has completed, it displays the success message: The database update was successful. You may proceed to the Administration Control Panel and then remove the install directory as advised.
This update method is the recommended method for updating. This package detects changed files automatically and merges in changes if needed.
+This update method is only recommended for installations with modifications to core phpBB files. This package detects changed files automatically and merges in changes if needed.
The automatic update package will update the board from a given version to the latest version. A number of automatic update files are available, and you should choose the one that corresponds to the version of the board that you are currently running. For example, if your current version is 3.2.0, you need the phpBB-3.2.0_to_3.2.1.zip/tar.bz2
file.
The recommended way of updating your installation listed here is only valid for the automatic update package. You are also able to update your installation using the methods listed within the INSTALL.html document. The steps for updating phpBB3 automatically are:
+The recommended way of updating your installation is using the full package. If core phpBB files have been modified in your installation you may wish to use the automatic update package in order to not lose these changes. You are also able to update your installation using the other methods listed within the INSTALL.html document. The steps for updating phpBB3 using the full package are:
+config.php
file, and the /images
, /store
and /files
folders from the package (not your site)./vendor
and /cache
folders from the board’s root folder on the host./ext
folder when uploading the new phpBB3 contents.)/install
folder from the root of your board installation.You now have a new up to date board containing all your users and posts. Follow up tasks:
Once uploaded your board will be offline for normal users due to the install directory you uploaded now present.
+
The automatic update package is only recommended in case core phpBB files have been modified in your installation. You are also able to update your installation using the methods listed within the INSTALL.html document. The steps for updating phpBB3 using the automatic update package are:
+ +Once uploaded your board will be offline for normal users due to the install directory you uploaded now being present.
Now start the update process by pointing your browser to the install folder.
You will then be guided through the update process. You will be notified once the update is complete.