diff options
| author | Marc Alexander <admin@m-a-styles.de> | 2018-02-28 21:21:24 +0100 |
|---|---|---|
| committer | Marc Alexander <admin@m-a-styles.de> | 2018-02-28 21:21:24 +0100 |
| commit | 17c3bf0b39210f3c7519d4e652e431dbe38151d5 (patch) | |
| tree | 7f8c1a53dc3fee92e97cb209829f3c866570b35a | |
| parent | 5cdefdde2e1dc7083b643e11217335df15043f6d (diff) | |
| parent | 9474d6d50e7e2fd00a527f7e5b27aba1ef31cb85 (diff) | |
| download | forums-17c3bf0b39210f3c7519d4e652e431dbe38151d5.tar forums-17c3bf0b39210f3c7519d4e652e431dbe38151d5.tar.gz forums-17c3bf0b39210f3c7519d4e652e431dbe38151d5.tar.bz2 forums-17c3bf0b39210f3c7519d4e652e431dbe38151d5.tar.xz forums-17c3bf0b39210f3c7519d4e652e431dbe38151d5.zip | |
Merge pull request #5147 from marc1706/ticket/15569
[ticket/15569] Suggest using file replacing instead of automatic updater
| -rw-r--r-- | phpBB/docs/INSTALL.html | 8 | ||||
| -rw-r--r-- | phpBB/language/en/install.php | 37 |
2 files changed, 34 insertions, 11 deletions
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 @@ <a name="update_full"></a><h3>4.i. Full package</h3> - <p>The full package is normally meant for new installations only, but if you want to replace all source files, this package comes in handy.</p> + <p>Updating using the full package is the recommended update method for boards without modifications to core phpBB files.</p> - <p>First, you should make a copy of your existing <code>config.php</code> file; keep it in a safe place! Next, delete all the existing phpBB files, you may want to leave your <code>files/</code>, <code>images/</code> and <code>ext/</code> 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 <a href="#install">New installation</a> for details if necessary). Once complete, copy back your saved <code>config.php</code>, replacing the new one. Another method is to just <strong>replace</strong> the existing files with the files from the full package - though make sure you do <strong>not</strong> overwrite your config.php file.</p> + <p>First, you should make a copy of your existing <code>config.php</code> file; keep it in a safe place! Next, delete all the existing phpBB files, you should leave your <code>files/</code>, <code>images/</code> and <code>ext/</code> 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 <a href="#install">New installation</a> for details if necessary). Once complete, copy back your saved <code>config.php</code>, replacing the new one. Another method is to just <strong>replace</strong> the existing files with the files from the full package - though make sure you do <strong>not</strong> overwrite your config.php file.</p> - <p>You should now got to <code>/install/app.php/update</code> which will display a warning: <strong>No valid update directory was found, please make sure you uploaded the relevant files</strong>. Beneath that warning you will see a radion button <em>Update database only</em>, just click <strong>Submit</strong>. Depending on your previous version this will make a number of database changes. You may receive <em>FAILURES</em> during this procedure. They should not be a cause for concern unless you see an actual <em>ERROR</em>, 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: <code>php bin/phpbbcli.php --safe-mode db:migrate</code>.</p> + <p>You should now got to <code>/install/app.php/update</code> which will display a warning: <strong>No valid update directory was found, please make sure you uploaded the relevant files</strong>. Beneath that warning you will see a radio button <em>Update database only</em>, just click <strong>Submit</strong>. Depending on your previous version this will make a number of database changes. You may receive <em>FAILURES</em> during this procedure. They should not be a cause for concern unless you see an actual <em>ERROR</em>, 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: <code>php bin/phpbbcli.php --safe-mode db:migrate</code>.</p> <p>Once <code>/install/app.php/update</code> has completed, it displays the success message: <strong>The database update was successful</strong>. You may proceed to the Administration Control Panel and then remove the install directory as advised.</p> @@ -301,7 +301,7 @@ <a name="update_auto"></a><h3>4.iv. Automatic update package</h3> - <p>This update method is the recommended method for updating. This package detects changed files automatically and merges in changes if needed.</p> + <p>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.</p> <p>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 <strong>3.2.0</strong>, you need the <code>phpBB-3.2.0_to_3.2.1.zip/tar.bz2</code> file.</p> diff --git a/phpBB/language/en/install.php b/phpBB/language/en/install.php index af18339136..9bceeccde7 100644 --- a/phpBB/language/en/install.php +++ b/phpBB/language/en/install.php @@ -355,17 +355,40 @@ $lang = array_merge($lang, array( <br /> + <h1>How to update your installation with the Full Package</h1> + + <p>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:</p> + + <ol style="margin-left: 20px; font-size: 1.1em;"> + <li><strong class="error">Backup all board files and the database.</strong></li> + <li>Go to the <a href="https://www.phpbb.com/downloads/" title="https://www.phpbb.com/downloads/">phpBB.com downloads page</a> and download the latest "Full Package" archive.</li> + <li>Unpack the archive.</li> + <li>Remove (delete) the <code class="inline">config.php</code> file, and the <code class="inline">/images</code>, <code class="inline">/store</code> and <code class="inline">/files</code> folders <em>from the package</em> (not your site).</li> + <li>Go to the ACP, Board settings, and make sure prosilver is set as the default style. If not, set it to prosilver.</li> + <li>Delete the <code class="inline">/vendor</code> and <code class="inline">/cache</code> folders from the board’s root folder on the host.</li> + <li>Via FTP or SSH upload the remaining files and folders (that is, the remaining CONTENTS of the phpBB3 folder) to the root folder of your board installation on the server, overwriting the existing files. (Note: take care not to delete any extensions in your <code class="inline">/ext</code> folder when uploading the new phpBB3 contents.)</li> + <li><strong><a href="%1$s" title="%1$s">Now start the update process by pointing your browser to the install folder</a>.</strong></li> + <li>Follow the steps to update the database and let that run to completion.</li> + <li>Via FTP or SSH delete the <code class="inline">/install</code> folder from the root of your board installation.<br><br></li> + </ol> + + <p>You now have a new up to date board containing all your users and posts. Follow up tasks:</p> + <ul style="margin-left: 20px; font-size: 1.1em;"> + <li>Update your language pack</li> + <li>Update your style<br><br></li> + </ul> + <h1>How to update your installation with the Automatic Update Package</h1> - <p>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:</p> + <p>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:</p> - <ul style="margin-left: 20px; font-size: 1.1em;"> - <li>Go to the <a href="https://www.phpbb.com/downloads/" title="https://www.phpbb.com/downloads/">phpBB.com downloads page</a> and download the "Automatic Update Package" archive.<br /><br /></li> - <li>Unpack the archive.<br /><br /></li> - <li>Upload the complete uncompressed "install" and "vendor" folders to your phpBB root directory (where your config.php file is).<br /><br /></li> - </ul> + <ol style="margin-left: 20px; font-size: 1.1em;"> + <li>Go to the <a href="https://www.phpbb.com/downloads/" title="https://www.phpbb.com/downloads/">phpBB.com downloads page</a> and download the "Automatic Update Package" archive.</li> + <li>Unpack the archive.</li> + <li>Upload the complete uncompressed "install" and "vendor" folders to your phpBB root directory (where your config.php file is).<br><br></li> + </ol> - <p>Once uploaded your board will be offline for normal users due to the install directory you uploaded now present.<br /><br /> + <p>Once uploaded your board will be offline for normal users due to the install directory you uploaded now being present.<br /><br /> <strong><a href="%1$s" title="%1$s">Now start the update process by pointing your browser to the install folder</a>.</strong><br /> <br /> You will then be guided through the update process. You will be notified once the update is complete. |