Manual:Upgrading to 1.7/ja



小突いたり愚痴ったり激しいほど大量の血と汗と涙を流したりで MediaWiki 1.7 が出来上がりました. 新しいシステム要件と豊富な新機能と修正とが取り入れらています！

さあ、どこからアップグレードを始めましょうか. このガイドは 1.6 ブランチの利用者が MediaWiki 1.7 にすんなりとアップグレードできるようお手伝いします. ちょっと古い 1.5 の利用者にも役立つでしょう.

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

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


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

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


 * PHP 5.0 以上
 * 4.x以前のバージョンでは動作しません.


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

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

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

データベース
アップデートスクリプトを実行しようとする前に、ウィキのデータベースの完全なバックアップをとってください. スキーマのアップデートに失敗しレコードが壊れたままになってしまった際の保険になります. 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> ディレクトリをウェブサーバが書き込み可能な状態にします.
 * 3) ブラウザでウィキを開き、セットアップを開始します.

そして、インストールの時と同様にフォームを埋めてください. インストーラは MediaWiki のテーブルを検出し、スキーマをアップグレードします. 完了すると新しい LocalSettings.php</tt> ファイルが生成されます.


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

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

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

Links
Upgradings documents for other versions:
 * Manual:Upgrading to 1.6
 * Manual:Upgrading to 1.8