Manual:MediaWiki のインストール

From mediawiki.org
(Redirected from Manual:Installation/ja)
This page is a translated version of the page Manual:Installing MediaWiki and the translation is 82% complete.

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

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

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

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

インストール要件の確認

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

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

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

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

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

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

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

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

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 でローカルに動作していてまだコピーしていない場合は、今すぐコピーしてください。)

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

  1. zip解凍したフォルダを直接コピーする、または
  2. FileZilla (Windows、OSX、Linux) や Cyberduck (Windows、OSX) のような FTP クライアントを使って行う
  3. 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 データベースとデータベース ユーザーを作成してください。 方法はいくつかあります:

The following commands create a database named my_wiki, a user named wikiuser, and set permissions for the user on that database.

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 です。

The following commands on a Linux command-line, as the postgres user, create a database user named wikiuser, and a database named my_wiki owned by the user named wikiuser.

 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を実行する場合における既知の問題一覧に書かれている内容に注意してください。

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

Next, complete the installation of MediaWiki by going to the URL of your MediaWiki installation in your web browser: Follow the instructions in Manual:構成スクリプト .

さらなる環境設定

最新の状態に保つ

インストールした後も、最新リリース版がインストールされた状態を維持し、サーバーを安全に保つようにしてください。

MediaWiki リリース告知メーリングリストに登録する。

付録

Alternatives to manual installation

Manual installation is often the preferred method because it gives the user more control and insight into how their wiki is installed, making troubleshooting and maintenance easier. Automated processes, packages, bundles, and services all come with their own idiosyncrasies.

Instead of manually installing MediaWiki, alternative options might be easier:

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

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

システム固有の手順

The pages listed on Manual:OS 固有のヘルプ give more detailed installation instructions aimed at specific systems.

However, by and large these per-system docs are less maintained and might not always be up to date. First consult MediaWiki のインストール (this page) before looking at per-system installation documentation.

Running multiple wikis

Importing an existing wiki database

関連項目