Назначение прав

При запуске установочного скрипта MediaWiki понадобятся права за запись в директорию config. При использовании FileZilla необходимо нажать правой кнопкой мыши на каталоге config, выбрать пункт меню attributes... и отметить Write под Owner. Если же необходимо указать численное значение (например, при использовании командной строки), надо ввести 755 (в Linux введите 777, за исключением RedHat Linux). Также можно изменить права доступа, используя панель администрирования, если ее предоставил хостинг-провайдер.

В некоторых ситуациях, обусловленных настройками сервера, для нормальной работы установочного скрипта MediaWiki может понадобиться отметить все галочки в FileZilla. В операционных системах Unix и Linux при наличии полномочий администратора можно изменить права на запись в директорию с помощью команды chmod 755 config в своем каталоге Wiki.

Создание базы данных

Самый удобный вариант создания базы данных для MediaWiki — когда известен пароль root-пользователя. Тогда установочный скрипт MediaWiki сможет создать базу данных автоматически. Менее удобная ситуация — если этот пароль неизвестен, что бывает при использовании услуг хостинг-провайдера. В таком случае создавать базу данных пользователю приходится вручную. На момент написания статьи CMS MediaWiki поддерживала работу двух систем управления базами данных — MySQL и PostgreSQL.

СУБД MySQL

Прежде чем устанавливать MediaWiki, необходимо создать базу данных и пользователя. Создание базы данных можно производить через различные панели администрирования (типа PhpMyAdmin), которые зачастую доступны на открытых хостингах. В другом случае можно использовать ssc, чтобы подключиться к серверу и ввести необходимые команды в командной строке MySQL.

1. Загрузите и установите MySQL 5.0.

2. Проверьте, запустился ли сервер баз данных (/usr/local/mysql/bin/mysqladmin status), если нет — выполните команду sudo /usr/local/mysql/bin/safe_mysqld &. (В операционной системе Fedora Core 5 используйте /usr/bin/mysqld_safe.) Другой способ запустить создание сервера MySQL заключается в том, чтобы выполнить скрипт configure, который находится в корневом установочном каталоге. Скрипт создаст начальные таблицы и автоматически запустит демона MySQL.

3. Затем необходимо назначить пароль для учетной записи root в вашем сервере баз данных:

   usr/local/mysql/bin/mysqladmin -u root password вашпароль

4. Далее надо настроить учетную запись MySQL для своей Wiki — необходимо выполнить в терминале команду:

   /usr/local/mysql/bin/mysql -u root -p MySQL

5. Это запустит веб-приложение клиента MySQL, с помощью которого надо создать базу данных для Wiki и назначить пользователю нужные права на нее:

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

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

При использовании СУБД Postgres также понадобятся созданные под пользователя база данных и учетная запись. Возможно, будет проще снабдить имя пользователя Postgres привилегиями "сверхпользователя" в форме конфигурации. Обычно имя этого пользователя так и есть — postgres.

База данных, которую будет использовать MediaWiki, нуждается в установке как plpgsql, так и tsearch2. Инсталлирующий скрипт попытается установить plpgsql, поэтому пользователю, возможно, придется устанавливать tsearch2 вручную (tsearch2 используется в wiki для поиска текста). Вот один из путей сделать большую часть установки. Этот вариант для Unix-подобных систем, и предполагается, что модули plpgsql и tsearch2 уже установлены. В этом примере будет создана база данных, названная wikidb и принадлежащая пользователю wikiuser. Из командной строки как пользователь postgres выполняем следующие команды:

createuser -S -D -R -P -E wikiuser вашпароль
createdb -O wikiuser wikidb
createlang plpgsql wikidb

Добавление tsearch2 — шаг не простой, но будем надеяться, что это уже сделано каким угодно распаковывающим процессом, установившим модуль tsearch2. В любом случае установщик сразу же сообщит, если не сможет найти tsearch2. Описанные выше шаги — это не все, что необходимо, поскольку установщик попытается сделать некоторые из них, если вас снабдить именем "сверхпользователя" и паролем. Для установки tsearch2 в базу данных wikidb под Windows необходимо сделать следующие шаги:

1. Сначала необходимо найти tsearch2.sql (скорее всего, в .\PostgreSQL\8.x\share\contrib) и скопировать его в postgresql\8.x\bin.

2. Затем для получения пароля пользователя wikiuser в командной строке в директории postgresql\8.x\bin выполнить команду:

   psql wikidb < tsearch2.sql -U wikiuser

   Этот шаг, похоже, работает только в Windows, поскольку на debian linux 4.0 только пользователь postgres может использовать язык C. Таким образом, там это необходимо вызвать следующим образом:

   su — postgres -c psql wikidb < tsearch2.sql

Впоследствии необходимо предоставить право выбора пользователю wikiuser таблиц tsearch и ввести правильное место действия:

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';"

