Manual:MediaWiki のインストール

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

This page covers steps to manually install MediaWiki, with additional configuration steps found at Manual:System_administration#Configuration.

MediaWiki installation requires basic familiarity with using a web host. It is easier if you have some experience with Apache (web server software), PHP and MySQL/MariaDB (database). Additional help is available at Project: Support desk.

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

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

インストール要件の確認

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

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

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

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

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

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

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

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

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

If you uncompress the archive file while being the root/admin user, you may want to change file ownership afterwards, depending on your setup. On Linux systems, the command would be using chown as the following: chown -R <new_owner_user> <mediawiki_folder> More info: Manual:Security#File_permissions

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

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

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

  1. zip解凍したフォルダを直接コピーする、または
  2. FileZilla (Windows、OSX、Linux) や Cyberduck (Windows、OSX) のような FTP クライアントを使って行う
  3. by using software already provided by your hosting service, such as the cPanel File Manager

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

Apache HTTPD Web サーバーを使用する場合、httpd.conf ファイルの DocumentRoot ディレクティブで正しいディレクトリを指定します。 By default, this is /var/www/ or <apache-folder>/htdocs.

The exact location of the Apache server settings and directories file httpd.conf depends on your operating system. Debian および Ubuntu では、Apache サーバー設定のファイル名とディレクトリ名は /etc/apache2/apache2.conf です。 In Red Hat and Fedora, the file is /etc/httpd/conf/httpd.conf.

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

Do not use /wiki/ if you want to set it up as a Short URL after running the installation script.

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

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

既にデータベース サーバーがあり、「root」(admin) ユーザーのパスワードを知っている場合は、下の #Run the installation script の節まで読み飛ばしてください。

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

MariaDB/MySQL are the recommended databases. PostgreSQL and SQLite have limited support and should not be used unless there is a reason to. どのデータベースを選択すればいいか分からない場合は、MariaDB を使用してください。

After finishing the database setup, continue with #Run the installation script below.

SQLite

No further setup is required for SQLite if the pdo-sqlite module for PHP is installed on the system.

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

MariaDB/MySQL

Create the MariaDB/MySQL database and database user. There are several ways:

  • Use a control panel software offered by your Hosting service (example: PhpMyAdmin)
  • Use ssh to log into your host and type the commands below into a MySQL prompt. ホスティング プロバイダーの、対応する説明文書を参照してください。 あるいはホスティング プロバイダーに連絡してあなたのアカウントを作成してもらっても構いません。

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

関連項目