Upgrading from a previous version/nl

Andere pagina's:{toc}

Voordat je begint...

Maak altijd een back-up van je huidige installatie, de scripts en de database!!

Dit laatste kun je doen via een beheerapplicatie als phpMyAdmin. Heb je daar geen kaas van gegeten, overweeg dan iemand te vragen die dat wel heeft, of gebruik ComfortUpdate.

De snelle manier (voor kleine upgrades)

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.
• Open the admin page in your brower, e.g. https://www.example.com/limesurvey/admin and check if a database scheme upgrade is necessary.
• After the upgrade: Clear your browser cache and cookies!

De grondige manier (voor grote upgrades)

Daar zitten wat meer haken en ogen aan, dus lees het volgende zeer nauwkeurig.

Upgrading from version 2.0x to 2.50 or later

• Please note that the template structure has changed. Your old templates will not be working anymore as the template system is now using responsive templates.

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:).

  If you upgrade from e.g. 1.92, it might be necessary to first upgrade to latest 1.92, then to 2.00, then to 2.06, and then finally to the latest version (e.g. 2.55.x).

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.
  • Proper question codes are mandatory, now. After upgrade check the survey logic of all surveys and correct the codes where necessary.
• 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.
• from any earlier version to v2.06: From 2.05 to 2.06 some unused permissions when editing global permission for 'surveys' were activated. So if a user has any permission besides the 'create' they will be able to apply this additional permission on other surveys then their own. So please check the global permission of admin users that should only be able to see their own surveys and make sure they only have the 'create' permission assigned for 'surveys'.

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!

Handmatige controles na een upgrade

• upgrades naar 1.92 of later: de sjablonen zijn op veel plaatsen gewijzigd. Als je eigen sjablonen hebt, controleer dan of ze nog goed werken.
• upgrades vanaf 1.53 of eerder: controleer of de global user rights van elke gebruiker nog kloppen. Er is een nieuwe superbeheerder gekomen, die een gebruiker dezelfde rechten geeft als diegene die de installatie draait. Het upgradescript probeert te raden wie dit is, maar dit gaat niet altijd goed.

Upgrade van een versie voor 1.50 (v1.0 tot v1.44)

Omdat de datastructuur en een hoop andere dingen flink gewijzigd zijn is een upgrade van een versie voor 1.50 NIET mogelijk. Als je oude enquêtes hebt opgeslagen met een *.sql-extensie is de enige mogelijkheid om versie 1.50 te installeren en daar de .sql-bestanden te importeren, en die versie te upgraden. Kijk dan ook even bij een installatie verplaatsen

Upgrade FAQ

Wat is de laatste versie van LimeSurvey die nog PHP4 ondersteund?

De laatste versie die PHP4 ondersteund is 1.82+

Kan ik een upgrade doen als ik actieve enquêtes heb?

Ja, dat kan. Besef je wel dat de instructies verwijzen naar de handmatige zaken die je moet checken, zeker als je actieve enquêtes hebt met eigen sjablonen.

Wat is de beste manier om LimeSurvey *.sql-enquêtes naar nieuwe versie om te zetten?

Installeer versie 1.50, importeer het bestand en exporteer de enquête naar het nieuwe .csv-formaat. Importeer deze in de nieuwe versie, die kan dat formaat lezen.