Manual:MediaWiki のインストール

This page is a translated version of the page Manual:Installing MediaWiki and the translation is 92% complete.

MediaWiki のインストール

このページでは、MediaWiki を手動でインストールする手順が説明されており、追加の設定手順はManual:システム管理#設定で見つかります。

MediaWiki のインストールには、ウェブホストの使用方法に基本的な知識が必要です。 Apache (ウェブサーバーソフトウェア)、PHP、MySQL/MariaDB (データベース) についてある程度の経験があるとより簡単です。追加のヘルプは Project: Support desk で利用できます。

以下の付録の節では、手動インストールに代わる方法を紹介しています。また、特定のシステム構成におけるインストールに関する注意事項が記載されています。

MediaWiki を既に稼働させている場合は、アップグレードガイドを参照してください。

インストール要件の確認

ご使用のシステムがインストール要件を満たしていることを確認します。

インストールする予定のバージョンのMediaWikiのリリースノートも必ず確認してください。

MediaWiki ソフトウェアのダウンロード

MediaWiki の tar ファイルを公式ダウンロードページからダウンロードします。

一般に、本番環境を使用している場合は、最新の安定版リリースである MediaWiki 1.41.1 を実行することをお勧めします。

MediaWiki ソフトウェアを展開する

ダウンロードされたファイルは、.zip または .tar.gz のファイル形式です。このアーカイブファイルを使用する前に、展開する必要があります。ローカルで展開 (その後 FTP でサーバーにアップロード) することも、サーバーで直接展開することもできます。

これは通常、Windows 上では 7-Zip (無料)、WinZip、WinRAR、IZArc (無料) のようなソフトウェアで実施します。

Linux、Mac OS Xの場合、以下で解凍できます。 tar -xzvf mediawiki-*.tar.gz

アーカイブファイルを root/admin ユーザーとして展開する場合、セットアップに応じて後でファイルの所有者を変更したくなるかもしれません。 Linux システムでは、以下のように chown を使用してください: chown -R <new_owner_user> <mediawiki_folder> 詳細はこちら： Manual:Security#File_permissions

サーバーへのファイルのアップロード

まだ、ウェブサーバーにファイルをアップロードしていない場合は、今すぐアップロードしてください。(ウェブサーバーソフトウェアが localhost でローカルに動作していてまだコピーしていない場合は、今すぐコピーしてください。)

ウェブサーバーのウェブディレクトリに、以下のいずれかの方法でファイルをアップロードします:

zip解凍したフォルダを直接コピーする、または
FileZilla (Windows、OSX、Linux) や Cyberduck (Windows、OSX) のような FTP クライアントを使って行う
cPanel File Managerなどのホスティングサービスによって既に提供されているソフトウェアを使用する

アップロードツールに「ファイル名を小文字に変換する」オプションがある場合は、これをOFFにする必要があります。

Apache HTTPD Web サーバーを使用する場合、httpd.conf ファイルの DocumentRoot ディレクティブで正しいディレクトリを指定します。既定では、これは /var/www/ または <Apacheのフォルダー>/htdocs です。

Apacheサーバーの設定とディレクトリファイル httpd.conf の正確な場所は、オペレーティングシステムに依存します。 Debian および Ubuntu では、Apache サーバー設定のファイル名とディレクトリ名は /etc/apache2/apache2.conf です。 Red HatおよびFedoraでは、このファイルは/etc/httpd/conf/httpd.confです。

アップロードしたファイルの名前をURLに含めたい名前に変更してください。あなたのウェブサーバーが例えば http://localhost で動作している場合、ディレクトリ名を /w/ に変更すればあなたのウィキは http://localhost/w/index.php でアクセスできることになります。

インストールスクリプトを実行した後、ショートURLとして設定したい場合は、/wiki/を使用しないでください。

データベースをセットアップする

MediaWiki のインストールスクリプトはデータベース名とデータベースユーザ名を尋ねるため、MediaWiki はウィキの内容を保存できます。

既にデータベースサーバーがあり、「root」(admin) ユーザーのパスワードを知っている場合は、下の #インストールスクリプトの実行の節まで読み飛ばしてください。

root ユーザーのパスワードを知らない場合、例えばホスティングサーバーにある場合、次の節で MediaWiki インストールスクリプトを実行する前に新しいデータベースを作成する必要があります。

