Actions

Upgrading from a previous version/nl: Difference between revisions

From LimeSurvey Manual

(Created page with "=Database-upgrade mislukt= Soms kan de database-upgrade mislukken. Dat kan gebeuren door verschillende redenen, een andere databaseversie, een onverwacht gegevensformaat of in...")
(Created page with "Als er een fout optreedt bij het updaten van de database en de LimeSurvey-instantie wordt onbruikbaar, dan moet u terug naar de vorige versie. Hierbij wordt er van uitgegaan d...")
Line 79: Line 79:
Soms kan de database-upgrade mislukken. Dat kan gebeuren door verschillende redenen, een andere databaseversie, een onverwacht gegevensformaat of inhoud, ongebruikelijke configuratie of iets dat niet naar voren kwam in onze tests (ja, we testen echt wel!).
Soms kan de database-upgrade mislukken. Dat kan gebeuren door verschillende redenen, een andere databaseversie, een onverwacht gegevensformaat of inhoud, ongebruikelijke configuratie of iets dat niet naar voren kwam in onze tests (ja, we testen echt wel!).


If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
Als er een fout optreedt bij het updaten van de database en de LimeSurvey-instantie wordt onbruikbaar, dan moet u terug naar de vorige versie.
This assumes that you still have the database and file backup, either from ComfortUpdate, or you created these manually.
Hierbij wordt er van uitgegaan dat u de database- en bestandsback-up nog heeft, ofwel via ComfortUpdate, of omdat u deze handmatig heeft aangemaakt.


Please execute the following steps:
Please execute the following steps:

Revision as of 20:10, 30 August 2021

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 mislukken. Dat kan gebeuren door verschillende redenen, een andere databaseversie, een onverwacht gegevensformaat of inhoud, ongebruikelijke configuratie of iets dat niet naar voren kwam in onze tests (ja, we testen echt wel!).

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

Please execute the following steps:

  • Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup)
  • Restore files to the existing directory (just overwriting them is fine) from the original (1st) backup.
  • Delete the old database and restore the database from the original (1st) backup.

That's it. Everything should be back to normal.

A note about reporting this issue:

If you run into a problem like this, please always report this in our bug tracker at https://bugs.limesurvey.org

Note: A bug not reported is a bug not fixed. Please don't just rely on other people reporting it. If you see that the bug is already reported, you can also help to raise the bug priority by marking it as 'Yes, this bug affects me' in the bug tracker.

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.