Manual:Installing MediaWiki/ru

Введение
Здесь описана установка MediaWiki - программного механизма для веб-сайтов, работающих по технологии «вики». После установки MediaWiki вы можете скачать дамп Русской Википедии и получить работающую копию Википедии на своём компьютере. '''См. также:''' Википедия:Как сделать копию Википедии

MediaWiki устанавливает себя с помощью интерактивного PHP-скрипта. Но до того, как запускать этот скрипт, необходимо:
 * Убедиться, что установлены нужные версии Apache, PHP, MySQL.
 * Загрузить программный пакет MediaWiki на сервер.
 * Если необходимо, создать новую базу данных для Вашей вики.
 * Если необходимо, создать аккаунт на Вашем веб-сервере, с помощью инструкции Manual:Installation/Создание системного аккаунта.

Для решения возникающих проблем, обратитесь к Manual:Errors and Symptoms.

= Установка MediaWiki на локальный компьютер с операционной системой Windows =

Прежде чем читать инструкцию дальше, следует учесть, что после установки сервера приложений на компьютер, подключённый к общедоступной сети, любой человек может получить административный доступ к базе данных через phpmyadmin! Чтобы этого избежать, установите firewall (брандмауэр) и закройте от внешнего доступа порты 80, 443 и 3306 перед началом установки. При использовании Windows XP SP2 можно просто включить встроенный брандмауэр — по умолчанию он запрещает любые соединения на любые порты.

Установка сервера приложений
Перед непосредственной установкой MediaWiki вам необходимо установить на компьютер такие приложения как Apache, PHP и MySQL. Начинающие пользователи могут это сделать с помощью установки сервера этих приложений. В качестве сервера приложений можно выбрать STPServer 1.1 или XAMPP.

Следующий текст описывает установку сервера приложений STPServer 1.0.

Скачайте сервер приложений STPServer 1.1. Установите его на ваш компьютер. На вашем компьютере появится дополнительный виртуальный диск. Как правило, это диск T:

Запустите ваш браузер и в строке адреса введите: http://localhost/

Если вы увидели стартовую страницу, то это значит, что установка сервера приложений прошла нормально.

Создание базы данных
На стартовой странице сервера приложений перейдите в панель администрирования: http://admin

В меню выберите MySQL.

В правом окне выберите приложение phpmyadmin.

Запустите http://localhost/phpmyadmin/ — это утилита администрирования MySQL.

В поле справа Язык - Language выберите язык Russian.

В поле Новая база данных впишите имя базы данных (wikidb).

В поле Сравнение выберите utf8_unicode_ci (как вариант utf8_general_ci).

Нажмите кнопку Создать.

Вы должны получить сообщение: База данных wikidb была создана.

Нажмите в браузере кнопку "Назад" и выберите пункт Привилегии.

Нажмите на Добавить нового пользователя.


 * В поле Имя пользователя укажите - wikiuser
 * Для поля Хост из выпадающего списка выберите Локальный или localhost
 * В полях Пароль и Подтверждение укажите пароль пользователя (например 123456)
 * Назначьте глобальные привилегии с помощью ссылки Отметить все

Нажмите кнопку Пошёл.

Вы должны получить сообщение: Был добавлен новый пользователь.

Создание базы данных вручную
Если Вам известен пароль от пользователя root, установочный скрипт MediaWiki сможет создать базу даных автоматически. В этом случае, Вы можете перейти к секции Запуск установочного скрипта. Если же этот пароль Вы не знаете, к примеру если Вы пользуетесь услугами веб-хостера, Вам необходимо создать базу данных вручную. В данный момент MediaWiki поддерживает СУБД MySQL и PostgreSQL.