データベースはMariaDB/MySQLを推奨します。 PostgreSQLとSQLiteはサポートが限定的なので、特別な理由がない限り使うべきではありません。どのデータベースを選択すればいいか分からない場合は、MariaDB を使用してください。

データベースのセットアップが終わったら、以下の#インストールスクリプトの実行を行ってください。

SQLite

SQLite の追加のセットアップは不要です。ただし、システムに PHP の pdo-sqlite モジュールがインストールされている必要があります。

SQLite のインストール　ページでは、データベース名（どんな値でも結構です）とSQLite データベースディレクトリを指定します。インストーラはデータベースディレクトリをドキュメントルートの外側にあるサブディレクトリに設定し、必要があれば作成しようとします。ディレクトリが安全ではない（例えば、ウェブ上で閲覧できる）場合、手動で設定を変更して誰でもウェブでアクセスできるということがないようにしてください。

MariaDB/MySQL

MariaDB/MySQL データベースとデータベースユーザーを作成してください。方法はいくつかあります:

ホスティングサービスが提供するコントロールパネルソフトウェア (例: phpMyAdmin) を使用してください。
ホストにログインするために ssh を使用し、MySQL プロンプトに以下のコマンドを入力してください。ホスティングプロバイダーの、対応する説明文書を参照してください。あるいはホスティングプロバイダーに連絡してあなたのアカウントを作成してもらっても構いません。

以下のコマンドは、名前が my_wiki のデータベース、名前が wikiuser のユーザーを作成し、そのデータベース上でユーザーに権限を設定します。

CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

データベースがウェブサーバーと異なるサーバー上で動作している場合のみ、適切なウェブサーバーのホスト名 (下記の例では mediawiki.example.com) を指定する必要があります:

GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';

警告: MySQL/MariaDB は、すべてのクエリを履歴ファイルに記録します。これにはユーザーアカウントのパスワードが含まれます。これが気になる場合は、MySQL の説明文書に従って、これらのクエリを実行した後に .mysql_history ファイルを削除して無効にしてください。

PostgreSQL

PostgreSQL を使っているのであれば、データベースとあなたが作ったユーザが必要です。あるいは「superuser」権限を持つPostgreSQLユーザのユーザ名を設定フォームで指定しても結構です。多くの場合、このデータベースユーザーのユーザー名は postgres です。

Linux コマンドラインで、postgres ユーザーとして以下のコマンドを実行すると、名前が wikiuser のデータベースユーザーと、名前が wikiuser のユーザーが所有する my_wiki という名前のデータベースが作成されます。

 createuser -S -D -R -P -E wikiuser （そしてパスワードを入力）
 createdb -O wikiuser my_wiki

あるいは特権ユーザ（初期値はpostgres）でデータベースプロンプトにて以下のコマンドを実行します。

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;

PostgreSQLを使ってMediaWikiを実行する場合における既知の問題一覧に書かれている内容に注意してください。

インストールスクリプトの実行

次に、ウェブブラウザーで MediaWiki インストレーションの URL に移動して、MediaWiki のインストールを完了してください。Manual:構成スクリプト内の手順に従ってください。

さらなる環境設定

Manual:システム管理 - 追加的な構成
Manual:管理者 - ウィキの管理

付録

手動インストールの代替手段

手動インストールはしばしば好ましい方法です。利用者には、ウィキがどのようにインストールされるかについてのより多くの制御と洞察が与えられるため、トラブルシューティングや保守が容易になります。自動化されたプロセス、パッケージ、バンドル、およびサービスはすべて独自の特性を持っています。

MediaWiki を手動でインストールする代わりに、より簡単な代替の選択肢があります:

rootアカウントを作成する時、パスワードはあなたが覚えられるものにしてください。

comparison of distribution options も参照してください。

システム固有の手順

Manual:OS 固有のヘルプに列挙されているページには、特定のシステムを対象としたより詳細なインストール手順が記載されています。

しかしながら、大部分の場合、これらのシステムごとの文書はあまり保守されておらず、常に最新であるとは限りません。 First consult MediaWiki のインストール (this page) before looking at per-system installation documentation.

Running multiple wikis

Refer to Manual:FAQ#Installation and configuration.

Importing an existing wiki database