Upgrading from a previous version/de

Additional pages:{toc}

Bevor Sie anfangen...

...beachten Sie bitte folgendes: Nehmern Sie UNBEDINGT eine Sicherung der Dateien und der Datenbank ihrer aktuellen Installation vor!

Wenn Sie sich nicht sicher sind oder sich nicht mit der Materie auskennen empfehlen wir Ihnen die ComfortUpdate-Funktion zu verwenden.

The quick way (for minor version changes)

You can use these instructions if you are doing a minor upgrade  (for example from 2.00 to 2.01)

• Backup your files and database (did we already mention that?)
• Delete all the old files/directory except for
  • /application/config/config.php
  • /upload directory
• Copy the new files from the new LimeSurvey package to the existing location.
• After the upgrade: Clear your browser cache and cookies!

The thorough way (for big version jumps)

Unfortunately there are a couple of things to consider, so please scan the following instruction closely.

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

1. Download the latest version of LimeSurvey.
2. Prepare and backup the old installation
   1. Backup your installation directory files and SQL-based database just in case.
      1. 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.
      2. Using phpMyAdmin or similar to export all tables; or use the according Limesurvey Administration button to backup the entire database
   2. Copy your config.php file, modified template directories and the /upload directory separately for quick access later.
3. Replace all the installation directory files
   1. Delete all old files in the existing installation directory
   2. Upload and unpack the new code version into the same installation directory
   3. 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.
   4. Copy your /upload directory back to the old location
   5. Double check the permissions set on the directories (write access to /tmp, /upload and and their subdirectories is required) as described in Installation
   6. Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (you can use the old config.php as reference). The existing database will be automatically detected and , if necessary, upgraded after confirmation.
4. Check if any special manual checks apply as listed below
5. Now clear your browser cache and cookies!
6. You are done (:biggrin:).

Special checks after an upgrade:

• from any earlier version to 2.xx: The templates have been changed in a lot of places. Please check your customized templates if they are still looking right. If not you will have to edit your templates accordingly (check out the original templates to see what was changed). The upgrade process tries to replace the template.js inclusion by the placeholder {TEMPLATEJS}. If you have javascript issue with your custom template, verify if your template have the placeholder {TEMPLATEJS} in startpage.pstpl.
• from a version earlier than v1.53: When upgrading from a version before v1.53 to the latest version, please check the global user rights of each user. There was a new superadmin right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing who to give this right to in the older versions.  As this is not perfect, it should be carefully checked.

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

1. Download the desired version of LimeSurvey.
2. Prepare and backup the old installation
   1. Backup your installation directory files and SQL-based database just in case.
      1. At the command-line level, make a .zip or similar archive of the whole installation directory tree of files. e.g. tar cvzf foo.tgz cps100 will tar and zip the whole of the cps100 directory
      2. Using phpMyAdmin or similar to export all tables; or using the Limesurvey Administration button to backup the entire database
   2. Copy your config.php file ,modified template directories and the /upload directory separately for quick access later.
3. Replace all the installation directory files
   1. Delete all old files in the existing installation directory
   2. Upload and unpack the new code version into the same installation directory
   3. Edit or replace the config.php file:
      1. If your previous version was < 1.70: Edit the new config.php to reflect changed settings in the backup config.php file. Do not just overwrite the new config.php with your old one!
      2. If your previous version was >= 1.70: Simply replace the new config.php with your backup config.php (as the file format has not changed).
   4. 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.
   5. Copy your /upload directory back to the old location
   6. Double check the permissions set on the directories (write access to /tmp, /upload and and their subdirectories is required) as described in Installation
4. Finishing the installation
   1. Once you open the URL to your LimeSurvey administration the database tables will be updated after confirmation
   2. Remove or rename the /admin/install directory as/if instructed by the installation script
   3. Check if any special, manual checks apply as listed below
5. You are done (:biggrin:). If you notice any problems after the upgrade: Clear your browser cache and cookies!

Spezielle Prüfungen nach einem Update:

• Von Version 1.53/1.7x nach 1.9x: Die Templates haben sich stark geändert. Bitte überprüfen Sie Ihre angepassten Templates, ob diese immer noch korrekt funktionieren. Wenn nicht, dann müssen Sie diese anpassen (werden Sie einen Blick auf die Originaltemplates um zu sehen, was sich geändert hat).
  
• Von einer Version älter als v1.53: Nach dem Update überprüfen Sie bitte die globalen Benutzerrechte, da ein neues Superadmin-Recht eingeführt wurde und während des Updates versucht das Script zu schätzen, wer es bekommen sollte. Das ist nicht immer perfekt, daher sollten die Benutzerrechte nocheinmal geprüft werden.

Aktualisierung von einr Version äter als v1.50 (v1.0 bis 1.44)

Durch den Umstand, dass sich die komplette Datenstruktur und viele weitere kleine Dinge von Version 1.0 auf 1.50 geändert haben ist eine Aktualisierung NICHT möglich. Wenn Sie noch alte Umfragestruktur-Dateien mit einer *.sql Erweiterung besitzen, dann ist es nur möglich diese zu importieren, indem man https://sourceforge.net/projects/limesurvey/files/1._LimeSurvey_stable/Old%20versions%20up%20to%201.5/%7CVersion 1.50] installiert, diese dort import, und dann diese Version auf die aktuellste Version updated.

Update FAQ

Welches ist die aktuellste Version, die noch PHP4 unterstützt?

Die letzte Version, die PHP4 unterstützt, ist Version 1.82+

Kann ich auch updaten, wenn ich aktive Umfragen habe?

Ja, das ist möglich und bei kleineren Versionssprüngen im Regelfall unbedenklich. Sie sollten in jedem Fall Ihre Umfragen nach dem Update immer testen, vor allen Dingen wenn Sie ein angepasste Template (Design) nutzen.

What is best way to port LimeSurvey *.sql survey structure files to the latest version?

Install version 1.50, import the file and export the survey structure to the newer .csv format. The latest version still can read the .csv survey structure format.