Latest revision as of 12:05, 25 February 2025

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 en een bestandsbeheerprogramma. Heb je daar geen kaas van gegeten, vraag dan iemand die dat wel heeft.

Aanbeveling: Gebruik ComfortUpdate

De gemakkelijkste manier om te upgraden is het gebruiken van ComfortUpdate.

Upgraden vanaf minimaal versie 2.x

Gebruik deze instructies:

Maak een back-up van bestanden en database! (We noemen het maar weer eens).
Verwijder alles bestanden en mappen, behalve
- /application/config/security.php -Belangrijk! Dit is de key voor alle encrypte gegevens in LimeSurvey (vanaf versie 4)
- /application/config/config.php
- /upload directory

Log out of the administration
Backup your files and database
Delete all the old files/folders except for:
1. /application/config/security.php - Important!! This is the key to all encrypted data in LimeSurvey (version 4 and later)
2. /application/config/config.php;
3. /upload directory
Copy the new files from the new LimeSurvey package to the existing location.
Now clear your browser cache and cookies.
Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin). If a database scheme upgrade is necessary you will be prompted to confirm it.
Done!

Note: Between major versions (for example from version 3 to 4) the template/design themes change usually completely. Old survey design templates/themes will usually not work anymore.

Upgraden met CLI

Je kunt de database upgraden met behulp van de PHP CLI met php application/commands/console.php updatedb . Hiermee kun je bijvoorbeeld een automatisch upgrade-systeem instellen via de opdrachtregel (eventueel in een crontab), maar dat bevelen we niet aan.

Database-upgrade mislukt

Soms kan de database-upgrade (zowel handmatig of via ComfortUpdate) mislukken. Dat kan gebeuren door verschillende redenen: een andere databaseversie, een onverwacht gegevensformaat of inhoud, ongebruikelijke configuratie of iets dat niet naar voren kwam bij onze testen (ja, we testen echt wel!).

Als er een fout optreedt bij het updaten van de database en de LimeSurvey-instantie wordt onbruikbaar, dan moet je terug naar de vorige versie. Hierbij wordt er van uitgegaan dat je de database- en bestandsback-up nog hebt, ofwel via ComfortUpdate, of omdat deze regulier is aangemaakt.

Voer de volgende stappen uit:

Maak een back-up van de bestaande map LimeSurvey en database (ja, nogmaals - we noemen dit de 2e back-up)
Herstel bestanden naar de bestaande map (alleen overschrijven is prima) van de originele (1e) back-up.
Verwijder de oude database en herstel de database vanaf de originele (1e) back-up.

Dat is het. Alles zou weer normaal moeten zijn.

Een opmerking over het melden van dit probleem:

Als je een dergelijk probleem tegenkomt, meld dit dan in onze bugtracker op https://bugs.limesurvey.org

Een bug die niet gemeld wordt, is een bug die niet kan worden verholpen. Vertrouw er niet op dat andere mensen het melden. Als je ziet dat de bug al bekend is, kun je helpen om de prioriteit van de bug te verhogen door deze te markeren als 'Yes, this bug affects me' in de bugtracker.

Veel gestelde vragen over upgraden

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.

Hoe zet je sql/csv-enquêtes over naar de nieuwe versie

Installeer versie 1.50, importeer het bestand en exporteer de enquête naar het nieuwere csv-formaat. Installeer dan versie 2 en importeer het csv-bestand in die versie. Vervolgens exporteer je het als lss-bestand.

Survey theme incompatibility

With certain major version updates any custom survey themes will not be compatible, anymore:

Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

Error "Multiple primary key defined" when updating MySQL database

If you encounter this error, please check the setting sql_generate_invisible_primary_key in your MySQL server variables. This is most likely set to ON, but should be set to OFF. Then restore your database from the backup (as explained above) and try again.

@@ Line 1: / Line 1: @@
 <languages /> <div style="float:right;"><div class="simplebox">Andere pagina's:{toc}</div></div>__TOC__
+<span id="Before_you_start..."></span>
 =Voordat je begint...=
@@ Line 10: / Line 11: @@
 '''De gemakkelijkste manier om te upgraden is het gebruiken van [[ComfortUpdate/nl|ComfortUpdate]].'''
+<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
 =Upgraden vanaf minimaal versie 2.x=