MySQL

 * Вам необходимо создать базу данных и пользователя, прежде чем устанавливать MediaWiki. Данные операции можно сделать через различные веб-приложения, такие как PhpMyAdmin. Также, Вы можете подключиться к серверу, посредством ssh, и ввести нужные команды в командную строку MySQL.
 * Загрузите и установите MySQL 5.0.
 * Проверьте запустился ли сервер баз данных («/usr/local/mysql/bin/mysqladmin status»), если нет - выполните sudo /usr/local/mysql/bin/safe_mysqld &. (В ОС Fedore Core 5, используйте /usr/bin/mysqld_safe)
 * Администратор также может выполнить скрипт «configure» в корневом каталоге установки. Скрипт создаст начальные таблицы и автоматически запустит демона mysql.
 * Назначьте пароль для пользователя «root» в вашем сервере баз данных: usr/local/mysql/bin/mysqladmin -u root password вашпароль
 * Настройте пользователя MySQL для Вашей Вики - выполните в терминале: /usr/local/mysql/bin/mysql -u root -p mysql
 * Запустится клиент MySQL, с помощью него создайте базу данных для Вики и назначьте пользователю нужные права на неё:

create database wikidb; grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password'; flush privileges; \q

Если СУБД работает не на том же сервере, что и веб-сервер, то пользователю wikiuser необходимо вписать соответствующий параметр. В примере вверху, исправьте localhost на mediawiki.example.com, естественно подставив правильный хост:

grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'mediawiki.example.com' identified by 'password';

Postgres
If you are using Postgres, you will need to either have a database and user created for you, or simply supply the name of a Postgres user with "superuser" privileges to the configuration form. Often, this is the database user named postgres.

The database that MediaWiki will use needs to have both plpgsql and tsearch2 installed. The installer script will try to install plpgsql, but you may need to install tsearch2 yourself. (tsearch2 is used for searching the text of your wiki). Here's one way to do most of the setup. This is for a Unix-like system, and assumes that you have already installed the plpgsql and tsearch2 modules. In this example, we'll create a database named wikidb, owned by a user named wikiuser. From the command-line, as the postgres user, perform the following steps.

createuser -S -D -R -P -E wikiuser (then enter the password) createdb -O wikiuser wikidb createlang plpgsql wikidb

Adding tsearch2 to the database is not a simple step, but hopefully it will already be done for you by whatever packaging process installed the tsearch2 module. In any case, the installer will let you know right away if it cannot find tsearch2.

The above steps are not all necessary, as the installer will try and do some of them for you if supplied with a superuser name and password.

For installing tsearch2 to the wikidb database under Windows, do the following steps: That's it!
 * 1) find tsearch2.sql (probably under .\PostgreSQL\8.x\share\contrib) and copy it to the postgresql\8.x\bin directory;
 * 2) from a command prompt at the postgresql\8.x\bin directory, type "psql wikidb < tsearch2.sql -U wikiuser";
 * 3) it will prompt you for the password for wikiuser;

Point (2) seems only to work on windows, cause on debian linux 4.0 (etch) only user postgres is allowed to use language c. so there it must be called by:

su - postgres -c psql wikidb < tsearch2.sql

afterwards you must grant select rights to wikiuser to the tsearch tables and insert the correct locale.

su - postgres psql -d wikidb -c "grant select on pg_ts_cfg to wikiuser;" psql -d wikidb -c "grant select on pg_ts_cfgmap to wikiuser;" psql -d wikidb -c "grant select on pg_ts_dict to wikiuser;" psql -d wikidb -c "grant select on pg_ts_parser to wikiuser;" psql -d wikidb -c "update pg_ts_cfg set locale = current_setting('lc_collate') where ts_name = 'default' and prs_name='default';"

If you receive an error similar to "ERROR: relation "pg_ts_cfg" does not exist" when executing the above statements, try installing tsearch2 to the wikidb database again, but instead use these two separate steps (and then try the grant statements again):

1) su - postgres 2) psql wikidb -f tsearch2.sql

Загрузка MediaWiki
Загрузите программный пакет MediaWiki с официальной страницы загрузки или с помощью клиента клиента SVN.

С помощью любого подходящего архиватора (7-Zip (открытое ПО), WinZip, WinRAR) распакуйте файлы из архива MediaWiki. Будет создана папка с инсталляционными файлами MediaWiki, например папка mediawiki-1.12.0.

С помощью FTP-клиента (FileZilla (открытое ПО, Windows) или Cyberduck) закачайте файлы на ваш сервер в правильный каталог. Для веб-сервера Apache, путь до каталога с веб-сайтами прописывается в файле. Также, вы можете скопировать файлы в любой каталог на вашем сервере и сделать символьную ссылку на эту папку из веб-директории вашего сервера.

