Latest revision as of 16:21, 14 April 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

Volg deze stappen:

log uit als beheerder
Maak een back-up van bestanden en database!
Verwijder alle bestanden en mappen, behalve
1. /application/config/security.php -Belangrijk! Dit is de key voor alle encrypte gegevens in LimeSurvey (vanaf versie 4)
2. /application/config/config.php
3. map /upload
Kopieer de nieuwe bestanden van het nieuwe LimeSurvey-pakket naar de bestaande locatie.
Wis nu uw browsercache en cookies.
Open de admin-pagina in uw browser (bijv. https://www.example.com/limesurvey/admin). Als een upgrade van het databaseschema nodig is, wordt u gevraagd dit te bevestigen.
Klaar!

Opmerking: Tussen hoofdversies (bijvoorbeeld van versie 3 naar 4) veranderen de thema's templates/design meestal volledig. Oude enquête sjablonen/thema's werken meestal niet meer.

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=
-Gebruik deze instructies:
+Volg deze stappen:
-* Maak een back-up van bestanden en database!  ([[Upgrading from a previous version/nl#Voordat je begint...|We noemen het maar weer eens]]).
+# log uit als beheerder
-* Verwijder alles in files/folders, behalve
+# Maak een back-up van bestanden en database!
-**/application/config/security.php -'''Belangrijk! Dit is de key voor alle  encrypte gegevens in LimeSurvey (vanaf versie 4)'''
+# Verwijder alle bestanden en mappen, behalve
-** /application/config/config.php
+##/application/config/security.php -'''Belangrijk! Dit is de key voor alle  encrypte gegevens in LimeSurvey (vanaf versie 4)'''
-** /upload directory
+## /application/config/config.php
+## map /upload
+#Kopieer de nieuwe bestanden van het nieuwe LimeSurvey-pakket naar de bestaande locatie.
+#Wis nu uw browsercache en cookies.
+#Open de admin-pagina in uw browser (bijv. https://www.example.com/limesurvey/admin). Als een upgrade van het databaseschema nodig is, wordt u gevraagd dit te bevestigen.
+#Klaar!
-<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 class="simplebox">[[File:help.png]]'''Opmerking:''' Tussen hoofdversies (bijvoorbeeld van versie 3 naar 4) veranderen de thema's templates/design meestal volledig. Oude enquête sjablonen/thema's werken meestal niet meer.</div>
-* 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!'''
-=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