+<div class="mw-translate-fuzzy">
 Gebruik deze instructies:
 * Maak een back-up van bestanden en database!  ([[Upgrading from a previous version/nl#Voordat je begint...|We noemen het maar weer eens]]).
@@ Line 18: / Line 21: @@
 ** /application/config/config.php
 ** /upload directory
+</div>
+<div lang="en" dir="ltr" class="mw-content-ltr">
+#Log out of the administration
+#Backup your files and database
+#Delete all the old files/folders except for:
+##/application/config/security.php - '''Important!! This is the key to all encrypted data in LimeSurvey (version 4 and later)'''
+##/application/config/config.php;
+##/upload directory
+#Copy the new files from the new LimeSurvey package to the existing location.
+#Now clear your browser cache and cookies.
+#Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin). If a database scheme upgrade is necessary you will be prompted to confirm it.
+#Done!
+</div>
-<div class="simplebox">[[File:help.png]]'''NB.: Als je eigen sjablonen plaatst in of onder /upload/templates, zorg er dan voor dat je die aanpast met de wijzigingen in de nieuwe versie. Dit kan het makkelijkst met een programma om twee bestanden, hier dus sjablonen, te vergelijken.'''</div>
+<div lang="en" dir="ltr" class="mw-content-ltr">
-* Kopieer de bestanden van de nieuwe download naar de huidige locatie
+<div class="simplebox">[[File:help.png]]'''Note:''' Between major versions (for example from version 3 to 4) the template/design themes change usually completely. Old survey design templates/themes will usually not work anymore.</div>
-* Open in je browser de beheerpagina (https://www.example.com/limesurvey/admin) en controleer of er een wijziging van de database noodzakelijk is.
+</div>
-* '''Wis na de upgrade je browsercache en cookies!'''
-=Upgraden vanaf oudere versies=
+<span id="Upgrading_using_CLI"></span>
+= Upgraden met CLI =
-Daar zitten wat meer haken en ogen aan, dus lees nauwkeurig de volgende instructies.
+Je kunt de database upgraden met behulp van de PHP CLI  met <code>php application/commands/console.php updatedb</code> . Hiermee kun je bijvoorbeeld een automatisch upgrade-systeem instellen via de opdrachtregel (eventueel in een crontab), maar dat bevelen we niet aan.
-==Upgrade van versie 1.50 of later naar een 2.xx versie==
-*[https://www.limesurvey.org/about-limesurvey/download Download] de laatste versie van LimeSurvey.
-* Maak een [[Upgrading from a previous version/nl#Voordat je begint...|backup]] van je huidige installatie en database.
-* 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 [[Installation_-_LimeSurvey_CE/nl#Maprechten|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'''
-{{Alert|title=Let op|text=De sjabloonstructuur is na versie 2.0 gewijzigd. Oude sjablonen werken niet meer, we gebruiken nu responsieve sjablonen.}}
+=Database-upgrade mislukt=
+Soms kan de database-upgrade (zowel handmatig of via ComfortUpdate)  mislukken. Dat kan gebeuren door verschillende redenen: een andere databaseversie, een onverwacht gegevensformaat of inhoud, ongebruikelijke configuratie of iets dat niet naar voren kwam bij onze testen (ja, we testen echt wel!).
-<div class="mw-translate-fuzzy">
+Als er een fout optreedt bij het updaten van de database en de LimeSurvey-instantie wordt onbruikbaar, dan moet je terug naar de vorige versie.
-<div class="simplebox">'''Handmatige controles na een upgrade'''
+Hierbij wordt er van uitgegaan dat je de database- en bestandsback-up nog hebt, ofwel via ComfortUpdate, of omdat deze regulier is aangemaakt.
-*'''upgrades naar 2.xx''': Nette vraagcodes zijn nu verplicht. Controleer na de upgrade de logica van alle enquêtes en verbeter indien nodig de vraagcodes.
-*'''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. Controleer dus de rechten.
-*'''van een oudere versie naar v2.06''': Bij de conversie van 2.05 naar 2.06 zijn enkele rechten ten onrechte verleend bij het wijzigen van rechten op enquêtes. Als een gebruiker alleen een enquête mag aanmaken dan kunnen ook rechten als View/read, Update, Delete, Import, Export zijn ingeschakeld. Controleer de rechten van beheerders.</div>
-</div>
-<div class="mw-translate-fuzzy">
+Voer de volgende stappen uit:
-==Upgrade van versie 1.50 of later naar een 1.xx versie==
-*[https://www.limesurvey.org/about-limesurvey/download 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 [[File:button-export-sql.png]] om een back-up te maken.
-** 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
-** Upgrade de  '''config.php''' file:
-*** Als je vorige versie < 1.70: Wijzig de nieuwe '''config.php''' met de waarden in de oude '''config.php'''. '''Zet niet zomaar de oude over de nieuwe heen!'''
-*** Als je vorige versie > 1.70: Kopieer de oude '''config.php''' over de nieuwe heen.
-*** 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 locatie.
-** Controleer of de '''rechten''' van de directories '''/tmp''', '''/upload''' en hun subdirectories op "Lees&Schrijf" staat, zoals beschreven in [[Installation_-_LimeSurvey_CE/nl#Maprechten|Installatie]].
-** Open het administratiegedeelte en volg de instructies. De bestaande database wordt vernieuwd na bevestiging
-** Verwijder, of hernoem de '''/admin/install''' directory zoals het installatiescript je zal vertellen
-* Controleer of er nog handmatige zaken zijn (zie ook hieronder)
-* '''Verwijder je browsergeschiedenis en cookies'''
-</div>
-<div class="mw-translate-fuzzy">
+*Maak een back-up van de bestaande map LimeSurvey en database (ja, nogmaals - we noemen dit de 2e back-up)
-<div class="simplebox">'''Controles na een upgrade'''
+*Herstel bestanden naar de bestaande map (alleen overschrijven is prima) van de originele (1e) back-up.
-*'''upgrades naar 1.92 of later''': de '''sjablonen''' zijn gewijzigd. Als je eigen sjablonen hebt, controleer dan of ze nog goed werken.
+* Verwijder de oude database en herstel de database vanaf de originele (1e) back-up.
-*'''upgrades vanaf 1.53 of eerder''': controleer of de '''globale  rechten''' 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. Controleer dus de rechten.</div>
-</div>
-==Upgrade van een versie voor 1.50 (v1.0 tot v1.44)==
+Dat is het. Alles zou weer normaal moeten zijn.
-Omdat de datastructuur en een hoop andere dingen flink gewijzigd zijn is een '''upgrade van een versie voor 1.50 <u>NIET</u> mogelijk'''. Als je oude enquêtes hebt opgeslagen met een *.sql-extensie is de enige mogelijkheid om  [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip versie 1.50] te installeren en daar de .sql-bestanden te importeren, en ''die'' versie te upgraden. Kijk dan ook even bij [[Transferring an installation/nl|een installatie verplaatsen]]
+'''Een opmerking over het melden van dit probleem:'''
-= Upgraden met CLI =
+Als je een dergelijk probleem tegenkomt, meld dit dan in onze bugtracker op https://bugs.limesurvey.org
-Je kunt de database upgraden met behulp van de PHP CLI  met <code>php application/commands/console.php updatedb</code> . Hiermee kun je bijvoorbeeld een automatisch upgrade-systeem instellen via de opdrachtregel (eventueel in een crontab), maar dat bevelen we niet aan.
+Een bug die niet gemeld wordt, is een bug die niet kan worden verholpen. Vertrouw er niet op dat andere mensen het melden. Als je ziet dat de bug al bekend is, kun je helpen om de prioriteit van de bug te verhogen door deze te markeren als 'Yes, this bug affects me' in de bugtracker.
+<span id="FAQ"></span>
 =Veel gestelde vragen over upgraden=
+<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
 ==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.
-==Hoe zet je *.sql/*.csv-enquêtes over nar de nieuwe versie==
+<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
+==Hoe zet je sql/csv-enquêtes over naar de nieuwe versie==
 Installeer versie 1.50, importeer het bestand en exporteer de enquête naar het nieuwere csv-formaat. Installeer dan versie 2 en importeer het csv-bestand in die versie. Vervolgens exporteer je het als lss-bestand.
+==Survey theme incompatibility==
+With certain major version updates any custom survey themes will not be compatible, anymore:
+* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
+* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x
+==Error "Multiple primary key defined" when updating MySQL database==
+If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Hoofdstukken

Upgrading from a previous version/nl: Difference between revisions

From LimeSurvey Manual