Default shortcuts

Alexa widget

Facebook Login

Connect

Who's online

There are currently 0 users online.

Powered by Drupal

You are here

how to Update your Drupal site from one minor 7.x version to another minor 7.x version

<p>This document describes how to:<br />  <br />   * Update your Drupal site from one minor 7.x version to another minor 7.x<br />     version; for example, from 7.8 to 7.9, or from 7.6 to 7.10.<br />  <br />   * Upgrade your Drupal site's major version from 6.x to 7.x.<br />  <br /> First steps and definitions:<br />  <br />   * If you are upgrading to Drupal version x.y, then x is known as the major<br />     version number, and y is known as the minor version number. The download<br />     file will be named drupal-x.y.tar.gz (or drupal-x.y.zip).<br />  <br />   * All directories mentioned in this document are relative to the directory of<br />     your Drupal installation.<br />  <br />   * Make a full backup of all files, directories, and your database(s) before<br />     starting, and save it outside your Drupal installation directory.<br />     Instructions may be found at <a href="http://drupal.org/upgrade/backing-up-the-db">http://drupal.org/upgrade/backing-up-the-db</a><br />  <br />   * It is wise to try an update or upgrade on a test copy of your site before<br />     applying it to your live site. Even minor updates can cause your site's<br />     behavior to change.<br />  <br />  <br /> UPGRADE PROBLEMS<br /> ----------------<br /> If you encounter errors during this process,<br />  <br />   * Note any error messages you see.<br />  <br />   * Restore your site to its previous state, using the file and database backups<br />     you created before you started the upgrade process. Do not attempt to do<br />     further upgrades on a site that had update problems.<br />  <br />   * Consult one of the support options listed on <a href="http://drupal.org/support">http://drupal.org/support</a><br />  <br /> More in-depth information on upgrading can be found at <a href="http://drupal.org/upgrade">http://drupal.org/upgrade</a><br />  <br />  <br /> MINOR VERSION UPDATES<br /> ---------------------<br /> To update from one minor 7.x version of Drupal to any later 7.x version, after<br /> following the instructions in the INTRODUCTION section at the top of this file:<br />  <br /> 1. Log in as a user with the permission "Administer software updates".<br />  <br /> 2. Go to Administration &gt; Configuration &gt; Development &gt; Maintenance mode.<br />    Enable the "Put site into maintenance mode" checkbox and save the<br />    configuration.<br />  <br /> 3. Remove all old core files and directories, except for the 'sites' directory<br />    and any custom files you added elsewhere.<br />  <br />    If you made modifications to files like .htaccess or robots.txt, you will<br />    need to re-apply them from your backup, after the new files are in place.<br />  <br />    Sometimes an update includes changes to settings.php (this will be noted in<br />    the release announcement). If that's the case, replace your old settings.php<br />    with the new one, and copy the site-specific entries (especially the lines<br />    giving the database name, user, and password) from the old settings.php to<br />    the new settings.php.<br />  <br /> 4. Download the latest Drupal 7.x release from <a href="http://drupal.org">http://drupal.org</a> to a<br />    directory outside of your web root. Extract the archive and copy the files<br />    into your Drupal directory.<br />  <br />    On a typical Unix/Linux command line, use the following commands to download<br />    and extract:<br />  <br />      wget <a href="http://drupal.org/files/projects/drupal-x.y.tar.gz">http://drupal.org/files/projects/drupal-x.y.tar.gz</a><br />      tar -zxvf drupal-x.y.tar.gz<br />  <br />    This creates a new directory drupal-x.y/ containing all Drupal files and<br />    directories. Copy the files into your Drupal installation directory:<br />  <br />      cp -R drupal-x.y/* drupal-x.y/.htaccess /path/to/your/installation<br />  <br />    If you do not have command line access to your server, download the archive<br />    from <a href="http://drupal.org">http://drupal.org</a> using your web browser, extract it, and then use an<br />    FTP client to upload the files to your web root.<br />  <br /> 5. Re-apply any modifications to files such as .htaccess or robots.txt.<br />  <br /> 6. Run update.php by visiting <a href="http://www.example.com/update.php">http://www.example.com/update.php</a> (replace<br />    <a href="http://www.example.com">www.example.com</a> with your domain name). This will update the core database<br />    tables.<br />  <br />    If you are unable to access update.php do the following:<br />  <br />    - Open settings.php with a text editor.<br />  <br />    - Find the line that says:<br />      $update_free_access = FALSE;<br />  <br />    - Change it into:<br />      $update_free_access = TRUE;<br />  <br />    - Once the upgrade is done, $update_free_access must be reverted to FALSE.<br />  <br /> 7. Go to Administration &gt; Reports &gt; Status report. Verify that everything is<br />    working as expected.<br />  <br /> 8. Ensure that $update_free_access is FALSE in settings.php.<br />  <br /> 9. Go to Administration &gt; Configuration &gt; Development &gt; Maintenance mode.<br />    Disable the "Put site into maintenance mode" checkbox and save the<br />    configuration.<br />  <br />  <br /> MAJOR VERSION UPGRADE<br /> ---------------------<br /> To upgrade from a previous major version of Drupal to Drupal 7.x, after<br /> following the instructions in the INTRODUCTION section at the top of this file:<br />  <br /> 1. Check on the Drupal 7 status of your contributed and custom modules and<br />    themes. See <a href="http://drupal.org/node/948216">http://drupal.org/node/948216</a> for information on upgrading<br />    contributed modules and themes. See <a href="http://drupal.org/node/895314">http://drupal.org/node/895314</a> for a list<br />    of modules that have been moved into core for Drupal 7, and instructions on<br />    how to update them. See <a href="http://drupal.org/update/modules">http://drupal.org/update/modules</a> for information on<br />    how to update your custom modules, and <a href="http://drupal.org/update/theme">http://drupal.org/update/theme</a> for<br />    custom themes.<br />  <br />    You may decide at this point that you cannot upgrade your site, because<br />    needed modules or themes are not ready for Drupal 7.<br />  <br /> 2. Update to the latest available version of Drupal 6.x (if your current version<br />    is Drupal 5.x, you have to upgrade to 6.x first). If you need to update,<br />    download Drupal 6.x and follow the instructions in its UPGRADE.txt. This<br />    document only applies for upgrades from 6.x to 7.x.<br />  <br /> 3. Log in as user ID 1 (the site maintenance user).<br />  <br /> 4. Go to Administer &gt; Site configuration &gt; Site maintenance. Select<br />    "Off-line" and save the configuration.<br />  <br /> 5. Go to Administer &gt; Site building &gt; Themes. Enable "Garland" and select it as<br />    the default theme.<br />  <br /> 6. Go to Administer &gt; Site building &gt; Modules. Disable all modules that are not<br />    listed under "Core - required" or "Core - optional". It is possible that some<br />    modules cannot be disabled, because others depend on them. Repeat this step<br />    until all non-core modules are disabled.<br />  <br />    If you know that you will not re-enable some modules for Drupal 7.x and you<br />    no longer need their data, then you can uninstall them under the Uninstall<br />    tab after disabling them.<br />  <br /> 7. On the command line or in your FTP client, remove the file<br />  <br />      sites/default/default.settings.php<br />  <br /> 8. Remove all old core files and directories, except for the 'sites' directory<br />    and any custom files you added elsewhere.<br />  <br />    If you made modifications to files like .htaccess or robots.txt, you will<br />    need to re-apply them from your backup, after the new files are in place.<br />  <br /> 9. If you uninstalled any modules, remove them from the sites/all/modules and<br />    other sites/*/modules directories. Leave other modules in place, even though<br />    they are incompatible with Drupal 7.x.<br />  <br /> 10. Download the latest Drupal 7.x release from <a href="http://drupal.org">http://drupal.org</a> to a<br />    directory outside of your web root. Extract the archive and copy the files<br />    into your Drupal directory.<br />  <br />    On a typical Unix/Linux command line, use the following commands to download<br />    and extract:<br />  <br />      wget <a href="http://drupal.org/files/projects/drupal-x.y.tar.gz">http://drupal.org/files/projects/drupal-x.y.tar.gz</a><br />      tar -zxvf drupal-x.y.tar.gz<br />  <br />    This creates a new directory drupal-x.y/ containing all Drupal files and<br />    directories. Copy the files into your Drupal installation directory:<br />  <br />      cp -R drupal-x.y/* drupal-x.y/.htaccess /path/to/your/installation<br />  <br />    If you do not have command line access to your server, download the archive<br />    from <a href="http://drupal.org">http://drupal.org</a> using your web browser, extract it, and then use an<br />    FTP client to upload the files to your web root.<br />  <br /> 11. Re-apply any modifications to files such as .htaccess or robots.txt.<br />  <br /> 12. Make your settings.php file writeable, so that the update process can<br />    convert it to the format of Drupal 7.x. settings.php is usually located in<br />  <br />      sites/default/settings.php<br />  <br /> 13. Run update.php by visiting <a href="http://www.example.com/update.php">http://www.example.com/update.php</a> (replace<br />    <a href="http://www.example.com">www.example.com</a> with your domain name). This will update the core database<br />    tables.<br />  <br />    If you are unable to access update.php do the following:<br />  <br />    - Open settings.php with a text editor.<br />  <br />    - Find the line that says:<br />      $update_free_access = FALSE;<br />  <br />    - Change it into:<br />      $update_free_access = TRUE;<br />  <br />    - Once the upgrade is done, $update_free_access must be reverted to FALSE.<br />  <br /> 14. Backup your database after the core upgrade has run.<br />  <br /> 15. Replace and update your non-core modules and themes, following the<br />    procedures at <a href="http://drupal.org/node/948216">http://drupal.org/node/948216</a><br />  <br /> 16. Go to Administration &gt; Reports &gt; Status report. Verify that everything is<br />    working as expected.<br />  <br /> 17. Ensure that $update_free_access is FALSE in settings.php.<br />  <br /> 18. Go to Administration &gt; Configuration &gt; Development &gt; Maintenance mode.<br />    Disable the "Put site into maintenance mode" checkbox and save the<br />    configuration.<br />  <br /> To get started with Drupal 7 administration, visit<br /><a href="http://drupal.org/getting-started/7/admin">http://drupal.org/getting-started/7/admin</a></p>

Facebook Comment