Manual:Upgrading to 1.11/ru



Лето. Беззаботное время, заполненное светом, конференцией «Викимания», и конечно же — новой версией MediaWiki. Захватите мороженое и расслабьтесь; мы обеспечили традиционную инструкцию для того, чтобы вы могли обновить MediaWiki до версии 1.11 не отходя от бассейна.

Обзор
В первую очередь прочтите текстовый файт UPGRADE, включённый в архив MediaWiki 1.11.

Основные шаги — те же, что и для всех прочих обновлений MediaWiki:


 * 1) Проверьте соответствие требованиям
 * 2) Прочтите примечания к релизу (release notes)
 * 3) Сделайте резервную копию существующих файлов и базы данных
 * 4) Распакуйте новые файлы
 * 5) Запустите скрипт обновления для проверки базы данны
 * 6) Обновите расширения
 * 7) Протестируйте обновление

Проверка требований
MediaWiki 1.11 требует:

PHP

 * PHP версии 5.0.x или выше
 * Мы рекомендуем использовать PHP версии 5.1.x или 5.2.x.
 * Обратите внимание, что PHP версии 5.0.x, работающий под определёнными 64-битными платформами, содержит ошибки, которые вызывают фундаментальные проблемы с MediaWiki. Если MediaWiki работает на x86_64 (AMD64, EMT64) или другой зависимой 64-битной платформе, требуется PHP версий 5.1.x или 5.2.x.

DBMS

 * MySQL версии 4.0.x или выше
 * Версия MySQL 3.x не поддерживается начиная с версии 1.6.0 MediaWiki

или


 * PostgreSQL версии 8.1 или выше
 * Вам также потребуются модули tsearch2 и plpgsql

Прочтите примечания к релизу
Где-то внутри дистрибутивного архива (tarball), или среди файлов, полученных или экспортированных из SVN, есть ряд файлов с именами, набранными прописными литерами. Один из них содержит ПРИМЕЧАНИЯ К РЕЛИЗУ (RELEASE-NOTES). Теперь — самое время, чтобы открыть этот файл и узнать то, что изменилось в версии 1.11. Вы можете также прочесть об этих изменениях на странице Release notes/1.11.

Сделайте резервную копию существующих файлов и базы данных
Несмотря на то, что скрипты обновления тщательно отлажены и проверены, всегда остаётся вероятность сбоя. Поэтому перед обновлением базы данных, сделайте полную резервную копию своего вики-проекта, включая резервную копию базы данных, а также файлы:


 * содержимое базы данных вики-проекта; в дополнение к резервной копии SQL-базы данных не повредит сделать и экспорт всех страниц в формате XML.
 * изображения и другие медиа-файлы (находящиеся в каталоге images)
 * конфигурационные файлы, т. е. LocalSettings.php и AdminSettings.php (если есть)
 * программные файлы MediaWiki, включая все стили оформления и расширения, особенно если вы их изменяли.

См. более подробные инструкции в разделе Manual:Backing up a wiki.

Распакуйте новые файлы
Если вы загрузили *.tar архив, распакуйте его (например, при помощи WinRAR); если же вы используете Subversion, экспортируйте файлы в новый (пустой) каталог. Замените все существующие файлы в вашей версии новыми файлами из версии 1.11, сохраняя структуру каталогов. Программный код теперь обновлен.

Запустите скрипт обновления
Note: Make sure there's an AdminSettings.php file in the wiki root, and it's got up to date information in it. The user needs full permissions on the database.

The preferred method of performing the update is using the command-line maintenance script, however, it is also possible to re-run the web-based installer.

Командная строка (shell)
Из командной строки, с использованием SSH, или иным аналогичным образом, войдите в каталог maintenance и выполните сценарий обновления:

$ php update.php

MediaWiki проверит существующую схему и обновит её для работы с новым кодом, добавив при необходимости таблицы или новые поля.

Альтернатива 1: phpShell
If shell access is not available, look at options such as phpShell, which emulates a command prompt using PHP functions. This might not work on some locked-down hosting setups.

When using such a solution, it is often desirable to skip the countdown period at the start of the script. Pass the --quick</tt> option to the update script to do so:

$ php update.php --quick

Альтернатива 2: Перезапуск инсталлятора
An alternative to running the update script from the shell is to re-run the web installer. To do this:


 * 1) Rename LocalSettings.php</tt> to LocalSettings.old.php</tt>
 * 2) Make the config</tt> directory writable by the web server
 * 3) Make sure the database user has full rights to the database
 * 4) Browse to the wiki and start the installer

Fill in the form fields with the same values as was done during the previous version's installation. When the installation process starts, the script will detect existing MediaWiki tables, and upgrade their schema. When this is complete, a new LocalSettings.php</tt> will be generated.


 * 1) Delete the new configuration file
 * 2) Rename LocalSettings.old.php</tt> back to LocalSettings.php</tt>
 * 3) Restore permissions on the config</tt> directory

Обновите расширения
Некоторые расширения были обновлены, чтобы работать с MediaWiki версии 1.11. Убедитесь, что обновили такие расширения до их последних версий. Вполне возможно, что вам потребуется выполнить ручные обновления некоторых расширений.

Протестируйте обновление
Как только обновление завершится, просмотрите вики-сайт и проверьте основные моменты, такие как просммотр и редактирования страниц, — чтобы гарантировать, что всё по-прежнему работает так, как ожидается.

Посетите страницу Special:Version и проверьте, что версия отображается корректно.