You are on page 1of 4

INTRODUCTION -----------This document describes how to: * Update your Drupal site from one minor 7.

x version to another minor 7.x version; for example, from 7.8 to 7.9, or from 7.6 to 7.10. * Upgrade your Drupal site's major version from 6.x to 7.x. First steps and definitions: * If you are upgrading to Drupal version x.y, then x is known as the major version number, and y is known as the minor version number. The download file will be named drupal-x.y.tar.gz (or drupal-x.y.zip). * All directories mentioned in this document are relative to the directory of your Drupal installation. * Make a full backup of all files, directories, and your database(s) before starting, and save it outside your Drupal installation directory. Instructions may be found at http://drupal.org/upgrade/backing-up-the-db * It is wise to try an update or upgrade on a test copy of your site before applying it to your live site. Even minor updates can cause your site's behavior to change. UPGRADE PROBLEMS ---------------If you encounter errors during this process, * Note any error messages you see. * Restore your site to its previous state, using the file and database backups you created before you started the upgrade process. Do not attempt to do further upgrades on a site that had update problems. * Consult one of the support options listed on http://drupal.org/support More in-depth information on upgrading can be found at http://drupal.org/upgrade MINOR VERSION UPDATES --------------------To update from one minor 7.x version of Drupal to any later 7.x version, after following the instructions in the INTRODUCTION section at the top of this file: 1. Log in as a user with the permission "Administer software updates". 2. Go to Administration > Configuration > Development > Maintenance mode. Enable the "Put site into maintenance mode" checkbox and save the configuration. 3. 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.

Find the line that says: $update_free_access = FALSE. replace your old settings.php. Go to Administration > Configuration > Development > Maintenance mode. Check on the Drupal 7 status of your contributed and custom modules and themes.x release from http://drupal.php to the new settings.com/update. and password) from the old settings.y/* drupal-x. On a typical Unix/Linux command line. Ensure that $update_free_access is FALSE in settings.php with the new one.x.y. Re-apply any modifications to files such as .org to a directory outside of your web root.y. 8. See http://drupal. 4.org/files/projects/drupal-x. Disable the "Put site into maintenance mode" checkbox and save the configuration. user. and copy the site-specific entries (especially the lines giving the database name.php (replace www. .y/.php. Copy the files into your Drupal installation directory: cp -R drupal-x.Open settings.tar.org/node/948216 for information on upgrading .tar.Change it into: $update_free_access = TRUE. If you are unable to access update.txt. . $update_free_access must be reverted to FALSE. Download the latest Drupal 7.gz This creates a new directory drupal-x. MAJOR VERSION UPGRADE --------------------To upgrade from a previous major version of Drupal to Drupal 7. 7. This will update the core database tables.php by visiting http://www.php do the following: .gz tar -zxvf drupal-x.php (this will be noted in the release announcement).htaccess or robots.example. 5.org using your web browser. Go to Administration > Reports > Status report. . Verify that everything is working as expected. If that's the case. 9. Run update. download the archive from http://drupal.com with your domain name). extract it.y/ containing all Drupal files and directories.example.Sometimes an update includes changes to settings. and then use an FTP client to upload the files to your web root.htaccess /path/to/your/installation If you do not have command line access to your server.php with a text editor. after following the instructions in the INTRODUCTION section at the top of this file: 1.Once the upgrade is done. Extract the archive and copy the files into your Drupal directory. use the following commands to download and extract: wget http://drupal. 6.

and instructions on how to update them.htaccess or robots.gz tar -zxvf drupal-x.x.htaccess /path/to/your/installation .required" or "Core . Go to Administer > Site building > Modules.php 8. 10.org/files/projects/drupal-x.tar.contributed modules and themes.org to a directory outside of your web root.x and follow the instructions in its UPGRADE.x (if your current version is Drupal 5. 4. If you uninstalled any modules. 7. On the command line or in your FTP client. See http://drupal. 2.y.org/update/theme for custom themes.y/ containing all Drupal files and directories.tar. If you made modifications to files like . Log in as user ID 1 (the site maintenance user). remove them from the sites/all/modules and other sites/*/modules directories. and http://drupal. 5. On a typical Unix/Linux command line.x release from http://drupal.txt. you have to upgrade to 6. If you need to update.x to 7. use the following commands to download and extract: wget http://drupal. 9. Download the latest Drupal 7. download Drupal 6.gz This creates a new directory drupal-x.y.org/update/modules for information on how to update your custom modules. See http://drupal. Copy the files into your Drupal installation directory: cp -R drupal-x. Go to Administer > Site building > Themes. It is possible that some modules cannot be disabled.y/.x.optional". Extract the archive and copy the files into your Drupal directory. Leave other modules in place.txt.org/node/895314 for a list of modules that have been moved into core for Drupal 7. even though they are incompatible with Drupal 7.x. Update to the latest available version of Drupal 6. You may decide at this point that you cannot upgrade your site. Repeat this step until all non-core modules are disabled. after the new files are in place. you will need to re-apply them from your backup. If you know that you will not re-enable some modules for Drupal 7.settings.x first).x and you no longer need their data. Enable "Garland" and select it as the default theme. Remove all old core files and directories.y/* drupal-x. Disable all modules that are not listed under "Core . except for the 'sites' directory and any custom files you added elsewhere. because needed modules or themes are not ready for Drupal 7. 6. then you can uninstall them under the Uninstall tab after disabling them. Select "Off-line" and save the configuration. because others depend on them. This document only applies for upgrades from 6. 3. remove the file sites/default/default. Go to Administer > Site configuration > Site maintenance.

Change it into: $update_free_access = TRUE.txt. .php file writeable. 14.htaccess or robots.php by visiting http://www.x.example. and then use an FTP client to upload the files to your web root. following the procedures at http://drupal. 15. . extract it. download the archive from http://drupal. Backup your database after the core upgrade has run.php do the following: . .php with a text editor. Replace and update your non-core modules and themes.php 13. Run update. If you are unable to access update. Ensure that $update_free_access is FALSE in settings.example. 11. 17.org using your web browser. 12.Find the line that says: $update_free_access = FALSE.com/update.If you do not have command line access to your server. Re-apply any modifications to files such as .php. $update_free_access must be reverted to FALSE.com with your domain name).Once the upgrade is done. Make your settings. so that the update process can convert it to the format of Drupal 7.php (replace www. 18. settings. This will update the core database tables. Disable the "Put site into maintenance mode" checkbox and save the configuration.Open settings.org/node/948216 16. To get started with Drupal 7 administration. Go to Administration > Reports > Status report. Verify that everything is working as expected. Go to Administration > Configuration > Development > Maintenance mode. visit http://drupal.org/getting-started/7/admin .php is usually located in sites/default/settings.