Commit d630744c authored by jhodgdon's avatar jhodgdon

Issue #1817020 by paulh: Remove information about using upgrade.php to do...

Issue #1817020 by paulh: Remove information about using upgrade.php to do major version upgrades from UPGRADE.txt
parent 9d3a2280
......@@ -5,7 +5,7 @@ This document describes how to:
* Update your Drupal site from one minor 8.x version to another minor 8.x
version; for example, from 8.8 to 8.9, or from 8.6 to 8.10.
* Upgrade your Drupal site's major version from 7.x to 8.x.
* Migrate your Drupal site to version 8.x.
First steps and definitions:
......@@ -121,118 +121,10 @@ following the instructions in the INTRODUCTION section at the top of this file:
Disable the "Put site into maintenance mode" checkbox and save the
configuration.
MAJOR VERSION UPGRADE
---------------------
To upgrade from a previous major version of Drupal to Drupal 8.x, after
following the instructions in the INTRODUCTION section at the top of this file:
1. Check on the Drupal 8 status of your contributed and custom modules and
themes. See http://drupal.org/node/948216 for information on upgrading
contributed modules and themes. See http://drupal.org/node/895314 for a list
of modules that have been moved into core for Drupal 8, and instructions on
how to update them. See http://drupal.org/update/modules for information on
how to update your custom modules, and http://drupal.org/update/theme for
custom themes.
You may decide at this point that you cannot upgrade your site because
needed modules or themes are not ready for Drupal 8
2. Update to the latest available version of Drupal 7.x (if your current version
is Drupal 6.x, you have to upgrade to 7.x first). If you need to update,
download Drupal 7.x and follow the instructions in its UPGRADE.txt. This
document only applies for upgrades from 7.x to 8.x.
3. In addition to updating to the latest available version of Drupal 7.x core,
you must also upgrade all of your contributed modules for Drupal to their
latest Drupal 7.x versions.
4. Log in as user ID 1 (the site maintenance user).
5. Go to Administer > Site configuration > Site maintenance. Select
"Off-line" and save the configuration.
6. Go to Administer > Site building > Themes. Enable "Bartik" and select it as
the default theme.
7. Go to Administer > Site building > Modules. Disable all modules that are not
listed under "Core - required" or "Core - optional". It is possible that some
modules cannot be disabled because others depend on them. Repeat this step
until all non-core modules are disabled.
If you know that you will not re-enable some modules for Drupal 8.x and you
no longer need their data, then you can uninstall them under the Uninstall
tab after disabling them.
8. On the command line or in your FTP client, remove the file
sites/default/default.settings.php
9. Remove all old core files and directories, except for the 'sites' directory
and any custom files you added elsewhere.
If you made modifications to files like .htaccess or robots.txt, you will
need to re-apply them from your backup, after the new files are in place.
10. If you uninstalled any modules, remove them from the /modules and other
sites/*/modules directories. Leave other modules in place, even though they
are incompatible with Drupal 8.x.
11. Download the latest Drupal 8.x release from http://drupal.org to a
directory outside of your web root. Extract the archive and copy the files
into your Drupal directory.
On a typical Unix/Linux command line, use the following commands to download
and extract:
wget http://drupal.org/files/projects/drupal-x.y.tar.gz
tar -zxvf drupal-x.y.tar.gz
This creates a new directory drupal-x.y/ containing all Drupal files and
directories. Copy the files into your Drupal installation directory:
cp -R drupal-x.y/* drupal-x.y/.htaccess /path/to/your/installation
If you do not have command line access to your server, download the archive
from http://drupal.org using your web browser, extract it, and then use an
FTP client to upload the files to your web root.
12. Re-apply any modifications to files such as .htaccess or robots.txt.
13. Make your settings.php file writeable, so that the update process can
convert it to the format of Drupal 8.x. settings.php is usually located in
sites/default/settings.php
14. Run update.php by visiting http://www.example.com/core/update.php (replace
www.example.com with your domain name). This will update the core database
tables.
If you are unable to access update.php do the following:
- Open settings.php with a text editor.
- Find the line that says:
$settings['update_free_access'] = FALSE;
- Change it into:
$settings['update_free_access'] = TRUE;
- Once the upgrade is done, $settings['update_free_access'] must be
reverted to FALSE.
15. Backup your database after the core upgrade has run.
16. Replace and update your non-core modules and themes, following the
procedures at http://drupal.org/node/948216
17. Go to Administration > Reports > Status report. Verify that everything is
working as expected.
18. Ensure that $settings['update_free_access'] is FALSE in settings.php.
19. Go to Administration > Configuration > Development > Maintenance mode.
Disable the "Put site into maintenance mode" checkbox and save the
configuration.
MAJOR VERSION MIGRATION
-----------------------
Upgrading from a prior major version of Drupal to Drupal 8.x is not possible.
The process now requires a migration to a Drupal 8.x site, utilizing the Migrate
module in Drupal core.
To get started with Drupal 8 administration, visit
http://drupal.org/getting-started/7/admin
Note that migration support in Drupal 8 is currently only partially implemented.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment