Manual:Upgrading to 1.9/ja



MediaWiki開発チームは、新機能の追加と修正を行った新バージョン1.9をリリースして新年の幕を落としました. このガイドは 旧バージョンの利用者が MediaWiki 1.9 にすんなりとアップグレードできるようお手伝いします. ちょっと古い 1.5 以降の利用者にも役立つでしょう.

概略
まず、MediaWiki 1.9 の配布パッケージに含まれている UPGRADE ファイルを読んでください.

MediaWiki のアップグレードでは、基本的なところはいつも同じです:


 * 1) システム要件を確認する
 * 2) リリースノートを読む
 * 3) 今あるファイルとデータベースをバックアップする
 * 4) 新しいファイルを展開する
 * 5) アップデートスクリプトでデータベースをチェックする
 * 6) エクステンションをアップグレードする
 * 7) アップデートを確認する

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


 * PHP 5.0 以降（5.1 推奨）
 * PHP 4 は 1.7 以降サポートされていません.
 * 注意: 
 * Note: 64-bit システム上で稼動する PHP 5.0 には深刻なバグが確認されており、MediaWikiは動作しません. x86_64 (AMD64, EMT64) 系列のシステムをお使いの場合は、PHP 5.1 以降にアップグレードしてください. 


 * MySQL 4.0 以上
 * MySQL 3.x は 1.6 から対象外になりました

リリースノートを読む
配布パッケージのアーカイブファイルや SVN からチェックアウトしたファイルの中にはファイル名が大文字になっているファイルがいくつかあり、その中に RELEASE-NOTES があります. さあ、 1.9 で何が変わったか見つけてみましょう.

ファイルとデータベースをバックアップする
アップデートスクリプトはよく整備されていて堅牢なのですが、それでもまだ何かを壊してしまうかもしれません. データベーススキーマをアップデートする前に、ウィキのファイルとデータベース両方の完全なバックアップをとってください.

データベース
アップデートスクリプトを実行しようとする前に、ウィキのデータベースの完全なバックアップをとってください. スキーマのアップデートに失敗しレコードが壊れたままになってしまった際の保険になります. MySQLについてくる MySQL dump などツールはいろいろあります.

設定
LocalSettings.php ファイルのコピーをとってください. これは基本的な設定の詳細や、もしあなたがしたのであれば、 MediaWiki の動作のカスタマイズなどが記録されています.

アップロードされたファイル
もしウィキのアップロード機能を有効にしているのであれば、アップロードディレクトリのバックアップもしておく必要があります. 初期設定では、images ディレクトリですが、もしかすると LocalSettings.php で変更してあるかもしれません.

エクステンションとカスタムスキン
extensions ディレクトリやカスタムスキンを含むファイルやフォルダのすべてのコピーをとってください.

新しいファイルを展開する
tarball パッケージを SourceForge からダウンロードしたのであれば展開し、Subversion を使ったのであれば、ファイルをどこか綺麗な場所にエクスポートしてください. それらで今あるファイルをディレクトリ構造を維持したまま上書きしてください. コアコードのアップデートは完了しました.

アップデートスクリプトを実行する
注意: ウィキのルートディレクトリに AdminSettings.php ファイルがあり、正確な情報が記入されていることを確認してください. データベースのユーザは全権限が必要です.

アップデートの方法としては、コマンドラインからメンテナンススクリプトを実行するのが推奨されていますが、ウェブベースのインストーラを再実行することでも可能です.

シェル
コマンドラインや SSH シェルなどで、maintenance ディレクトリに移動し、アップデートスクリプトを実行します.

$ php update.php

MediaWiki はスキーマを調べ、新しいコードに必要なテーブルやカラムを追加します. 1.5.x からアップグレードする場合は、この作業が終わったあとに、link テーブルを更新するために refreshLinks.php</tt> スクリプトも実行するとよいでしょう.

他の選択肢: phpShell
シェルにアクセスできないのであれば、phpShell のようなものも試してみるのもよいでしょう. phpShell は PHP の機能を使ってコマンドラインをエミュレートします. ホスティングサービスの設定によっては動かないかもしれません.

このような手段を用いる場合は、スクリプト開始時のカウントダウンを飛ばすことができたほうがよいこともあります. そうするには、--quick</tt> オプションをアップデートスクリプトに渡してください:

$ php update.php --quick

インストーラを再実行する
さらに別の選択肢として、ウェブインストーラを再実行することでもアップデートスクリプトを実行することができます:


 * 1) LocalSettings.php</tt> の名前を LocalSettings.php.old</tt> に変更します.
 * 2) config</tt> ディレクトリにWebサーバーが書き込めるようにします.
 * 3) ウィキにアクセスして、インストーラを実行します.

前のバージョンをインストールしたときと同じ設定で所定の欄を埋めてください. インストール作業が開始されたら、スクリプトは既にあるMediaWikiのデータベースを検出して、データベース構造をアップグレードします. 完了すると、新しい LocalSettings.php</tt> ファイルが作成されます.


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

エクステンションをアップグレードする
MediaWiki 1.9 で動作するようにアップデートされているエクステンションがあります. それらのエクステンションも最新のバージョンにアップグレードするようにしてください. そのほかのエクステンションについても、自分で変更を加える必要があるかもしれません.

アップデートを確認する
さて、アップグレードが完了したら、ブラウザでウィキを開いてページの閲覧や編集が望みどおりに動くかどうか確認しましょう.

Special:Version を開き、正しいバージョンが表示されているかどうかも確認しましょう.

関連項目
他のバージョンへアップグレードする際の資料:
 * Manual:Upgrading to 1.6
 * Manual:Upgrading to 1.7/ja
 * Manual:Upgrading to 1.8/ja