Инсталляция MediaWiki при использовании сервера приложений
Всё содержимое разархивированной папки (все файлы и вложенные папки) скопируйте в папку T:\home\virtual\prime\. Перейдите в эту папку и удалите из неё файлы index.html и index.htm. Эти файлы были скопированы сервером приложений, но они нам уже не нужны.

В строке браузера наберите адрес http://prime.

Вы должны увидеть сообщение:

You’ll have to set the wiki up first!

Перейдите по ссылке set the wiki up.

В разделе Site config заполните поля:


 * Site name — Википедия
 * Language — выберите Русский
 * Sysop account name — укажите любое имя (это будет пользователь с правами администратора Википедии)
 * Sysop account password — укажите пароль, в поле again его нужно повторить

В разделе Database config заполните поля:
 * Database name — имя базы данных. Можно оставить значение по умолчанию wikidb
 * DB username — имя пользователя для подключения к базе. Можно оставить значение по умолчанию wikiuser. Он понадобиться только в процессе настройки.
 * DB password — пароль пользователя. Например 123456, в поле again его нужно повторить
 * Super user — введите то же что и в DB username
 * Password — введите то же что и в DB password

Нажмите Install!.

Должно появиться сообщение:

Success! Move the config/LocalSettings.php file into the parent directory, then follow this link to your wiki.

Перенесите (именно перенесите, а не скопируйте!) файл T:\home\virtual\prime\config\LocalSettings.php в папку T:\home\virtual\prime\</tt>.

Удалите папку T:\home\virtual\prime\config\</tt>.

Вернитесь в браузер и нажмите ссылку this link, то есть перейдите по адресу http://prime.

Вы увидите пустую Википедию. Поздравляем вас с удачной установкой MediaWiki!

Для того чтобы закачать в Википедию базу данных статей (дамп Википедии) необходимо проделать ещё ряд действий.

'''См. также:''' Википедия:Как сделать копию Википедии

Запуск инсталляционного скрипта
Как только все предыдущие шаги будут пройдены, следует запустить конфигурационный скрипт в веб-браузере. См. подробную информацию в разделе Manual:Config script.

= Установка MediaWiki на локальный компьютер с операционной системой Linux =

