Upgrading from a previous version/ru: Difference between revisions
From LimeSurvey Manual
Updating to match new version of source page |
Updating to match new version of source page |
||
| Line 1: | Line 1: | ||
<languages /> <div style="float:right;"><div class="simplebox">Дополнительные страницы:{toc}</div></div>__ОГЛАВЛЕНИЕ__ | <languages /> <div style="float:right;"><div class="simplebox">Дополнительные страницы:{toc}</div></div>__ОГЛАВЛЕНИЕ__ | ||
<span id="Before_you_start..."></span> | |||
=Перед началом...= | =Перед началом...= | ||
| Line 9: | Line 10: | ||
</div> | </div> | ||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
==Recommendation to use ComfortUpdate== | ==Recommendation to use ComfortUpdate== | ||
'''The easiest/safest way to upgrade is to use our [[ComfortUpdate]] service.''' | '''The easiest/safest way to upgrade is to use our [[ComfortUpdate]] service.''' | ||
</div> | |||
<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span> | |||
<div class="mw-translate-fuzzy"> | <div class="mw-translate-fuzzy"> | ||
=Быстрый способ(для обновления с минорных версий)= | =Быстрый способ(для обновления с минорных версий)= | ||
| Line 25: | Line 29: | ||
*'''После обновления: очистите кэш браузера и куки!''' | *'''После обновления: очистите кэш браузера и куки!''' | ||
</div> | </div> | ||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
<div class=" | #Log out of the administration | ||
#Backup your files and database | |||
#Delete all the old files/folders except for: | |||
##/application/config/security.php - '''Important!! This is the key to all encrypted data in LimeSurvey (version 4 and later)''' | |||
##/application/config/config.php; | |||
##/upload directory | |||
#Copy the new files from the new LimeSurvey package to the existing location. | |||
#Now clear your browser cache and cookies. | |||
#Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin). If a database scheme upgrade is necessary you will be prompted to confirm it. | |||
#Done! | |||
</div> | </div> | ||
<div class="mw- | <div lang="en" dir="ltr" class="mw-content-ltr"> | ||
<div class="simplebox">[[File:help.png]]'''Note:''' Between major versions (for example from version 3 to 4) the template/design themes change usually completely. Old survey design templates/themes will usually not work anymore.</div> | |||
</div> | </div> | ||
<div class="mw- | <div lang="en" dir="ltr" class="mw-content-ltr"> | ||
== | = Upgrading using CLI = | ||
</div> | </div> | ||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended. | |||
<div | |||
</ | |||
</div> | </div> | ||
= | <div lang="en" dir="ltr" class="mw-content-ltr"> | ||
= Failed database upgrade after manual update/ComfortUpdate= | = 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. | 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!) | 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!) | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
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. | 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. | This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate. | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
Please execute the following steps: | Please execute the following steps: | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
*Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup) | *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. | *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. | *Delete the old database and restore the database from the original (1st) backup. | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
That's it. Everything should be back to normal. | That's it. Everything should be back to normal. | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
'''A note about reporting this issue:''' | '''A note about reporting this issue:''' | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
If you run into a problem like this, please always report this in our bug tracker at https://bugs.limesurvey.org | If you run into a problem like this, please always report this in our bug tracker at https://bugs.limesurvey.org | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
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. | 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. | ||
</div> | |||
<span id="FAQ"></span> | |||
=Обновление: часто задаваемые вопросы= | =Обновление: часто задаваемые вопросы= | ||
<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span> | |||
==Могу ли я обновиться в то время как у меня есть активные опросы?== | ==Могу ли я обновиться в то время как у меня есть активные опросы?== | ||
Да, Вы можете. Исключения в данном случае указаны в указанной выше инструкции. Мы настоятельно рекомендуем проверить Ваши шаблоны на работоспособность. | Да, Вы можете. Исключения в данном случае указаны в указанной выше инструкции. Мы настоятельно рекомендуем проверить Ваши шаблоны на работоспособность. | ||
<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span> | |||
<div class="mw-translate-fuzzy"> | <div class="mw-translate-fuzzy"> | ||
==Какой самый лучший способ портирования структуры *.sql файлов в последнюю версию LimeSurvey?== | ==Какой самый лучший способ портирования структуры *.sql файлов в последнюю версию LimeSurvey?== | ||
Latest revision as of 12:07, 25 February 2025
Дополнительные страницы:{toc}
__ОГЛАВЛЕНИЕ__
Перед началом...
... прочтите, потому что это очень важно: Всегда делайте резервную копию файлов и базы данных текущей установки!
Вы можете сделать это при помощи инструментов администрирования БД, например, phpMyAdmin и файл-менеджера! Если Вы не знаете как это сделать, то Вам не следует продолжать самостоятельно, а попросить кого либо кто знает или воспользоваться вместо этого комфортным обновлением.
Recommendation to use ComfortUpdate
The easiest/safest way to upgrade is to use our ComfortUpdate service.
Быстрый способ(для обновления с минорных версий)
Вы можете использовать данные инструкции, если Вы делаете обновление с минорной версии (например, с 2.00 до 2.01)
- сделайте резервную копию файлов и базы данных(мы ведь уже обсуждали это, не так ли?)
- удалите все старые файлы/директории, за исключением
- /application/config/config.php
- /upload каталога
- скопируйте новые файлы из архива с LimeSurvey в существующую директорию
- После обновления: очистите кэш браузера и куки!
- Log out of the administration
- Backup your files and database
- Delete all the old files/folders except for:
- /application/config/security.php - Important!! This is the key to all encrypted data in LimeSurvey (version 4 and later)
- /application/config/config.php;
- /upload directory
- Copy the new files from the new LimeSurvey package to the existing location.
- Now clear your browser cache and cookies.
- Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin). If a database scheme upgrade is necessary you will be prompted to confirm it.
- Done!
Note: Between major versions (for example from version 3 to 4) the template/design themes change usually completely. Old survey design templates/themes will usually not work anymore.Upgrading using 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.
Обновление: часто задаваемые вопросы
Могу ли я обновиться в то время как у меня есть активные опросы?
Да, Вы можете. Исключения в данном случае указаны в указанной выше инструкции. Мы настоятельно рекомендуем проверить Ваши шаблоны на работоспособность.
Какой самый лучший способ портирования структуры *.sql файлов в последнюю версию LimeSurvey?
Установить версию 1.50, импортировать файл и экспортировать структуру опросов в новый .csv формат. Последняя версия сможет прочитать структуру опроса в .csv формате.
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.