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.

Сделайте резервную копию существующих файлов и базы данных
While the upgrade scripts are well-maintained and robust, things could still go pear-shaped. Before proceeding to update the database schema, make a full backup of the wiki, including both the database and the files:


 * the wiki's content, from the database. It may be a good idea to create an XML dump in addition to the SQL database dump.
 * images and other media files (the contents of the images directory)
 * configuration files, i.e. LocalSettings.php and AdminSettings.php (if present)
 * MediaWiki's program files, including all skins and extensions, especially if you modified them.

See Manual:Backing up a wiki for instructions.

Распакуйте новые файлы
If using a tarball package, decompress it; if using Subversion, export the files into a clean location. Replace all existing files with the new versions from 1.11, preserving the directory structure. The core code is now up to date.

Запустите скрипт обновления
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 и проверьте, что версия отображается корректно.