Latest revision as of 10:52, 3 April 2024

Other languages:

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

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.

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 na de upgrade je browsercache en cookies!

Upgraden vanaf oudere versies

Daar zitten wat meer haken en ogen aan, dus lees nauwkeurig de volgende instructies.

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

Download de laatste versie van LimeSurvey.
Maak een 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 je sjabloon als dat al een bestaand standaardsjabloon is en er dus al een map in /templates is.
- 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 Installatie.
- Open het administratiegedeelte en volg de instructies. De bestaande database wordt indien nodig vernieuwd na bevestiging
Controleer of er nog handmatige zaken zijn (zie ook hieronder)
Verwijder je browsergeschiedenis en je cookies

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

Handmatige controles na een upgrade

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.

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

Download de laatste versie van LimeSurvey.
Maak een back-up van je huidige installatie, en database
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 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)

Controles na een upgrade

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.

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

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>
+<languages /> <div style="float:right;"><div class="simplebox">Andere pagina's:{toc}</div></div>__TOC__
 =Voordat je begint...=
-<span style='color:#FF0000'>... read this because it is very important: '''Always backup the files and the database of your current installation!!!'''</span>
+<span style='color:#FF0000'>'''Maak altijd een back-up van je huidige installatie, de scripts en de database!'''</span>
-You can do this using a database administration tool like [http://www.phpmyadmin.net phpMyAdmin] etc. and a file manager! If you don't know how to do this, you should not proceed but ask someone who knows or use the [[ComfortUpdate]] instead.
+Dit laatste kun je doen via een beheerapplicatie als [https://www.phpmyadmin.net phpMyAdmin] en een bestandsbeheerprogramma. Heb je daar geen kaas van gegeten, vraag dan iemand die dat wel heeft.
-= De snelle manier (voor kleine upgrades)=
+==Aanbeveling: Gebruik ComfortUpdate==
+'''De gemakkelijkste manier om te upgraden is het gebruiken van [[ComfortUpdate/nl|ComfortUpdate]].'''
-Gebruik deze instructies om een kleine upgrade te doen (bijvoorbeeld versie 2.00 naar 2.01)
+=Upgraden vanaf minimaal versie 2.x=
-* Maak een back-up van bestanden en database!
-* Verwijder alles, behalve
+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]]).
+* 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 (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.)
+** /upload directory
+<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>
 * 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 browser cache en cookies'''
+* '''Wis na de upgrade je browsercache en cookies!'''
+=Upgraden vanaf oudere versies=
+Daar zitten wat meer haken en ogen aan, dus lees nauwkeurig de volgende instructies.
+==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 je sjabloon als dat al een bestaand standaardsjabloon is en er dus al een map in /templates is.
+** 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 indien nodig 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.}}
+<div class="simplebox">'''Handmatige controles na een upgrade'''
+*'''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>
+==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.
+* Maak een back-up van je huidige installatie, en database
+* 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)
+<div class="simplebox">'''Controles na een upgrade'''
+*'''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>
-= De grondige manier (voor grote upgrades)=
+==Upgrade van een versie voor 1.50 (v1.0 tot v1.44)==
-Unfortunately there are a couple of things to consider, so please observe carefully the following instructions.
+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]]
-==Upgraden van versie 2.0 x 2.50 of hoger==
+= Upgraden met CLI =
-*Let op: de sjabloonstructuur is veranderd. Uw oude sjablonen zullen niet meer werken omdat het nu werkt met responsive sjablonen.
-==Upgrade van versie 1.50 of later naar een 2.xx versie==
+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.
-#[http://www.limesurvey.org#download Download] de laatste versie van LimeSurvey.
-# Bereid de huidige installatie voor.
+=Database-upgrade mislukt=
-## Maak een back-up van je huidige installatie en database
+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!).
-### 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.
+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.
-## Kopieer het '''config.php''' bestand, de gewijzigde '''template''' directories en de /upload directory om deze snel te kunnen benaderen.
+Hierbij wordt er van uitgegaan dat je de database- en bestandsback-up nog hebt, ofwel via ComfortUpdate, of omdat deze regulier is aangemaakt.
-# 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/nl#Rechten goed zetten|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 cookies'''
+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.
-{{Alert|title=Attention|text=If you upgrade from an earlier version (e.g. 2.0), it might be necessary to ''first'' upgrade to the latest 2.0.x release, then to 2.06, and then finally to the latest version (e.g. 2.67.x).}}
+Dat is het. Alles zou weer normaal moeten zijn.
-<div class="simplebox">'''Handmatige controles na een upgrade'''
+'''Een opmerking over het melden van dit probleem:'''
-*'''upgrades naar 2.xx''':
-**de '''sjablonen''' zijn op veel plaatsen gewijzigd. Als je eigen sjablonen hebt, controleer dan of ze nog goed werken. Het upgradeproces probeert de JavaScript  template.js te vervangen door het kenmerk {TEMPLATEJS}. Als er dus met JavaScript problemen zijn, bekijk dan of deze aanduiding inderdaad vervangen is in startpage.pstpl.
-**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.
-*'''van een oudere versie naar v2.06''': Van 2.05 tot 2.06 zijn enkele ongebruikte rechten geactiveerd bij het wijzigen van rechten van actieve enquêtes. Als een gebruiker meer rechten heeft dan alleen aanmaken dan kunnen ze ook rechten hebben op niet eigen enquêtes. Controleer de rechten van beheerders die alleen maar eigen enquêtes mogen zien en kijk na of ze alleen maar het recht aanmaken hebben voor enquêtes.</div>
+Als je een dergelijk probleem tegenkomt, meld dit dan in onze bugtracker op https://bugs.limesurvey.org
-==What is the most recent LimeSurvey version that still supports PHP4?==
+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.
-De laatste versie die PHP4 ondersteund is 1.82+
+=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.

Upgrading from a previous version/nl: Difference between revisions

From LimeSurvey Manual