Actions

Translations

Upgrading from a previous version/11/en: Difference between revisions

From LimeSurvey Manual

(Importing a new version from external source)
(Importing a new version from external source)
 
Line 1: Line 1:
==Upgrading from version 1.50 or later to any later 1.xx version==
==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Prepare and backup the old installation
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
** Backup your installation directory files and SQL-based database just in case
*** At the command-line level, make a '''.zip''' or similar archive of the whole installation directory tree of files. For example, in Linux 'tar cvzf foo.tgz cps100' will tar and zip the whole of the cps100 directory
*** Using [https://www.phpmyadmin.net phpMyAdmin] or similar to export all tables; or using the '''LimeSurvey Administration''' button [[File:button-export-sql.png]] to backup the entire database
** Copy your '''config.php''' file, modified '''template''' directories, and the /upload directory separately for quick access later
* Replace all the installation directory files
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Delete all old files in the existing installation directory

Latest revision as of 21:50, 19 March 2020

Message definition (Upgrading from a previous version)
==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

Upgrading from version 1.50 or later to any later 1.xx version

  • Download the desired version of LimeSurvey
  • Backup your files and database (did we already mention that?).
  • Replace all the installation directory files
    • Delete all old files in the existing installation directory
    • Upload and unpack the new code version into the same installation directory
    • Edit or replace the config.php file:
      • If your previous version was < 1.70: Edit the new config.php in order to reflect the changes from the backup config.php file. Do not just overwrite the new config.php with your old one!
      • If your previous version was >= 1.70: Simply replace the new config.php with your backup config.php file (as the file format has not changed)
    • If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
    • Copy your /upload directory back to the old location
    • Double-check the permissions set on the directories of LimeSurvey (write access to /tmp, /upload, and to their subdirectories is required) as described in the installation wiki
  • Finish the installation/upgrade process
    • Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
    • Remove or rename the /admin/install directory as/if instructed by the installation script
    • Check if any special manual checks apply (as listed below)