Manual:Upgrading to 1.11/ja



夏です. のんびりした時間、日光に満たされ、Wikimaniaカンファレンス、そしてもちろん、新しいバージョンのMediaWikiです. アイスクリームを食べてリラックスして下さい; 1.11へのアップグレードのガイドをいつも通り提供致します.

概要
最初に、MediaWiki 1.11に含まれるUPGRADEテキストファイルをご覧下さい.

すべてのMediaWikiのアップグレードに関して、基本的な前提は同じです:


 * 1) 要件をチェックする
 * 2) リリースノートを読む
 * 3) 既存のファイルとデータベースをバックアップする
 * 4) 新しいファイルを解凍する
 * 5) データベースを確認するためにアップデートスクリプトを実行する
 * 6) エクステンションをアップグレードする
 * 7) アップデートをテストする

システム要件を確認する
MediaWiki 1.11 のシステム要件です:

PHP

 * PHP 5.0系以降
 * PHP 5.1系もしくは5.2系を使用することを推奨します.
 * 特定の64ビットプラットフォームでのPHP 5.0系はMediaWikiに対して抜本的なバグを抱えていることに注意して下さい. x86_64 (AMD64、MT64)上もしくは他に影響のある64ビットのプラットフォーム上で動作をさせる場合、PHP 5.1系もしくは5.2系が要求されます.

DBMS

 * 'MySQL 4.0系以降
 * MediaWiki1.6.0以降ではMySQL3.x系はサポートされていません

もしくは


 * PostgreSQL 8.1以降
 * tsearch2とplpgsqlモジュールも必要とされます. Cロケールで日本語全文検索をできるのはPostgreSQL8.2.2以降です. 8.2.1はパッチを適用する必要があります.

リリースノートを読む
tarballの配布パッケージもしくはSVNからチェックアウト/エクスポートされたファイルの中に大文字の名前を持つ多くのファイルがあり、それらの一つにリリースノートが含まれています. 開いてみて1.11で何が変更されたのかを調べて下さい.

既存のファイルとデータベースをバックアップする
アップグレードスクリプトがよく維持され頑強である場合でも、まだ物事がうまくいかなくなってしまうことがあり得ます. データベーススキーマをアップデートする手続きをする前に、wikiのデータベースとファイルの両方を含めて、wikiを十分にバックアップをして下さい:


 * データベースからのwikiの内容. SQLデータベースダンプに加えてXMLダンプを作成することはよいアイディアかもしれません.
 * 画像と他のメディアファイル(imagesディレクトリの内容)
 * コンフィギュレーションファイル、すなわちLocalSettings.php and AdminSettings.php(存在するのであれば)
 * MediaWikiのプログラムファイル. すべてのスキンとエクステンションを含む. 特にそれらを修正している場合.

Manual:Backing up a wiki/jaの手引きもご覧下さい

新しいファイルを解凍する
tarballパッケージを使用する場合、解凍して下さい; Subversionを使用している場合、ファイルをクリーンな位置にエクスポートして下さい. すべてのエクステンションファイルを1.11から新しいバージョンで置き換えて下さい. ディレクトリ構造はそのままにして下さい. これでコアコードは最新になります.

アップデートスクリプトを実行する
注意: wikiルートにAdminSettings.phpが存在し、その中に最新の情報が格納されているかを確認して下さい. ユーザはデータベース上でフルパーミッションが必要です.

前に説明したアップデートを実行する方法はコマンドラインメインテナンススクリプトを使用していますが、ウェブベースのインストーラを再実行することも可能です.

シェル
コマンドラインもしくはSSHシェルか同様のもので、maintenanceディレクトリに移動してアップデートスクリプトを実行します:

$ php update.php

MediaWikiは既存のスキーマを点検し、新しいコードが動作するように、必要に応じてテーブルとカラムを追加することでアップデートを行います.

他の選択肢 1: phpShell
シェルアクセスが利用できない場合、phpShellといったPHP関数を利用してコマンドプロンプトをエミュレートするものを見てみましょう. これはロックダウンされたホスティングセットアップ上では動作しないかもしれません.

このような解決方法を使用する場合、スクリプトの始めにカウントダウンピリオドをスキップすることが望ましいことがよくあります. そのようにするためには--quick</tt>オプションをアップデートスクリプトに渡して下さい: $ php update.php --quick

他の選択肢 2: インストーラを再実行する
シェルからアップデートスクリプトを実行する別の選択肢はウェブインストーラを再実行することです. 次のように行います:


 * 1) LocalSettings.php</tt>をLocalSettings.old.php</tt>にリネームします
 * 2) config</tt>ディレクトリがウェブサーバによって書き込み可能であることを確認します
 * 3) データベースユーザがデータベースへの十分な権限を持つことを確認します
 * 4) wikiにブラウズしてインストーラを立ち上げます

以前のバージョンのインストールの間に行ったフォームフィールドを入力します. インストールの手続きが始まったときにスクリプトは既存のMediaWikiのテーブルを検知して、スキーマをアップグレードします. インストール作業が完了したときに、LocalSettings.php</tt>が生成されます.


 * 1) 新しいコンフィギュレーションファイルを削除します
 * 2) LocalSettings.old.php</tt>を元のLocalSettings.php</tt>にリネームします
 * 3) config</tt>ディレクトリのパーミッションを元に戻します

エクステンションをアップグレードする
エクステンションの中にはMediaWiki 1.11で動作させるためにアップデートする必要があります. 必ず最新のエクステンションにアップグレードして下さい. エクステンションのアップデートを手作業で行うことが必要になることがあります.

アップデートをテストする
一旦アップグレードが完了したら、期待通りに作業が行われたかどうか裏付けをするためにwikiにブラウズしてページの閲覧と編集といった基本的なことを確認して下さい.

Special:Versionにアクセスし表示されるバージョンが正しいか確認をして下さい.