Назначение прав
Для MediaWiki необходимы права на запись в каталог  при запуске установочного скрипта. Если Вы используете FileZilla, щёлкните правой кнопкой мыши на директории, выберите пункт меню «attributes...» и отметьте «Write» под «Owner». Если же необходимо указать численное значение (к примеру, если Вы используете командную строку), введите 755 (в линуксе введите '777, за исключением RedHat Linux). Также, Вы можете изменить права доступа, используя «контрольную панель», если её предоставил Вам ваш хостер.

Иногда, в зависимости от настроек сервера, необходимо отметить все чек-боксы в FileZilla, для нормальной работы установочного скрипта MediaWiki.

В ОС Unix и Linux, при наличии полномочий администратора, изменить права на запись в каталог можно командой  в вашей директории.

Загрузка MediaWiki
Загрузите программный пакет MediaWiki с официальной страницы загрузки или с помощью клиента клиента SVN.

Распакуйте файлы из архива MediaWiki. Для распаковки применяется следующая команда:

tar xvzf mediawiki-*.tar.gz

= Вики-хостинг = Возможно, что по каким-то причинам вам не удалось установить на свой компьютер MediaWiki. В этом случае вы можете создать свой вики-проект. Для этого воспользуйтесь существующим Вики-хостингом. Самый известный вики-хостинг — Викия.

Список других хостингов приведен здесь.

mediawiki-1.12.0 требует php 5.0 или выше. Убедитесь, что это есть на хостинге!

Установка MediaWiki на сервер хостинг-провайдера
Данный раздел находится в стадии доработки

Скачайте и разархивируйте (untar/unzip) файлы Mediawiki
Скачать файл setup можно здесь: http://www.sf.net/projects/wikipedia

Вариант 1: Скачайте файл setup на свой компьютер и разархивируйте его (например, с помощью WinRAR). Это позволит просмотреть все файлы на вашем компьютере до закачивания на сервер.

Вариант 2: Скачайте tarball отсюда: http://www.sf.net/projects/wikipedia, после этого разархивируйте файлы командой:

Закачивание файлов MediaWiki на сервер
Разархивированные файлы на вашей локальной машине закачайте в папку сервера. Можно поместить их в корень. Если ваш сервер работает под Unix, и у вас есть доступ к файлу, сделайте symlink.

Если хостинг предоставляет компания, то обычно полезно создать поддиректорию в каталоге, например, каталог   и скачать туда все файлы MediaWiki с вашего локального диска.

Работа с пользователями
Попробуйте пропустить этот шаг, но если начнутся проблемы с пользователями, вернитесь и попробуйте прочитать руководство mw:Manual:Installation/Users.

Создайте базу MySQL

 * Если вы знаете пароль администратора для сервера MySQL, пропустите этот шаг
 * Если у вас нет доступа к серверу на уровне администратора (т.е. сервер разделяемый), то перед запуском setup, создайте базу данных MySQL и создайте пользователя для этой базы

Изменение разрешений в директории «config»
Войдите в директорию config и разрешите серверу записывать в нее.

Лучший метод
Самый хороший и безопасный способ — это узнать под каким пользователем запущен сервер. Для Debian, например, это пользователь с именем «www-data». Чаще всего в качестве веб-сервера используется Apache, и чтобы узнать к какой группе принадлежит пользователь «apache», выполните следующую команду:

(или )

Далее надо изменить группу для всех файлов на группу веб-сервера, а так же разрешить доступ группе для записи в папку с конфигурационными файлами (, или, что проще, в ftp-клиенте выставить 775).

Простой метод (небезопасный)
Разрешите доступ к директории «config» на chmod 777. Если не получится — сделайте доступ 755 или 775

В случае виртуального хостинга достаточно закачать файлы на сервер, например, через ftp-клиент. А потом выставить для директории «config» права 770 или 775.

Зайдите на сайт и запустите Setup
Зайдите на сайт и запускайте setup. Например, если если у вас сайт example.com и вы инсталлировали Wiki в директорию mediawiki, то вам необходимо просто набрать  в браузере. При повторных изменениях необходимо заходить в.

Задайте свойства проекта
Секция «Database config»:
 * Database name — имя базы данных
 * DB username — имя пользователя базы данных
 * DB password — пароль пользователя базы данных
 * Database table prefix — префикс названий баз данных
 * DB root password — пароль администратора баз данных, если вы его знаете

Жмите кнопку «Install!»

Если инсталятор выдаст ошибку создания какой-либо из таблиц в базе, то можно скопировать SQL-код создания таблицы и создать ее вручную, изменив параметры, которые не устраивают SQL-сервер. После создания таблицы, можно вернуться на страничку инсталяции и просто нажать F5 (конечно, подтвердив повторную отправку данных формы).

Переместите LocalSettings.php
После установки, у вас появится файл LocalSettings.php в директории «config». Переместите его (не копируйте!!!) в главный каталог wiki.

Верните разрешения на доступ — ВАЖНО
Поставьте разрешение на директорию config 0600, которое означает, что только владелец может читать из неё и писать в неё. Другой вариант — просто удалить директорию config.

Конфигурация
Теперь можно перейти к m:Documentation:Configuration и mw:Manual:System administration.

= Подержка математических функций (Формулы LaTeX) =

Процесс доустановки достаточно не тривиальный и его способны сделать только люди знакомые с программированием, т.к. изначальная скачиваемая версия MediaWiki расчитана на систему Linux, и в ряде мест не совместима с ОС Windows. Кроме того, требуется ряд внешних инструментов и их привязка к MediaWiki.

[http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows#Mathematics_Support см. статью на англ.]

= См. также =


 * Manual:$wgEnableUploads для включения возможности загрузки файлов/изображений.
 * Manual:Timezone для изменения часового пояса своего вики-проекта с UTC/GMT на свой часовой пояс. Это отразится во вкладках истории правок и в других местах.
 * Manual:Configuring MediaWiki, срдержащую ссылки на возможности более глубокой подстройки.
 * Manual:Short URL чтобы узнать, как сделать url-адреса страниц более простыми и понятными участникам.
 * Manual:Wiki family, если требуется выполнить несколько инсталляций MediaWiki на базе единого набора конфигурационных файлов...