Upgraden van een vorige versie

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)

Gebruik deze instructies om een kleine upgrade te doen (bijvoorbeeld versie 2.00 naar 2.01)

• Maak een back-up van bestanden en database! (We noemen het maar weer eens).
• Verwijder alles in files/folders, behalve
  • /application/config/config.php
  • /upload directory
    NB.: Als je eigen sjablonen plaatst in of onder /upload/templates, zorg er dan voor dat je die aanpast met de wijzigingen in een nieuwe versie. Dit kan het makkelijkst met een programma om twee bestanden, hier dus sjablonen, te vergelijken.
• Kopieer de bestanden van de nieuwe download naar de huidige locatie
• Open in je browser de beheerpagina (https://www.example.com/limesurvey/admin) en controleer of er een wijziging van de database noodzakelijk is.
• Wis je browsercache en cookies

De grondige manier (voor grote upgrades)

Unfortunately, there are a couple of things to consider, so please read the following instructions carefully.

Upgrade van versie 1.50 of later naar een 2.xx versie

• Download de laatste versie van LimeSurvey.
• Bereid de huidige installatie voor.
  • Maak een back-up van je huidige installatie en database
    • Maak een zip-bestand van je bestanden met je favoriete inpaksoftware
    • Gebruik phpMyAdmin of iets gelijkwaardig om alle tabellen uit de database te exporteren; of gebruik het icoon om een back-up te maken.
      NB: Zoek naar de knop LimeSurvey Beheer om de database te exporteren in de oudere versies van LimeSurvey
• Kopieer het config.php bestand, de gewijzigde template directories en de /upload directory om deze snel te kunnen benaderen.
• Vervang de gehele installatie door de nieuwe versie
  • Verwijder alles in de gehele installatiedirectory (+ subdirectories)
  • Upload en pak de nieuwe installatie uit in de installatiedirectory
  • Als je vorige versie ouder was dan versie 1.90: kopieer je gewijzigde sjablonen naar /upload/templates. Wijzig ook de naam van elke directory die nu in /templates staat.
  • Kopieer de /upload-directory naar z'n oude lokatie.
  • Controleer of de rechten van de directories /tmp, /upload en hun subdirectories op "Lees&Schrijf" staat, zoals beschreven in Installatie.
  • Open het administratiegedeelte en volg de instructies. De bestaande database wordt vernieuwd na bevestiging
• Controleer of er nog handmatige zaken zijn (zie ook hieronder)
• Verwijder je browsergeschiedenis en je cookies

  Als u een upgrade van bijvoorbeeld 1.92 doet, kan het nodig zijn om eerst te upgraden naar de laatste 1.92 versie, dan naar 2.00, dan naar 2.06, en eindelijk naar de actuele versie (bijv. 2.55.x). Lees meer details.

  De sjabloonstructuur is na versie 2.0 gewijzigd. Oude sjablonen werken niet meer, we gebruiken nu responsieve sjablonen.

Special checks after an upgrade:

• from any earlier version to 2.xx: Proper question codes are mandatory now. After upgrading the installation, 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 to whom this permission should be given 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 permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly

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

• Download the desired version of LimeSurvey
• Prepare and backup the old installation
  • 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 phpMyAdmin or similar to export all tables; or using the LimeSurvey Administration button 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
  • 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)

Special checks after an upgrade:

• from any earlier version to 1.92: The templates have been changed. 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)
  
• 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 to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.

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

Since the data structure and a lot of other things were changed, upgrading from any version previous to v1.50 is NOT possible. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install version 1.50, import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to how an installation can be transferred for more details.

Upgrade FAQ

Wat is de meest recente 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.

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

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.