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, сохраняя структуру каталогов. Программный код теперь обновлен.

Запустите скрипт обновления
Замечание: убедитесь, что файл AdminSettings.php расположен в корневом вики-каталоге, а также проверьте правильность параметров, указанных в нём.

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

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

$ php update.php

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

Альтернатива 1: phpShell
Если shell-доступ Вам не доступен, попробуйте использовать phpShell, эмулирующий командную строку посредством PHP функций.

При использовании этого метода, часто требуется пропустить обратный отсчёт при старте - добавьте параметр --quick</tt> во время запуска скрипта:

$ php update.php --quick

Альтернатива 2: Перезапуск инсталлятора
Если у Вас нет возможности работать с коммандной строкой - перезапустите веб-инсталлятор:


 * 1) Переименуйте LocalSettings.php</tt> в LocalSettings.old.php</tt>
 * 2) Выдайте веб-серверу права на запись в каталог config</tt>
 * 3) Убедитесь, что пользователь базы данных имеет полные права к ней
 * 4) С помощью браузера перейдите к Вашей вики и запустите инсталлятор

Заполните поля формы теми же значениями, что Вы вводили при установке предыдущей версии. Когда начнётся процесс установки - скрипт обнаружит существующие таблицы MediaWiki и обновит их схему. После завершения всех процедур будет сгенерирован новый файл LocalSettings.php</tt>.


 * 1) Удалите новый конфигурационный файл
 * 2) Переименуйте обратно LocalSettings.old.php</tt> в LocalSettings.php</tt>
 * 3) Восстановите прежние права доступа на каталог config</tt>

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

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

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