Actions

Upgrading from a previous version/sl: Difference between revisions

From LimeSurvey Manual

No edit summary
(Updating to match new version of source page)
Line 9: Line 9:
=Hitri način (za manjše spremembe v različicah)=
=Hitri način (za manjše spremembe v različicah)=


Ta navodila lahko uporabite za manjše nadgradnje (na primer iz 2.00 na 2.01)
You can use these instructions if you are doing a minor upgrade  (for example from 2.00 to 2.01)
*Shranite vaše trenutne datoteke in podatkovno zbirko (smo to že omenili?)
*Backup your files and database (did we already mention that?)
*Izbirišite vse stare datoteke in mape razen:
*Delete all the old files/directory except for
**datoteke /application/config/config.php
**/application/config/config.php
**mape /upload  
**/upload directory
*Kopirajte nove datoteke iz novega paketa LimeSurvey-a na obstoječi prostor.
*Copy the new files from the new LimeSurvey package to the existing location.
*'''Po nadgradnji: Izbrišite brskalnikov predpomnilnik (cache) in piškotke (cookies)!'''
* Open the admin page in your brower, 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!'''


=Temeljitejši način (za večje preskoke v različicah)=
=Temeljitejši način (za večje preskoke v različicah)=
Line 21: Line 22:
Žal je potrebno premisliti kar nekaj stvari, zato prosimo da pregledate navodila v nadaljevanju zelo pozorno.
Žal je potrebno premisliti kar nekaj stvari, zato prosimo da pregledate navodila v nadaljevanju zelo pozorno.


==Nadgradnja iz različice 1.50 ali kasnejše na poljubno 2.xx različico==
==Upgrading from version 2.0x to 2.50 or later==
#[http://www.limesurvey.org/download Prenesi] zadnjo različico LimeSurvey-a.
*Please note that the template structure has changed. Your old templates will not be working anymore as the template system is now using responsive templates.
# Pripravi in ustvari kopije trenutne namestitve
## Za vsak primer ustvari kopije map, datotek in SQL podatkovne zbirke.
### V ukaznem oknu ustvarite '''.zip''' ali podoben arhiv celotne namestitve (datotek in mapne strukture). Na primer v linux-u bo ukaz tar cvzf foo.tgz cps100 pripravil arhiv vseh cps100 map.
### Z uporabo phpMyAdmin ali podobnega orodja izvozite vse tabele; ali uporabite ustrezen gumb za '''LimeSurvey-eve skrbnike'''  [[File:button-export-sql.png]] za izdelavo kopije celotne podatkovne zbirke
## Kopirajte vašo datoteko '''config.php''', mape prilagojenih  '''predlog''' in mape /upload za kasnejši hiter dostop do njih.
# Zamenjajte vse datoteke v mapi installation
## Izbrišite vse stare datoteke v obstoječi mapi installation
## Naložite in razpakirajte datoteke nove različico v isto mapo installation
## V kolikor je bila vaša prejšnja različica starejša od 1.90: kopirajte vse prilagojene predloge v mapo /upload/templates - prav tako boste morali spremeniti ime vsaki mapi predloge, katere ime se ujema obstoječi predlogi v mapi /templates.
## Kopirajte vašo mapo /upload nazaj na staro mesto
## Dvakrat preverite nastavitve '''pravic''' na mapah (mape '''/tmp''', '''/upload''' in njihove podmape morajo vključevati pravico pisanja) kot je opisano v [http://docs.limesurvey.org/tiki-index.php?page=Installation&structure;=English+Instructions+for+LimeSurvey#Set_Directory_permissions navodilih za namestitev]
## Odprite http://<vaša_domena>/<vaša_mapa_limesurvey-a>/admin v vašem brskalniku in sledite navodilom (lahko si pomagate z nastavitvami zapisanimi v stari datoteki config.php). Obstoječa podatkovna zbirka bo samodejno zaznana in, če bo to potrebno, nadgrajena po potrditvi.
# Preverite, če boste morali opraviti nekaj ročnega preverjanja, kot je prikazano v nadaljevanju tega dokumenta
# '''Sedaj izbrišite predpomnilnik vašega brskalnika in njegove piškotke!'''
# Končali ste!


<div class="simplebox">'''Posebni pregledi po nadgradnji''':
==Upgrading from version 1.50 or later to any later 2.xx version==
*'''iz katere koli prejšnje različice na 2.xx''': '''predloge''' so bile spremenjene na številnih mestih. Prosimo preverite vašo prilagojeno predlogo, če še vedno izgleda pravilno. Če ne boste morali vašo predlogo ustrezno urediti (preglejte vaše izvirne predloge in ugotovite, kaj je bilo spremenjeno). Proces nadgradnje poskuša v datoteki template.js zamenjati atribute z značko {TEMPLATEJS}. Če se pojavi javascript težava z vašo prilagojeno predlogo, preverite če vaše predloge vsebujejo značko {TEMPLATEJS} v datoteki tartpage.pstpl.
#[http://www.limesurvey.org#download Download] the latest version of LimeSurvey.
*'''iz starejše različice kot je v1.53''': kadar nadgrajujete iz različice starejše od v1.53 na zadnjo različico, prosimo preverite '''globalne pravice za vsakega uporabnika posebej'''. V v1.53 se je uvedla nova pravica '''superadmin''', s katero se je uporabniku lahko dalo enake pravice kot jih ima glavni skrbnik ustvarjen med namestitvijo. Ukazna datoteka za nadgradnjo ugiba, komu dati to pravico v starejših različicah. Ker je to narobe, je to potrebno previdno preveriti.</div>
# Prepare and backup the old installation
## Backup your installation directory files and SQL-based database just in case.
### 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.
### Using phpMyAdmin or similar to export all tables; or use the according '''LimeSurvey Administration''' button [[File:button-export-sql.png]] to backup the entire database
## Copy your '''config.php''' file, modified '''template''' directories and the /upload directory separately for quick access later.
# Replace all the installation directory files
## Delete all old files in the existing installation directory
## Upload and unpack the new code version into the same installation directory
## 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.
## Copy your /upload directory back to the old location
## Double check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''' and and their subdirectories is required) as described in [[Installation#Set_Directory_permissions|Installation]]
## 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.
# Check if any special manual checks apply as listed below
# '''Now clear your browser cache and cookies!'''
# You are done (:biggrin:).


==Nadgradnja iz različice 1.50 ali kasnejše na katero koli kasnejšo  1.xx različico==
 
#[http://www.limesurvey.org/download Prenesi]želeno različico  LimeSurvey-a.
{{Alert|title=Attention|text=If you upgrade from e.g. 1.92, it might be necessary to ''first'' upgrade to latest 1.92, then to 2.00, then to 2.06, and then finally to the latest version (e.g. 2.55.x).}}
# Pripravi in ustvari kopije trenutne namestitve
 
## Za vsak primer ustvari kopije map, datotek in SQL podatkovne zbirke.
<div class="simplebox">'''Special checks after an upgrade''':
### V ukaznem oknu ustvarite .zip ali podoben arhiv celotne namestitve (datotek in mapne strukture). Na primer v linux-u bo ukaz tar cvzf foo.tgz cps100 pripravil arhiv vseh cps100 map.
*'''from any earlier version to 2.xx''':
### Z uporabo phpMyAdmin ali podobnega orodja izvozite vse tabele; ali uporabite ustrezen gumb za '''LimeSurvey-eve skrbnike''' [[File:button-export-sql.png]] za izdelavo kopije celotne podatkovne zbirke
**The '''templates''' have been changed in a lot of places. Please check your customized templates if they are still looking right. If not you will have to edit your templates accordingly (check out the original templates to see what was changed). The upgrade process tries to replace the template.js inclusion by the placeholder {TEMPLATEJS}. If you have javascript issue with your custom template, verify if your template have the placeholder {TEMPLATEJS} in startpage.pstpl.
## Kopirajte vašo datoteko '''config.php''', mape prilagojenih  '''predlog''' in mape /upload za kasnejši hiter dostop do njih.
**Proper question codes are mandatory, now. After upgrade check the survey logic of all surveys and correct the codes where necessary.
# Zamenjajte vse datoteke v mapi installation
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing who to give this right to in the older versions.  As this is not perfect, it should be carefully checked.
## Izbrišite vse stare datoteke v obstoječi mapi installation
*'''from any earlier version to v2.06''': From 2.05 to 2.06 some unused permissions when editing global permission for 'surveys' were activated. So if a user has any permission besides the 'create' they will be able to apply this additional permission on other surveys then their own. So please check the global permission of admin users that should only be able to see their own surveys and make sure they only have the 'create' permission assigned for 'surveys'.
## Naložite in razpakirajte datoteke nove različico v isto mapo installation
</div>
## Uredite ali zamenjajte datoteko '''config.php''':
 
### V kolikor je bila vaša prejšnja različica < 1.70: uredite novo datoteko '''config.php'''tako, da bo odražala spremenjene nastavitve v  prejšnji datoteki '''config.php'''. '''Ne samo prepisati (prekopirati) nove datoteke '''config.php''' z arhivirano!'''
==Upgrading from version 1.50 or later to any later 1.xx version==
### V kolikor je bila vaša prejšnja različica >= 1.70: enostavno zamenjajte novo datoteko '''config.php''' z vašo arhivirano datoteko '''config.php''' (ker se oblika datoteke v teh različicah ni spremenila).
#[http://www.limesurvey.org/download Download] the desired version of LimeSurvey.
## V kolikor je bila vaša prejšnja različica starejša od 1.90: kopirajte vse prilagojene predloge v mapo /upload/templates - prav tako boste morali spremeniti ime vsaki mapi predloge, katere ime se ujema obstoječi predlogi v mapi /templates.
# Prepare and backup the old installation
## Kopirajte vašo mapo /upload nazaj na staro mesto
## Backup your installation directory files and SQL-based database just in case.
## Dvakrat preverite nastavitve '''pravic''' na mapah (mape '''/tmp''', '''/upload''' in njihove podmape morajo vključevati pravico pisanja) kot je opisano v [http://docs.limesurvey.org/tiki-index.php?page=Installation&structure;=English+Instructions+for+LimeSurvey#Set_Directory_permissions navodilih za namestitev]
### At the command-line level, make a '''.zip''' or similar archive of the whole installation directory tree of files. e.g. tar cvzf foo.tgz cps100 will tar and zip the whole of the cps100 directory
# Zaključevanje namestitve
### Using phpMyAdmin or similar to export all tables; or using the '''LimeSurvey Administration''' button [[File:button-export-sql.png]] to backup the entire database
## Ko enkrat odprete URL vašega skrbniškega dela LimeSurvey-a, se bodo po ustrezni potrditvi podatkovne zbirke posodobile samodejno
## Copy your '''config.php''' file ,modified '''template''' directories and the /upload directory separately for quick access later.
## Odstranite ali preimenujte mapo '''/admin/install''' kot je (če je) to v navodilih namestitvene zagonske datoteke
# Replace all the installation directory files
## Preverite, če boste morali opraviti nekaj ročnega preverjanja, kot je prikazano v nadaljevanju tega dokumenta
## Delete all old files in the existing installation directory
# Končali ste! Če boste opazili kakšne težave po namestitvi: izbrišite predpomnilnik (chache) vašega brskalnika in piškotke (cookies)!
## Upload and unpack the new code version into the same installation directory
## Edit or replace the '''config.php''' file:
### If your previous version was < 1.70: Edit the new '''config.php''' to reflect changed settings in the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
### If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' (as the file format has not changed).
## 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.
## Copy your /upload directory back to the old location
## Double check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''' and and their subdirectories is required) as described in [[Installation#Set Directory permissions|Installation]]
# Finishing the installation
## Once you open the URL to your LimeSurvey administration the database tables will be updated after confirmation
## Remove or rename the '''/admin/install''' directory as/if instructed by the installation script
## Check if any special, manual checks apply as listed below
# You are done (:biggrin:). If you notice any problems after the upgrade: Clear your browser cache and cookies!


<div class="simplebox">'''Posebni pregledi po nadgradnji:''':
<div class="simplebox">'''Posebni pregledi po nadgradnji:''':

Revision as of 15:18, 30 January 2017

Dodatne strani:{toc}

Preden začnete...

... preberite to zelo pomembno sporočilo: Vedno shranite kopijo datotek in podatkovno zbirko (bazo) vaše trenutno nameščene različice LimeSurvay-a!!

To lahko storite s pomočjo skrbniškega orodja za delo s podatkovnimi zbirkami kot je phpMyAdmin itd. in upravljalnika datotek (file manager)! Če ne veste, kako se to naredi, je bolje da ne nadaljujete pač pa prosite nekoga, ki to zna ali pa namesto tega uporabite orodje ComfortUpdate.

Hitri način (za manjše spremembe v različicah)

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/directory except for
    • /application/config/config.php
    • /upload directory
  • Copy the new files from the new LimeSurvey package to the existing location.
  • Open the admin page in your brower, 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!

Temeljitejši način (za večje preskoke v različicah)

Žal je potrebno premisliti kar nekaj stvari, zato prosimo da pregledate navodila v nadaljevanju zelo pozorno.

Upgrading from version 2.0x to 2.50 or later

  • Please note that the template structure has changed. Your old templates will not be working anymore as the template system is now using responsive templates.

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. Using phpMyAdmin or similar to export all tables; or use the according 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. 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.
    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 and their subdirectories is required) as described in Installation
    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.
  4. Check if any special manual checks apply as listed below
  5. Now clear your browser cache and cookies!
  6. You are done (:biggrin:).


  Attention : If you upgrade from e.g. 1.92, it might be necessary to first upgrade to latest 1.92, then to 2.00, then to 2.06, and then finally to the latest version (e.g. 2.55.x).


Special checks after an upgrade:
  • from any earlier version to 2.xx:
    • The templates have been changed in a lot of places. Please check your customized templates if they are still looking right. If not you will have to edit your templates accordingly (check out the original templates to see what was changed). The upgrade process tries to replace the template.js inclusion by the placeholder {TEMPLATEJS}. If you have javascript issue with your custom template, verify if your template have the placeholder {TEMPLATEJS} in startpage.pstpl.
    • Proper question codes are mandatory, now. After upgrade check the survey logic of all surveys and correct the codes where necessary.
  • from a version earlier than v1.53: When upgrading from a version before v1.53 to the latest version, please check the global user rights of each user. There was a new superadmin right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing who to give this right to in the older versions.  As this is not perfect, it should be carefully checked.
  • from any earlier version to v2.06: From 2.05 to 2.06 some unused permissions when editing global permission for 'surveys' were activated. So if a user has any permission besides the 'create' they will be able to apply this additional permission on other surveys then their own. So please check the global permission of admin users that should only be able to see their own surveys and make sure they only have the 'create' permission assigned for 'surveys'.

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. e.g. tar cvzf foo.tgz cps100 will tar and zip the whole of the cps100 directory
      2. Using 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 to reflect changed settings in 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 (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 (write access to /tmp, /upload and and their subdirectories is required) as described in Installation
  4. Finishing the installation
    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
  5. You are done (:biggrin:). If you notice any problems after the upgrade: Clear your browser cache and cookies!
Posebni pregledi po nadgradnji::
  • iz poljubne starejše različice od 1.92: predloge so bile spremenjene na številnih mestih. Prosimo preverite vašo prilagojeno predlogo, če še vedno izgleda pravilno. Če ne boste morali vašo predlogo ustrezno urediti (preglejte vaše izvirne predloge in ugotovite, kaj je bilo spremenjeno).
  • iz različice starejše od v1.53: kadar izvajate nadgradnjo iz različice starejše od v1.53 na zadnjo različico, prosimo preverite globalne pravice za vsakega uporabnika posebej. V v1.53 se je uvedla nova pravica superadmin s katero se je uporabniku lahko dalo enake pravice kot jih ima glavni skrbnik ustvarjen med namestitvijo. Ukazna datoteka za nadgradnjo ugiba, komu dati to pravico v starejših različicah. Ker je to narobe, je to potrebno previdno preveriti.

Nadgradnja iz različice starejše od v1.50 (od v1.0 do v1.44)

Ker se je spremenila oblika podatkov in ogromno drugih zadev, nadgradnja iz različic starejših od v1.50 NI možna.  Če imate datoteke s staro obliko predpone *.sql, jih lahko dobite v novejšo različico le tako, da namestite različico 1.50, uvozite v njo .sql datoteke, in potem nadgradite to različico na zadnjo različico LimeSurvey-a. Za več informacij si oglejte stran prenos namestitev.

Nadgradnja - Pogosta vprašanja in odgovori

Katera je še zadnja najbolj aktualna različica LimeSurvey-a, ki še vedno podpira PHP4?

Zadnja različica, ki je še ponujala podporo za PHP4, je bila različica 1.82+.

Lahko izvedem nadgradnjo tudi če imam aktivne ankete?

Da lahko. Morda so omenjene izjeme med navodili zgoraj. Močno priporočamo testiranje vaših anket po izvedeni nadgradnji, da preverite če vaša oblika predlog še vedno zgleda vredu.

Kateri je najboljši način za prenos LimeSurvey-evih anket z obliko *.sql v zadnjo različico?

Namestite različico 1.50, uvozite datoteke in izvozite obliko anket v novejšo .csv obliko. Novejše različice še vedno znajo brati ankete s .csv obliko.