Manual:Upgrading to 1.11/ru

From MediaWiki.org

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

Contents 1 Обзор 2 Проверка требований 2.1 PHP 2.2 DBMS 3 Прочтите примечания к релизу 4 Сделайте резервную копию существующих файлов и базы данных 5 Распакуйте новые файлы 6 Запустите скрипт обновления 6.1 Командная строка (shell) 6.2 Альтернатива 1: phpShell 6.3 Альтернатива 2: Перезапуск инсталлятора 7 Обновите расширения 8 Протестируйте обновление

[edit] Обзор

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

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

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

[edit] Проверка требований

MediaWiki 1.11 требует:

[edit] 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.

[edit] DBMS

• MySQL версии 4.0.x или выше

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

или

• PostgreSQL версии 8.1 или выше

  Вам также потребуются модули tsearch2 и plpgsql

[edit] Прочтите примечания к релизу

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

[edit] Сделайте резервную копию существующих файлов и базы данных

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

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

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

[edit] Распакуйте новые файлы

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

[edit] Запустите скрипт обновления

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

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

[edit] Командная строка (shell)

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

$ php update.php

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

[edit] Альтернатива 1: phpShell

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

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

$ php update.php --quick

[edit] Альтернатива 2: Перезапуск инсталлятора

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

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

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

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

[edit] Обновите расширения

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

[edit] Протестируйте обновление

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

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