Actions

Upgrading from a previous version/nl: Difference between revisions

From LimeSurvey Manual

No edit summary
(Updating to match new version of source page)
Line 3: Line 3:
=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>
<span style='color:#FF0000'>... read this because it is very important: '''Always backup the files and the database of your current installation!'''</span>


Dit laatste kun je doen via een beheerapplicatie als [https://www.phpmyadmin.net phpMyAdmin]. Heb je daar geen kaas van gegeten, overweeg dan iemand te vragen die dat wel heeft, of gebruik [[ComfortUpdate/nl|ComfortUpdate]].
You can do this using a database administration tool like [https://www.phpmyadmin.net phpMyAdmin] and a file manager! If you don't know how to do this, you should not proceed further and ask someone who knows or use the [[ComfortUpdate]] instead.


= De snelle manier (voor kleine upgrades)=
= De snelle manier (voor kleine upgrades)=


Gebruik deze instructies om een kleine upgrade te doen (bijvoorbeeld versie 2.00 naar 2.01)
You can use these instructions if you are doing a minor upgrade (for example from 2.00 to 2.01):
* Maak een back-up van bestanden en database([[Upgrading from a previous version/nl#Voordat je begint...|We noemen het maar weer eens.]]).
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Verwijder alles in files/folders, behalve
*Delete all the old files/folders except for:
** /application/config/config.php
**/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 -
* Kopieer de bestanden van de nieuwe download naar de huidige locatie
<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates sitting under /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>
* Open in je browser de beheerpagina (https://www.example.com/limesurvey/admin) en controleer of er een wijziging van de database noodzakelijk is.
*Copy the new files from the new LimeSurvey package to the existing location.
* '''Wis je browsercache en cookies'''
*Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
 
*After the upgrade: '''Clear your browser cache and cookies!'''


= De grondige manier (voor grote upgrades)=
= De grondige manier (voor grote upgrades)=
Line 23: Line 23:
Daar zitten wat meer haken en ogen aan, dus lees het volgende zeer nauwkeurig.
Daar zitten wat meer haken en ogen aan, dus lees het volgende zeer nauwkeurig.


==Upgrade van versie 1.50 of later naar een 2.xx versie==
==Upgrading from version 1.50 or later to any later 2.xx version==
#[https://www.limesurvey.org#download Download] de laatste versie van LimeSurvey.
#[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey.
# Bereid de huidige installatie voor.
# Prepare and backup the old installation:
## Maak een back-up van je huidige installatie en database
## Backup your installation directory files and SQL-based database just in case:
### Maak een zip-bestand van je bestanden met je favoriete inpaksoftware
### At the command-line level, make a '''.zip''' or similar archive of the whole installation directory tree of files. For example, in Linux 'tar cvzf foo.tgz cps100' will tar and zip the whole of the cps100 directory;
### 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.
### You can use [httsp://www.phpmyadmin.net phpMyAdmin] to export all tables or you can use the backup database function of LimeSurvey that is available in the Configuration dialog (under the Advanced tab) to backup the entire database;
## Kopieer het '''config.php''' bestand, de gewijzigde '''template''' directories en de /upload directory om deze snel te kunnen benaderen.
<div class="simplebox">[[File:help.png]] '''Note:''' Look for the '''LimeSurvey Administration''' button [[File:button-export-sql.png]] to export the database in the older LimeSurvey versions</div>
# Vervang de gehele installatie door de nieuwe versie
## Copy your '''config.php''' file, modified '''template''' directories, and the /upload directory separately for quick access later.
## Verwijder alles in de gehele installatiedirectory (+ subdirectories)
# Replace all the installation directory files:
## Upload en pak de nieuwe installatie uit in de installatiedirectory
## Delete all old files in the existing installation directory;
## 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.  
## Upload and unpack the new code version into the same installation directory;
## Kopieer de /upload-directory naar z'n oude lokatie.
## If your previous version is older than 1.90, copy any customized templates to '/upload/templates' - you will also need to rename each template directory whose name matches an existing template in /templates.
## 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]].
## Copy your '/upload' directory back to the old location;
## Open het administratiegedeelte en volg de instructies. De bestaande database wordt vernieuwd na bevestiging
## Double check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]];
# Controleer of er nog handmatige zaken zijn (zie ook hieronder)
## Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (you can use the old config.php as reference). The existing database will be automatically detected and if necessary, upgraded after confirmation.
# '''Verwijder je browsergeschiedenis en cookies'''
# Check if any special manual checks apply as listed below;
# '''Now, clear your browser cache and cookies!''' and you are good to go.


{{Alert|title=Let op|text=Als u een upgrade van bijvoorbeeld 1.92 doet, kan het nodig zijn om eerst te upgraden naar de laatste 1.92 versie, dan naar 2.00, dan naar 2.06, en eindelijk naar de actuele versie (bijv. 2.55.x).}}
{{Alert|title=Attention|text=If you upgrade from e.g. 1.92, it might be necessary to upgrade ''first'' to the latest 1.92 release, then to 2.00, then to 2.06, and then finally to the latest version (e.g. 2.55.x). Read below for [[Upgrading from a previous version#Upgrading from version 1.50 or later to any later 1.xx version|further details]].}}


{{Alert|title=Let op|text=De sjabloonstructuur is na versie 2.0 gewijzigd. Oude sjablonen werken niet meer, we gebruiken nu responsieve sjablonen.}}
{{Alert|title=Let op|text=De sjabloonstructuur is na versie 2.0 gewijzigd. Oude sjablonen werken niet meer, we gebruiken nu responsieve sjablonen.}}
Line 50: Line 51:
*'''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>
*'''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==
==Upgrading from version 1.50 or later to any later 1.xx version==
#[http://www.limesurvey.org/download Download] de laatste versie van LimeSurvey.
#[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey.
# Bereid de huidige installatie voor.
# Prepare and backup the old installation.
## Maak een back-up van je huidige installatie, en database
## Backup your installation directory files and SQL-based database just in case.
### Maak een zip-bestand van je bestanden met je favoriete inpaksoftware
### At the command-line level, make a '''.zip''' or similar archive of the whole installation directory tree of files. For example, in Linux 'tar cvzf foo.tgz cps100' will tar and zip the whole of the cps100 directory;
### 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.
### Using [httsp://www.phpmyadmin.net phpMyAdmin] or similar to export all tables; or using the '''LimeSurvey Administration''' button [[File:button-export-sql.png]] to backup the entire database.
## Kopieer het '''config.php''' bestand, de gewijzigde '''template''' directories en de /upload directory om deze snel te kunnen benaderen.
## Copy your '''config.php''' file, modified '''template''' directories, and the /upload directory separately for quick access later;
# Vervang de gehele installatie door de nieuwe versie
# Replace all the installation directory files:
## Verwijder alles in de gehele installatiedirectory (+ subdirectories)
## Delete all old files in the existing installation directory;
## Upload en pak de nieuwe installatie uit in de installatiedirectory
## Upload and unpack the new code version into the same installation directory;
## Upgrade de  '''config.php''' file:
## Edit or replace the '''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!'''
### If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!''';
### Als je vorige versie > 1.70: Kopieer de oude '''config.php''' over de nieuwe heen.  
### If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed);
## 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.
## If your previous version was older than 1.90: Copy any customized templates to '/upload/templates' - you will also need to rename each template directory whose name matches an existing template in /templates;
## Kopieer de /upload-directory naar z'n oude locatie.
## Copy your '/upload' directory back to the old location;
## 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]].
## Double check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]];
## Open het administratiegedeelte en volg de instructies. De bestaande database wordt vernieuwd na bevestiging
# Finish the installation/upgrade process:
## Verwijder, of hernoem de '''/admin/install''' directory zoals het installatiescript je zal vertellen
## Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation;
# Controleer of er nog handmatige zaken zijn (zie ook hieronder)
## Remove or rename the '/admin/install' directory as/if instructed by the installation script;
# '''Verwijder je browsergeschiedenis en cookies'''
## Check if any special manual checks apply (as listed below).


<div class="simplebox">'''Handmatige controles na een upgrade'''
<div class="simplebox">'''Handmatige controles na een upgrade'''
Line 77: Line 78:
==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/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]]
Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with a *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.


=Upgrade FAQ=
=Upgrade FAQ=

Revision as of 11:05, 11 September 2017

Andere pagina's:{toc}

Voordat je begint...

... read this because it is very important: Always backup the files and the database of your current installation!

You can do this using a database administration tool like phpMyAdmin and a file manager! If you don't know how to do this, you should not proceed further and ask someone who knows or use the ComfortUpdate instead.

De snelle manier (voor kleine upgrades)

You can use these instructions if you are doing a minor upgrade (for example from 2.00 to 2.01):

  • Backup your files and database (did we already mention that?).
  • Delete all the old files/folders except for:
    • /application/config/config.php;
    • /upload directory -
Note: If you have any customized templates sitting under /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.
  • Copy the new files from the new LimeSurvey package to the existing location.
  • Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
  • After the upgrade: Clear your browser cache and cookies!

De grondige manier (voor grote upgrades)

Daar zitten wat meer haken en ogen aan, dus lees het volgende zeer nauwkeurig.

Upgrading from version 1.50 or later to any later 2.xx version

  1. Download the latest version of LimeSurvey.
  2. Prepare and backup the old installation:
    1. Backup your installation directory files and SQL-based database just in case:
      1. At the command-line level, make a .zip or similar archive of the whole installation directory tree of files. For example, in Linux 'tar cvzf foo.tgz cps100' will tar and zip the whole of the cps100 directory;
      2. You can use [httsp://www.phpmyadmin.net phpMyAdmin] to export all tables or you can use the backup database function of LimeSurvey that is available in the Configuration dialog (under the Advanced tab) to backup the entire database;
Note: Look for the LimeSurvey Administration button to export the database in the older LimeSurvey versions
    1. Copy your config.php file, modified template directories, and the /upload directory separately for quick access later.
  1. Replace all the installation directory files:
    1. Delete all old files in the existing installation directory;
    2. Upload and unpack the new code version into the same installation directory;
    3. If your previous version is older than 1.90, copy any customized templates to '/upload/templates' - you will also need to rename each template directory whose name matches an existing template in /templates.
    4. Copy your '/upload' directory back to the old location;
    5. Double check the permissions set on the directories (write access to /tmp, /upload, and their subdirectories is required) as described in the installation wiki;
    6. Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (you can use the old config.php as reference). The existing database will be automatically detected and if necessary, upgraded after confirmation.
  2. Check if any special manual checks apply as listed below;
  3. Now, clear your browser cache and cookies! and you are good to go.
  Attention : If you upgrade from e.g. 1.92, it might be necessary to upgrade first to the latest 1.92 release, then to 2.00, then to 2.06, and then finally to the latest version (e.g. 2.55.x). Read below for further details.


  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.

Upgrading from version 1.50 or later to any later 1.xx version

  1. Download the desired version of LimeSurvey.
  2. Prepare and backup the old installation.
    1. Backup your installation directory files and SQL-based database just in case.
      1. At the command-line level, make a .zip or similar archive of the whole installation directory tree of files. For example, in Linux 'tar cvzf foo.tgz cps100' will tar and zip the whole of the cps100 directory;
      2. Using [httsp://www.phpmyadmin.net phpMyAdmin] or similar to export all tables; or using the LimeSurvey Administration button to backup the entire database.
    2. Copy your config.php file, modified template directories, and the /upload directory separately for quick access later;
  3. Replace all the installation directory files:
    1. Delete all old files in the existing installation directory;
    2. Upload and unpack the new code version into the same installation directory;
    3. Edit or replace the config.php file:
      1. If your previous version was < 1.70: Edit the new config.php in order to reflect the changes from the backup config.php file. Do not just overwrite the new config.php with your old one!;
      2. If your previous version was >= 1.70: Simply replace the new config.php with your backup config.php file (as the file format has not changed);
    4. If your previous version was older than 1.90: Copy any customized templates to '/upload/templates' - you will also need to rename each template directory whose name matches an existing template in /templates;
    5. Copy your '/upload' directory back to the old location;
    6. Double check the permissions set on the directories of LimeSurvey (write access to /tmp, /upload, and to their subdirectories is required) as described in the installation wiki;
  4. Finish the installation/upgrade process:
    1. Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation;
    2. Remove or rename the '/admin/install' directory as/if instructed by the installation script;
    3. Check if any special manual checks apply (as listed below).
Handmatige controles na een upgrade
  • upgrades naar 1.92 of later: de sjablonen zijn gewijzigd. Als je eigen sjablonen hebt, controleer dan of ze nog goed werken.
  • 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 de rechten dus.div>

Upgrade van een versie voor 1.50 (v1.0 tot v1.44)

Since the data structure and a lot of other things were changed, upgrading from any version previous to v1.50 is NOT possible. If you have old survey structure files with a *.sql extension, the only way to get these into a newer version is to install version 1.50, import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to how an installation can be transferred for more details.

Upgrade FAQ

Wat is de meest recente versie van LimeSurvey die nog PHP4 ondersteund?

De laatste versie die PHP4 ondersteund is 1.82+

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.

Wat is de beste manier om LimeSurvey *.sql-enquêtes naar nieuwe versie om te zetten?

Installeer versie 1.50, importeer het bestand en exporteer de enquête naar het nieuwe .csv-formaat. Importeer deze in de nieuwe versie, die kan dat formaat lezen.