При выдаче ошибки, наподобие ERROR: relation "pg_ts_cfg" does not exist после выполнения всех предыдущих инструкций, необходимо попытаться установить tsearch2 в базу данных wikidb еще раз, однако вместо этого использовать другие два шага (а затем попробовать еще раз основные инструкции):

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

Запуск установочного скрипта

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

В следующих примерах предполагается, что веб-сайт пользователя расположен на странице http://www.example.com/, которая физически расположена на сервере в каталоге /home/example/web. Необходимо будет корректировать примеры, чтобы использовать соответствующие местоположения для своей ситуации.

1. Используйте ваш браузер, чтобы просмотреть главную страницу Wiki. Это доступная для сети папка, в которую была устанавлена MediaWiki, и обычно это /wiki (например, http://www.example.com/wiki/, предполагается, что MediaWiki установлена в /home/example/web/wiki).
2. Поступит сообщение, что ваша Wiki установлена, но еще не была произведена конфигурация и что необходимо «нажать здесь для установки Wiki». Нажатие на ссылку запускает сценарий конфигурации. Стоит отметить (при желании запустить конфигурацию непосредственно), что сценарий расположен в каталоге конфигурации wiki (используя пример выше, он находился бы на странице http://www.example.com/wiki/config/).
3. Если скрипт определяет любые ошибки конфигурации, тогда это не позволит пользователю продолжить. Подробнее сообщения об ошибках, с которыми можно столкнуться, и необходимые при этом действия будут описаны далее.
4. Если все проверки пройдены, появится сообщение о вводе информации, в которой теперь нуждается MediaWiki. Следуйте инструкциям, чтобы заполнить все необходимое.
5. Нажмите кнопку Install. Скрипт теперь заполнит базу данных и запишет файлы конфигурации. Если возникнут какие-либо ошибки, необходимо вернуться и проверить введенные данные.

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

1. Необходимо переместить этот файл в основной каталог wiki (если MediaWiki устанавливали в /home/example/web/wiki, то переместите его туда).
2. Затем необходимо установить строгий доступ к файлу LocalSettings.php (chmod 600 и chown владелецсервера).
3. Теперь надо удалить каталог config.

После выполнения описанных инструкций ваш движок должен быть готов к использованию. Проверьте адрес, куда он был установлен (в нашем примере — http://www.example.com/wiki/), и начинайте редактировать.

Поля формы конфигурации

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

Database host — главный компьютер базы данных. Главный компьютер, на котором расположена база данных. Если база данных расположена на том же хосте, что и сервер сети, необходимо использовать localhost.

Database name — название базы данных MySQL или Postgres, которую создал пользователь. Стоит обратить внимание, что при запуске MySQL, использующей другой файловый сокет(например, MySQL на localhost использует socket=/tmp/mysocketfile), необходимо установить название базы данных localhost:/tmp/mysocketfile. Также необходимо отметить, что при установке на сайте, который размещен на Yahoo, возможно, потребуется ввести другое название базы данных — mysql.

Database username — имя пользователя, используемое для доступа к базе данных. Database password — пароль, необходимый для той же цели.

Database table prefix (только для MySQL) — дополнительный префикс, добавляющийся к названию каждой таблицы, которая будет создана в пределах базы данных wiki. Если планируется иметь несколько wiki, можно использовать префикс типа «w1», чтобы ко всем таблицам, связанным с первой wiki, добавлялось «w1_». Это позволяет установить несколько wiki, использующих одну базу данных путем создания уникального названия. Например, универсальное название archive становится «w1_archive», таким образом, можно добавить другую инсталляцию MediaWiki без полного переписывания таблиц.

Database port (только для Postgres) — это номер установочного порта Postgres. Значением по умолчанию является 5432, что должно работать на большинстве образцов.

Schema for MediaWiki / Schema for tsearch2 (только для Postgres) — название схемы, куда помещена установленная MediaWiki. Значение по умолчанию mediawiki должно прекрасно подходить для большинства целей. Чтобы использовать больше чем одну систему управления wiki на той же самой базе данных, должны быть изменены как название схемы, так и имя пользователя. Желательно, чтобы изменения были согласованы — во избежание беспорядка. Для tsearch2 значением по умолчанию является public, что почти никогда не приходится изменять.

Superuser account / Superuser password — главный пользователь и пароль базы данных, если они имеются. Если такого пароля нет, необходимо все оставить, как оно есть. Если пароль был, значит, было возможно пропустить описанные выше шаги создания базы данных, так как в этом случае MediaWiki может создать их самостоятельно.

Database character set — в этом разделе есть три варианта. «UTF-8» — используется с целью модернизации людьми, которые очень боятся изменений. "Экспериментальный" — новый путь для сохранения в формате UTF-8, удобен для чтения, а также имеет универсальную кодировку, но занимает большой объем памяти. И "Бинарный" — также является Юникодом, но не читаемый.