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

Дополнительные страницы:{toc}

__ОГЛАВЛЕНИЕ__

Перед началом...

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

Вы можете сделать это при помощи инструментов администрирования, например, phpMyAdmin и менеджера файлов! Если Вы не знаете как это сделать, то Вам не следует продолжать самостоятельно, а попросить кого либо кто знает или воспользоваться вместо этого комфортным обновлением.

Быстрый способ(для обновления с минорных версий)

Вы можете использовать данные инструкции, если Вы делаете обновление с минорной версии (например, с 2.00 до 2.01)

• сделайте резервную копию файлов и базы данных(мы ведь уже обсуждали это, не так ли?)
• удалите все старые файлы/директории, за исключением
  • /application/config/config.php
  • /upload каталога
• скопируйте новые файлы из архива с LimeSurvey в существующую директорию
• После обновления: очистите кэш браузера и куки!

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

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

Обновление с 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:).

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.
• 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.

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!

Special checks after an upgrade:

• from any earlier version to 1.92: 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)
  
• 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.

Upgrading from a version earlier than v1.50 (v1.0 through 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. See the also then page Transferring an installation for more details.

Upgrade FAQ

What is the most actual LimeSurvey version that still supports PHP4?

The last release offering PHP4 support was version 1.82+.

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.

What is best way to port LimeSurvey *.sql survey structure files to the latest version?

Install version 1.50, import the file and export the survey structure to the newer .csv format. The latest version still can read the .csv survey structure format.