Actions

Надграждане от предишна версия

From LimeSurvey Manual

Revision as of 09:04, 21 November 2023 by Maren.fritz (talk | contribs) (Created page with "= Надграждане чрез CLI =")
Допълнителни страници:{toc}

Преди да започнете

... прочетете това, защото е много важно: Винаги архивирайте файловете и базата данни на текущата си инсталация!

Можете да направите това с помощта на инструмент за администриране на база данни като phpMyAdmin и файлов мениджър! Ако не знаете как да направите това, не трябва да продължавате по-нататък и да попитате някой, който знае.

Препоръка за използване на ComfortUpdate

Най-лесният/безопасен начин за надграждане е да използвате нашата услуга ComfortUpdate.

Инструкции за надграждане (от 2.x или по-нова до всяка следваща версия)

Моля, следвайте тези инструкции:

  • Архивирайте вашите файлове и база данни (споменахме ли вече това?).
  • Изтрийте всички стари файлове/ папки с изключение на:
    • /application/config/security.php -Важно!! Това е ключът към всички криптирани данни в LimeSurvey (версия 4 и по-нова)
    • /application/config/config.php;
    • /upload directory
Забележка:' Ако имате някакви персонализирани шаблони в /upload/templates, уверете се, че сте ги 'опреснявали' с всички промени, които идват с новата версия на LimeSurvey. Най-лесният начин да проверите за такива промени е да сравните във файл стария си шаблон с новата версия на шаблона по подразбиране. Ако видите разлики, различни от вашите персонализации, необходимо е опресняване.
  • Копирайте новите файлове от новия пакет LimeSurvey в съществуващото местоположение.
  • Отворете страницата на администратора във вашия браузър (напр. https://www.example.com/limesurvey/admin) и проверете дали има база данни надстройката на схемата е необходима.
  • След надстройката: Изчистете кеша и бисквитките на браузъра си!

Инструкции за по-стари версии

За съжаление има няколко неща, които трябва да имате предвид, така че, моля, прочетете внимателно следните инструкции.

Надстройка от версия 1.50 или по-нова до която и да е по-късна версия 2.xx

  • Изтегляне най-новата версия на LimeSurvey
  • Архивирайте вашите файлове и база данни (споменахме ли вече това?).
  • Заменете всички файлове на инсталационната директория
    • Изтрийте всички стари файлове в съществуваща инсталационна директория
    • Качете и разопаковайте новите файлове на новата версия в същата инсталационна директория
    • Ако предишната ви версия е по-стара от 1.90, копирайте всички персонализирани шаблони в /upload/templates - вие също ще трябва да преименувате всяка шаблонна директория, чието име съвпада със съществуващ шаблон в /templates
    • Копирайте вашата /upload директория обратно на старото местоположение
    • Проверете отново permissions, зададени в директориите (необходим е достъп за запис до /tmp, /upload и техните поддиректории), както е описано в wiki за инсталиране
    • Отворете http://<yourdomain> /<yourlimesurveydir> /admin във вашия браузър и следвайте инструкциите (Ще намерите данните от базата данни в стария config.php). Съществуващата база данни ще бъде автоматично открита и, ако е необходимо, надстроена след потвърждение.
  • Проверете дали се прилагат някакви специални ръчни проверки, както е изброено по-долу
  • Сега изчистете кеша на браузъра и бисквитките и сте добре да тръгвам
  Внимание : Моля, обърнете внимание, че структурата на шаблона се промени с актуализацията от 2.0x на 2.50 или по-нова. Вашите стари шаблони вече няма да работят, тъй като системата за шаблони вече използва адаптивни шаблони.


Специални проверки след надграждане:
  • от която и да е по-ранна версия до 2.xx: Правилните кодове за въпроси вече са задължителни. След надграждане на инсталацията проверете логиката на проучването на всички проучвания и коригирайте кодовете, където е необходимо
  • от версия, по-стара от v1.53: При надграждане от версия преди v1.53 до най-новата версия , моля, проверете глобалните потребителски права на всеки потребител. Във версия 1.53 беше въведено ново superadmin право, което може да даде на потребителя същата привилегия като главния административен акаунт, създаден по време на инсталацията. Скриптът за надграждане отгатва на кого трябва да бъде дадено това разрешение в по-старите версии. Тъй като това не е перфектно, трябва внимателно да се провери.
  • от всяка по-ранна версия до v2.06: От 2.05 до 2.06, някои неизползвани разрешения при редактиране на глобални разрешения за 'проучвания' бяха активирани. Например, ако даден потребител е имал само разрешението „създаване“ във 2.05, другите разрешения, разположени вдясно от „създаване“, също ще бъдат активирани с актуализацията до 2.06 (Преглед/четене, Актуализиране, Изтриване, Импортиране, Експортиране). Моля, проверете дали администраторските потребители са получили други глобални разрешения освен „оригиналните“ след актуализацията. Ако да, моля, редактирайте ги съответно.

Надстройка от версия 1.50 или по-нова до която и да е по-късна версия 1.xx

  • Изтегляне желаната версия на LimeSurvey
  • Архивирайте вашите файлове и база данни (споменахме ли вече това?).
  • Заменете всички файлове на инсталационната директория
    • Изтрийте всички стари файлове в съществуваща инсталационна директория
    • Качете и разопаковайте новата версия на кода в същата инсталационна директория
    • Редактирайте или заменете config.php файла:
      • Ако вашата предишна версия беше < 1.70: Редактирайте новия config.php, за да отразите промените от архивния файл config.php'. Не презаписвайте просто новия config.php със стария!
      • Ако предишната ви версия е била >= 1.70: Просто сменете новата config. php с вашия резервен файл config.php (тъй като файловият формат не е променен)
    • Ако предишната ви версия е била по-стара от 1.90: Копирайте всички персонализирани шаблони в /upload/templates - ще трябва също така да преименувате всяка шаблонна директория, чието име съвпада със съществуващ шаблон в /templates
    • Копирайте вашата /upload директория обратно на старото местоположение
    • Проверете два пъти набора permissions' в директориите на LimeSurvey (необходим е достъп за запис до /tmp, /upload и до техните поддиректории), както е описано в wiki за инсталиране
  • Завършете процеса на инсталиране/надграждане
    • След като отворите URL адреса към вашата администрация на LimeSurvey, таблиците на базата данни ще бъдат актуализирани след потвърждение
    • Премахнете или преименувайте директорията /admin/install като/ако инструктиран от инсталационния скрипт
    • Проверете дали се прилагат специални ръчни проверки (както е посочено по-долу)
Специални проверки след надграждане:
  • От версия, по-стара от v1.53: Когато надграждате от версия преди v1.53 до най-новата версия, моля, проверете „глобални потребителски права“ на всеки потребител. Във версия 1.53 беше въведено ново superadmin право, което може да даде на потребителя същата привилегия като главния административен акаунт, създаден по време на инсталацията. Скриптът за надграждане отгатва на кого трябва да бъде дадено това разрешение в по-старите версии. Тъй като това не е перфектно, трябва да се провери внимателно.

Надстройка от версия по-стара от v1.50 (v1.0 до v1.44)

Тъй като структурата на данните и много други неща бяха променени, надграждането от всяка версия преди v1.50 НЕ е възможно'. Ако имате стари структурни файлове за проучване с разширение *.sql, единственият начин да ги поставите в по-нова версия е да инсталирате версия 1.50 , импортирайте .sql файла(овете) там, след което надстройте тази версия до най-новата версия на LimeSurvey. Вижте страницата, свързана с как може да се прехвърли инсталация за повече подробности.

Надграждане чрез CLI

You can upgrade the database via the PHP CLI: php application/commands/console.php updatedb. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

Failed database upgrade after manual update/ComfortUpdate

Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade. That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

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. This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

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

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.

FAQ

Can I upgrade even if I have active surveys?

Yes, you can. Exceptions may be mentioned in the thorough instructions above. We strongly advise to test your surveys after upgrade to check if your design templates still work alright.

How to convert *.sql/*.csv survey structure files to the latest LimeSurvey version?

Install version 1.50, import the file, and export the survey structure to the newer .csv format. Then install the latest Version 2.x and import the .csv format and export it to the current .lss format.