Manual:Upgrading to 1.13/ru

From mediawiki.org


Скачать установочный пакет

Стабильная версия (MediaWiki 1.41 )

Наследуемые версии (MediaWiki 1.40 )

Альфа-версия (MediaWiki 1.43 )

Дополнительная информация:

Эта страница посвящена процедуре обновления MediaWiki до версии 1.13, самой свежей версии на сегодня.

Обзор[edit]

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

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

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

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

MediaWiki 1.13 требует:

PHP[edit]

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

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

или

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

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

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

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

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

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

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

Использование tarball package[edit]

Если вы загрузили *.tar архив, распакуйте его (например, при помощи WinRAR) на том же сервере, где находится старая версия mediawiki. При распаковке tarball-пакета обычно создаётся новый каталог для новой версии вики и вы сможете скопировать новые файлы и каталоги в свой текущий вики-каталог. Способ сделать это в один проход:

$ tar xvfz mediawiki-1.13.0.tar.gz -C /path/to/your/wiki/ --strip-components=1

Для старых дистрибутивов Linux (как, например, RHEL/CentOS 4.x) используйте:

$ tar xvfz mediawiki-1.13.0.tar.gz -C /path/to/your/wiki/ --strip-path=1

Использование Subversion[edit]

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

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

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

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

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

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

$ php update.php

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

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

Если прав на базу данных недостаточно или shell-доступ недоступен, попробуйте использовать phpShell, эмулирующий командную строку посредством PHP функций. Это может не сработать для инсталляций, размещённых на закрытых хостинг-площадках (locked-down hostings).

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

$ php update.php --quick

Возможно, вам придется использовать "php5" вместо "php", если установлены разные версии. При использовании phpshell, файлы commandLine.inc и LocalSettings.php возможно придётся отредактировать, так как иначе скрипт может не завершиться я из-за того, что phpshell был получен с веб-сервера.

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

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

  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.13. Убедитесь, что обновили такие расширения до их последних версий. Вполне возможно, что вам потребуется вручную выполнить обновления некоторых расширений.

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

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

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