Manual:Installation/ja
From MediaWiki.org
| Manual:Installation/ja |
|---|
| on FreeBSD |
| on GNU/Linux |
| - Damnsmalllinux(英) |
| - Debian |
| - Fedora Core |
| - Gentoo(英) |
| - Mandriva(英) |
| - Red Hat Enterprise Linux(英) |
| - Slackware(英) |
| - SuSE 9.3(英) |
| - Ubuntu |
| on Mac OS X |
| on NetWare(英) |
| on Solaris(英) |
| - on Solaris 10(英) |
| - on Solaris 9(英) |
| on Windows |
| - Windows XP(英) |
| - Windows Server 2003 |
| - Newcomers guide |
| - Streamlined Guide |
| - Simple Windows/Apache Guide |
| - on a stick |
このページはMediaWikiをインストールするための詳細な手引きです。素早く概要を得るために、Manual:Installation guide/jaをご覧頂けるようお願いします。特定のOS上のガイダンスに関しては、右のメニューをご覧下さい。
MediaWikiはApacheとPHPとMySQLの経験が無い平均的なコンピュータユーザがインストールするのは難しいです。 wikiソフトウェアを使いたいと願っている大抵のユーザはフリーwikiホストを使用することで恩恵を得るかも知れません(wikibooks上のwikiホストのリストをご覧下さい)。
Contents |
[edit] 要件
ソフトウェア自身に加えて、標準的なMediaWikiのインストールは次の要件を持ちます:
加えて、特定の高度な機能を使いたい場合に要求される様々なオプションの依存関係があります。(下記を参照)
インストールする前に個々のコンポーネントのドキュメントを読むことを覚えておいて下さい。ウェブサイトがホストされている場合(すなわち直接管理しない場合)、これらがインストールされているか確認をするためにサーバのアドミニストレータもしくはホスティング会社に連絡して下さい。
MediaWikiはもっとも重要な要素のコンフィギュレーションを提供するウェブベースのインストールスクリプトを搭載していますが、より詳細なカスタマイズをするためにはPHPの知識が要求されることに注意して下さい。
PHP
PHPはMediaWikiが書かれているプログラミング言語で、ソフトウェアを動作させるために要求されます。
- 最新バージョンのMediaWikiのためにPHPバージョン5.0以降が要求されます(5.1.xが執筆時の推奨です)。
- PHP5にアップグレード出来ないのであれば、MediaWiki1.6.12を使用することが出来ます。PHPバージョン4.3.0以降が要求されます。
ソースからPHPをコンパイルする必要がある場合、MediaWikiに影響を与えるコンパイルオプションに関するPHPコンフィギュレーションをご覧下さい。
- サーバの中には同等のデータベースモジュールとセッション管理モジュールもインストールされていることを要求するものがあります。詳細な情報に関しては個々のOSインストラクションをご覧下さい。
- Windows上でMicrosoftのインストーラでインストールする場合、データベースの選択のためにエクステンション(MySQLまたはPostgres)をインストールされる機能に追加して下さい。
データベースサーバ
MediaWikiは他のウェブベースのアプリケーション(phpBBなど)と共有できるデータベースですべてのテキストとデータ(記事、ユーザの詳細、システムのメッセージ、など。)を保存します。MediaWkiの最新バージョンは次のデータベースサーバをサポートします(それらの1つだけで選択する必要があります):
- MySQL 4.0かそれ以降*
- PostgreSQL 8.1かそれ以降 (MediaWiki 1.8以降でサポートされます - plpgsqlとtsearch2も要求されます)
- Ingres 2006かそれ以降 (SVN-Download)
ユーザの中にはhttp://www.phpmyadmin.net phpMyAdmin] (MySQL)もしくはphpPgAdmin (Postgres)といったデータベースサーバを管理するための追加ソフトウェアパッケージをインストールすることが便利だと思う人がいます。
ウェブサーバ
生成されたページをブラウザに提供するために、MediaWikiはウェブサーバソフトウェアを要求します。しばし使うソフトウェアの選択の余地がないことがあります - ホスティングプロバイダーによって一つ提供されます。
- 大抵のインストレーションはApacheウェブサーバを使用します。公式のダウンロードページから利用可能です。
- MediaWikiはIIS 6.0、Cherokee、とlighttpdの元でもテストされています。
- SunはSun Java System Web Server 7.0上でMediaWikiを動かすためにSunのサイトでインストールのインストラクションが提供されています。
ハードウェア要件
推奨の最小要件は単独のコンピュータのウェブサイトのために256MBのRAMに40MBのストーレッジです。しかし 混んでいる公開サイトもしくはアップロードが有効になっているサイトでは十分ではありません。48MBのRAMでMediaWikiを動作させたことを報告したユーザがいました。
オプションの依存関係
- ImageMagickもしくはGDは画像のサムネイルのために要求されます。
- TeX は数式のインライン表示のために要求されます。
- SendmailはシステムがEメールを送ることが出来るようにするために要求されます。
上記の項目についてもっと詳細な情報は、Manual:Installing third-party tools/jaをご覧下さい。
[edit] インストール
MediaWikiは対話的なウェブベースのインストールスクリプトで自身をインストールします。このスクリプトを実行する前に、いくつかのことを必要があります。最初に、Apache、PHP、MySQLがインストールされていることを確認することです。それからMediaWikiソフトウェアパッケージを入手してサーバにアップロードしなければなりません。wikiのために新しいデータベースを作成しなければならないこともあります。必要な場合、Manual:Installation/Creating system accounts/jaのインストラクションに従ってウェブサーバ上でアカウントを作成します。
Note: トラブルシューティング情報に関しては、インストールエラーをご覧下さい。
ソフトウェアをダウンロードする
公式ダウンロードページもしくはSubversionからMediawikiをダウンロードします。
ローカルもしくはサーバ上でファイルを解凍します。これはWindowsでは通常7-Zip (オープンソースソフトウェア)、WinZip、WinRARもしくはIZArcといったソフトウェアで行います。Linux上では次のコマンドを使用して解凍します:
tar xvzf mediawiki-*.tar.gz
まだファイルをサーバにアップロードしていないのであれば、今して下さい。FileZilla (オープンソースソフトウェア、Windows)もしくはCyberduck (OSX)といったFTPクライアントを使用して、ファイルをウェブサーバのウェブディレクトリにアップロードします。Apacheをインストールしたのであれば、正しいディレクトリはhttp.confファイルで指定されます。LinuxもしくはUnixを使用している場合は、ファイルをサーバ上のディレクトリにコピーする代わりにウェブサーバディレクトリからそのフォルダにシンボリックリンクを作成します。
ディレクトリを準備する
MediaWikiはインストールスクリプトを実行するときにconfigディレクトリへの書き込み権限が必要です。 まだ行っていない場合、ウェブサーバがconfigサブディレクトリを書き込みできるようにパーミッション設定を変更する必要があります。Fillezillaを使用する場合、configディレクトリを右クリックして"ファイルの属性"を選択して"所有者のパーミッション"の"書き換え"をチェックします。コマンドラインインターフェイスを使用している場合、755を使用します(RedHat Linux以外のLinuxは777を使用します)。他にも、ウェブホストによって提供された"コントロールパネル"を使用してパーミッションを変更することが出来ることもあります。
サーバコンフィギュレーションによって、MediaWikiのインストールスクリプトを実行できるように、FileZillaですべてのボックス(777)をチェックをしなければなりません。
UnixもしくはLinux上に置いて、管理者権限を持っている場合、wikiディレクトリでchmod 755 configコマンドを実行することが出来ます。
データベースを作成する
データベースのルートパスワードを知っている場合、MediaWikiインストールスクリプトは新しいデータベースを作成します。この場合、下記のインストールスクリプトの実行を省略することが出来ます。ルートパスワードを知らない場合、例えば、ホストサーバ上にいる場合、今、新しいデータベースを作成しなければなりません。現在、wikiの実際のコンテンツを保存するためにMySQLもしくはPostgresを使用しなければなりません。
MySQL
- MediaWikiをインストールする前にMySQLデータベースとユーザを作成する必要があります。多くの共有サーバで利用できるPhpMyAdminといった様々なコントロールパネルを使ってこの作業を行うことが出来ます。もしくはSSHを使用してホストにログインをしてMySQLプロンプトにコマンドを入力します。該当するドキュメントをご覧下さい。他の方法では、あなたのアカウントを作るようにホストプロバイダーに連絡をして下さい。
- # MySQL 5.0をダウンロードしてインストールします。/usr/local/mysqlに設置します
- データベースサーバが動作しているか確認をして("/usr/local/mysql/bin/mysqladmin status")、そうではない場合、
sudo /usr/local/mysql/bin/safe_mysqld &を実行します。
(Fedora Core 5では/usr/bin/mysqld_safe)
- MySQLサーバを初期に起動させる他の方法はMySQLのインストレーションのルートでconfigureスクリプトを実行することです。初期のテーブルを作成し自動的にmysqlデーモンを起動させます
- データベースサーバ上で"root"アカウントのパスワードを設定して下さい。
/usr/local/mysql/bin/mysqladmin -u root passwordyourpassword - MySQLでwikiのためのユーザをセットアップします--次のコマンドをターミナルで実行します: /usr/local/mysql/bin/mysql -u root -p mysql
- このコマンドによってMySQLコマンドラインクライアントが起動します。クライアントで次のクエリを実行します:
- データベースサーバが動作しているか確認をして("/usr/local/mysql/bin/mysqladmin status")、そうではない場合、
create database wikidb; grant create, select, insert, update, delete, alter, lock tables, index on wikidb.* to 'wikiuser'@'localhost' identified by 'password'; flush privileges; \q
データベースサーバとウェブサーバが異なる場合、適切なウェブサーバのホスト名を入力します -- 例えば、mediawiki.example.comであるなら -- 次の通りです:
grant create, select, insert, update, delete, alter, lock tables, index on wikidb.* to 'wikiuser'@'mediawiki.example.com' identified by 'password';
Postgres
Postgresを使用する場合、データベースを持ちあなたのためにユーザを作成する必要があるもしくはシンプルにPostgesの名前と"superuser"の特権をコンフィギュレーションフォームに入力します。よくあるデータベースユーザ名はpostgresです。
MediaWikiが使用するデータベースにplpgsqlとtsearch2の両方がインストールされていることが必要です。インストーラスクリプトはpspgsqlをインストールしようとしますが、tsearch2はあなた自身でインストールする必要があることがあります。(tsearch2はwikiのテキストを検索するために使用します。)よくあるセットアップの方法です。Unixライクなシステムで、plpgsqlとtsearch2が既にインストールされていることを前提とします。この例では、wikidbという名前のデータベースを作成し、wikiuserという名前のユーザが所有します。コマンドラインから、postgresユーザとして次のステップを実行します。
createuser -S -D -R -P -E wikiuser (then enter the password) createdb -O wikiuser wikidb createlang plpgsql wikidb
tsearch2をデータベースに追加することは単純なステップではありませんが、できれば、tsearch2モジュールをインストールしたパッケージング処理が何であれ既に行われることになります。どの場合でも、tsearch2が見つからない場合はすぐにインストーラがそのことを教えてくれます。
上記のステップはすべて必要ではありません。スーパーユーザ名とパスワードを入力した場合、インストーラが代わりにいくつかの作業を試してくれるからです。
Windowsでtsearch2をwikidbデータベースにインストールするためには、次のステップを行います:
- tsearch2.sqlを見つけ(おそらく.\PostgreSQL\8.x\share\contribの元にあります)、postgresql\8.x\binディレクトリにコピーします;
- postgresql\8.x\binディレクトリでコマンドプロンプトから、"psql wikidb < tsearch2.sql -U wikiuser"を入力します;
- wikiuserのためのパスワードを入力するように促されます;
これでお終いです!
ポイント(2)はWindows上のみで動作するようです。debian linux 4.0 (etch)上では、言語 cで許可されます。ですのでコマンドで呼び出さなければなりません:
su - postgres -c psql wikidb < tsearch2.sql
後でtsearchテーブルをselectする権限をwikiuserに付与し正しいロケールを加えなければなりません。
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データベースに再びインストールしてみるか、代わりにこれらの2つの異なるステップを使用して下さい(そしてgrant文も再度試して下さい):
1) su - postgres 2) psql wikidb -f tsearch2.sql
インストールスクリプトを実行する
一旦上記のすべての段階が完了したら、ウェブブラウザでインストールを完了させることが出来ます。詳細はManual:Config script/jaをご覧下さい。
[edit] 構成
基本的な構成
MediaWikiを最初にインストールするとき、ウェブブラウザ経由で提供された構成スクリプトを実行します。wiki起動させ動作させるために要求される基本的な設定を実行します。スクリプトを実行するための全内容はManual:Config script/jaをご覧下さい。
高度な構成
一旦wikiがインストールされた上記の構成スクリプトを使用して設定されると、さらなるカスタマイズはLocalSettings.phpを設定することが必要です。
高度で技術的な構成のヘルプに関しては、Manual:System administration、m:Help:Configuration、とm:Help:Administrationをご覧下さい。
ヘルプページとテキストとレイアウトの修正に対応する手短な概要に関しては、m:Help:Installation-Software_Configurationをご覧下さい。
[edit] アンインストール
MediaWikiを完全に除去するためには2つのステップで行います: MediaWikiがインストールされたディレクトリを除去し、MySQLもしくはPostgresからMediaWikiデータベースをドロップします。
例えば、MediaWikiを/var/www/mediawiki-xyzにインストールしたのであれば、次のコマンドを使用します:
rm -rf /var/www/mediawiki-xyz
[edit] MySQL
wikiを保持しているMySQLデータベースを取り除くために、対話形式のmysqlユーティリティを使用してMySQLに適切な権限を持つユーザとして接続して次のコマンドをmysql>プロンプトで発行します:
DROP DATABASE wikidb;
[edit] Postgres
wikiを保持しているPostgresデータベースを除去するために、次のコマンドを実行します:
dropdb wikidb
もしくは正しい権限を持つユーザとしてデータベースに接続して次のコマンドを発行します:
DROP DATABASE wikidb;
[edit] 関連項目
- Manual:FAQ
- m:Help:Upgrading MediaWiki
- m:Help:MediaWiki architecture
- m:Postgres config -- MediaWikiに対するPostgresの構成の詳細
- How to upgrade from PHP4 to PHP5 on RedHat Enterprise Linux (AS4)
- Apache Installation
- Wikipedia about LAMP, WAMP...
- Manual:Errors and Symptoms/ja
[edit] 外部リンク
- Lopez, Daniel Sams Teach Yourself Apache 2 in 24 Hours。この本は素晴らしく使いやすいです、3章で、どのようにApacheをインストールするのかを説明しています。Amazon.comで見ることが出来ます
- 時代遅れですが、30分以内でWindows XPの元でApache 1.3、MySQL 3、PHP 4をどのようにインストール・設定する方法を説明しています。(このドキュメントの最終更新が2003年10月5日と久しく時代遅れですが、よく書かれています!) 2006年1月に関しては例は以下の通りです:
- 手引きではApache 1.3ですが現在はApache 2.2です。httpd.confのために示している構文はApacheの再起動を妨げます。
- 手引きはPHP4ですが現在はPHP 5.1です。
- MySQL3.23ですが現在はMySQL 5.xです。
- Life HackerにWindows XP上でMediaWikiをインストールするための手引きがあります。
Sun Java System Web Server 7.0にMediaWikiをインストールする
- Sunがweb serverの最新のバージョンをリリースしました - Sun Java System Web Server 7.0(かつてはiPlanet Enterprise Server もしくは Sun ONE Web Serverとして知られていました)。 Sun Java System Web Server 7.0にMediaWikiを配置する方法を説明した技術的な記事があります。気兼ねなくSun's Web Server Software forumに質問や関心事を投稿して下さい。
- Sun Java System Web Server 7.0でPHPを動作させる方法についてのより詳しいヘルプが必要な場合、Web Server 7.0でPHPを設定して動作させるための説明が書かれているこの記事を確認して下さい。
- WAMP + MediaWikiを設定するためのコンパクトな段階的なガイドが利用可能です。
Windows XPに関しては、ユーザにXAMPP for Windowsを指定したいかもしれません。このミドルウェアの導入によってApache、PHP、MySQLの基本的な要件がカバーされます。