Upgrading from a previous version/nl: Difference between revisions
From LimeSurvey Manual
No edit summary |
(Updating to match new version of source page) |
||
| (118 intermediate revisions by 2 users not shown) | |||
| 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...= | =Voordat je begint...= | ||
<span style='color:#FF0000'>'''Maak altijd een back-up van je huidige installatie, de scripts en de database | <span style='color:#FF0000'>'''Maak altijd een back-up van je huidige installatie, de scripts en de database!'''</span> | ||
Dit laatste kun je doen via een beheerapplicatie als [ | 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 | ==Aanbeveling: Gebruik ComfortUpdate== | ||
'''De gemakkelijkste manier om te upgraden is het gebruiken van [[ComfortUpdate/nl|ComfortUpdate]].''' | |||
Gebruik deze instructies | =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 | ** /application/config/config.php | ||
** /upload directory | ** /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 | * Kopieer de bestanden van de nieuwe download naar de huidige locatie | ||
* '''Wis je | * 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 | 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== | ==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''' | <div class="simplebox">'''Handmatige controles na een upgrade''' | ||
*'''upgrades naar 2.xx''': | *'''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. </div> | *'''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== | ==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">''' | <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> | |||
*'''upgrades vanaf 1.53 of eerder''': controleer of de ''' | |||
==Upgrade van een versie voor 1.50 (v1.0 tot v1.44)== | ==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 [http://www.limesurvey.org/en/archived-releases/ | 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 met CLI = | |||
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. | |||
=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?== | ==Kan ik een upgrade doen als ik actieve enquêtes heb?== | ||
Ja, dat kan. | 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. | |||
Latest revision as of 10:52, 3 April 2024
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.