Обновление с предыдущей версии

Дополнительные страницы:{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 в существующую директорию
• После обновления: очистите кэш браузера и куки!

Note: If you have any customized templates in /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!

Тщательный способ (для серьезных обновлений)

Пожалуйста, изучите данную страницу внимательно, т.к., к сожалению, существует несколько случаев развития событий при данной манипуляции.

Обновление с 1.50 или старше до любой 2.xx или старше

1. Скачайте последнюю версию LimeSurvey.
2. Сделайте резервную копию старой системы.
   1. Сделайте копии файлов из каталога с установленной системой и, на всякий случай, сделайте дамп базы данных.
      1. В командной строке извлеките все файлы и каталоги из скачанного архива.
      2. С помощью phpMyAdmin или любым другим аналогичным способом произведите экспорт всех таблиц; или воспользуйтесь кнопкой в LimeSurvey административной панели , чтобы сделать резервную копию базы данных
   2. Скопируйте Ваш config.php файл, измененный шаблон директории и папку /upload отдельно для быстрого доступа позднее.
3. Замените все установочные папки и файлы
   1. Удалите все старые файлы в существующей директории установки
   2. Выгрузите и распакуйте новую версию кода в ту же папку
   3. Если Ваша старая версия была старше чем 1.90: скопируйте настроенные шаблоны в /upload/templates - Вам вскоре потребуется переименовать каждую директорию с шаблоном, чьи имена совпадают с существующими шаблонами в папке /templates.
   4. Скопируйте Вашу директорию /upload обратно на старое место
   5. Проверьте разрешения установленные на директории (доступ на запись для /tmp, /upload и их дочерние каталоги если требуется) как было описано в установке
   6. Откройте http://<ваш_домен>/<каталог_limesurvey>/admin в Вашем браузере и следуйте инструкциям (Вы можете использовать старый config.php как пример). Будет автоматически определена существующая база данных и, если потребуется, обновлена после подтверждения.
4. Проконтролируйте на предмет наличия специальных ручных проверок среди перечисленных ниже:
5. Сейчас очистите кэш браузера и куки!
6. Все готово! (:biggrin:).

  Please note that the template structure has changed with the update from 2.0x to 2.50 or later. Your old templates will not be working anymore as the template system is now using responsive templates.

Специальные проверки после обновления:

• с любой ранней версии до 2.xx: шаблоны были изменены во множестве мест. Проверьте Ваши настроенные шаблоны на корректность отображения. Если нет, то исправьте их (согласно имеющимся стандартным шаблонам). Процесс обновления пытался заменить template.js включением заполнителя {TEMPLATEJS}. Если у Вас возникли проблемы с JavaScript в пользовательских шаблонах, проверьте есть ли в Вашем шаблоне метка заполнитель {TEMPLATEJS} в шаблоне стартовой страницы startpage.pstpl.
• с версии младше чем v1.53: При обновлении с версии младше v1.53 до последней версии, пожалуйста, проверьте глобальные права пользователей для каждого. Если там уже был superadmin введенный в v1.53, то это может дать пользователю те же привилегии, что и у главного аккаунта администратора созданного во время установки. Скрипт обновления пытается догадаться, кому дать подобные права в старой версии системы. Т.к. он не совершенен, то результат его деятельности должен быть проверен.

Обновление с версии 1.50 или позже до любой версии 1.xx или позже

1. Скачайте желаемую версию LimeSurvey.
2. Сделайте резервную копию старой системы.
   1. Сделайте копии файлов из каталога с установленной системой и, на всякий случай, сделайте дамп базы данных.
      1. В командной строке извлеките все файлы и каталоги из скачанного архива.
      2. С помощью phpMyAdmin или любым другим аналогичным способом произведите экспорт всех таблиц; или воспользуйтесь кнопкой в LimeSurvey административной панели , чтобы сделать резервную копию базы данных
   2. Скопируйте Ваш config.php файл, измененный шаблон директории и папку /upload отдельно для быстрого доступа позднее.
3. Замените все установочные папки и файлы
   1. Удалите все старые файлы в существующей директории установки
   2. Выгрузите и распакуйте новую версию кода в ту же папку
   3. Отредактируйте или замените файл config.php:
      1. Если Ваша старая версия была < 1.70: Отредактируйте новый config.php чтобы установить измененные значения как в старом config.php. Не перезаписывайте новый файл config.php старым!!!
      2. Если Ваша старая версия была >= 1.70: Просто замените новый config.php старым config.php из бэкапа (т.к. формат файла не изменился).
   4. Если Ваша старая версия была старше чем 1.90: скопируйте настроенные шаблоны в /upload/templates - Вам вскоре потребуется переименовать каждую директорию с шаблоном, чьи имена совпадают с существующими шаблонами в папке /templates.
   5. Скопируйте Вашу директорию /upload обратно на старое место
   6. Проверьте разрешения установленные на директории (доступ на запись для /tmp, /upload и их дочерние каталоги если требуется) как было описано в установке
   7. Завершение установки
   8. После того, как Вы перейдете по ссылке на Ваш LimeSurvey административную часть, таблицы базы данных будут обновлены после подтверждения.
4. Удалите или переименуйте каталог /admin/install как в инструкции по установке скрипта.
   1. Проконтролируйте на предмет наличия специальных ручных проверок среди перечисленных ниже:
5. Все готово! (:biggrin:). Если появились любые примечания после обновления: очистите кэш браузера и куки!

Специальные проверки после обновления:

• с любой ранней версии до 1.92: шаблоны были изменены во множестве мест. Проверьте Ваши настроенные шаблоны на корректность отображения. Если нет, то исправьте их (согласно имеющимся стандартным шаблонам).
• с версии младше чем v1.53: При обновлении с версии младше v1.53 до последней версии, пожалуйста, проверьте глобальные права пользователей для каждого. Если там уже был superadmin введенный в v1.53, то это может дать пользователю те же привилегии, что и у главного аккаунта администратора созданного во время установки. Скрипт обновления пытается догадаться, кому дать подобные права в старой версии системы. Т.к. он не совершенен, то результат его деятельности должен быть проверен.

Обновление с версии младше чем 1.50 (v1.0-v1.44)

Постольку поскольку структура данных и множество других вещей были изменены, обновление с любой версии до v1.50 не представляется возможным. Если же у Вас есть старая структура данных в *.sql файле, то импортировать ее в новую версию можно установив версию 1.50, произвести импорт туда *.sql файла и затем обновив систему до самой свежей версии LimeSurvey. Также смотрите страницу Перенос установки для получения детальной информации.

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.