Manual:MediaWiki のインストール
このページでは、MediaWiki を手動でインストールする手順が説明されており、追加の設定手順はManual:システム管理#設定で見つかります。
MediaWiki のインストールには、ウェブ ホストの使用方法に基本的な知識が必要です。 Apache (ウェブ サーバー ソフトウェア)、PHP、MySQL/MariaDB (データベース) についてある程度の経験があるとより簡単です。 追加のヘルプは Project: Support desk で利用できます。
以下の付録の節では、手動インストールに代わる方法のほか、異なるシステム構成に関する具体的なインストール ノートも提供しています。
For a faster local setup, check out the ローカル開発クイックスタート .
インストール要件の確認
ご使用のシステムがインストール要件を満たしていることを確認します。
インストールする予定のバージョンのMediaWikiのリリース ノート も必ず確認してください。
MediaWiki ソフトウェアのダウンロード
MediaWiki の tar ファイルを公式ダウンロード ページからダウンロードします。
一般に、本番環境を使用している場合は、最新の安定版リリースである MediaWiki 1.42.1 を実行することをお勧めします。
MediaWiki ソフトウェアを展開する
ダウンロードされたファイルは、.zip
または .tar.gz
のファイル形式です。
このアーカイブ ファイルを使用する前に、展開する必要があります。
ローカルで展開 (その後 FTP でサーバーにアップロード) することも、サーバーで直接展開することもできます。
これは通常、Windows 上では 7-Zip (無料)、WinZip、WinRAR、IZArc (無料) のようなソフトウェアで実施します。
Linux、Mac OS Xの場合、以下で解凍できます。
tar -xzvf mediawiki-*.tar.gz
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
でアクセスできることになります。
データベースをセットアップする
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';
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 固有のヘルプ に列挙されているページには、特定のシステムを対象としたより詳細なインストール手順が記載されています。
しかしながら、大部分の場合、これらのシステムごとの文書はあまり保守されておらず、常に最新であるとは限りません。 システムごとのインストール手順を確認する前に、まず MediaWiki のインストール (このページ) を参照してください。
Running multiple wikis
Importing an existing wiki database