Manual:Upgrading to 1.13/ru
Эта страница содержит информацию по обновлению до устаревшей версии MediaWiki. Советуем, по возможности, выполнить обновление до версии 1.41.1. Инструкции для этого можно найти на странице Руководство:Обновление . |
Стабильная версия (MediaWiki 1.41 )
- mediawiki-1.41.1.tar.gz
- mediawiki-1.41.1.zip
- Git-ветка: REL1_41
Наследуемые версии (MediaWiki 1.40 )
- mediawiki-1.40.3.tar.gz
- mediawiki-1.40.3.zip
- Git-ветка: REL1_40
Альфа-версия (MediaWiki 1.43 )
Дополнительная информация:
Эта страница посвящена процедуре обновления MediaWiki до версии 1.13, самой свежей версии на сегодня.
Обзор edit
В первую очередь, прочтите текстовый файл UPGRADE, включённый в архив MediaWiki 1.13.
Основные шаги — те же, что и для всех прочих обновлений MediaWiki:
- Проверьте соответствие требованиям
- Прочтите примечания к релизу (release notes)
- Сделайте резервную копию существующих файлов и базы данных
- Распакуйте новые файлы
- Запустите скрипт обновления для проверки базы данных
- Обновите расширения
- Протестируйте обновление
Проверка требований 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
или
- PostgreSQL версии 8.1 или выше
- Вам также потребуются модули
tsearch2
иplpgsql
, если используется Postgres 8.1 или 8.2- см. также руководство по обновлению Postgres
- Вам также потребуются модули
Прочтите примечания к релизу 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
Если у вас нет возможности работать с командной строкой — перезапустите веб-инсталлятор:
- Переименуйте
LocalSettings.php
вLocalSettings.old.php
- Выдайте веб-серверу права на запись в каталог
config
- Убедитесь, что пользователь базы данных имеет полные права к ней
- С помощью браузера перейдите к своей вики и запустите инсталлятор
Заполните поля формы теми же значениями, что вы вводили при установке предыдущей версии. Когда начнётся процесс установки — скрипт обнаружит существующие таблицы MediaWiki и обновит их схему. После завершения всех процедур будет сгенерирован новый файл LocalSettings.php
.
- Удалите новый конфигурационный файл
- Переименуйте обратно
LocalSettings.old.php
вLocalSettings.php
- Восстановите прежние права доступа на каталог
config
Обновите расширения edit
Некоторые расширения были обновлены, чтобы работать с MediaWiki версии 1.13. Убедитесь, что обновили такие расширения до их последних версий. Вполне возможно, что вам потребуется вручную выполнить обновления некоторых расширений.
Протестируйте обновление edit
Как только обновление завершится, просмотрите вики-сайт и проверьте основные моменты, такие как просмотр и редактирования страниц, — чтобы гарантировать, что всё по-прежнему работает так, как ожидается.
Посетите страницу Special:Version и проверьте, что версия отображается корректно.