Manual:Upgrading to 1.7/ja
このページは MediaWiki の現行ではないバージョンへのアップグレード情報を含んでいます。 可能であればバージョン 1.42.1 にアップグレードするよう勧告します。 アップグレードの手引きは Manual:アップグレード にあります。 |
安定バージョン (MediaWiki 1.42 )
- mediawiki-1.42.1.tar.gz
- mediawiki-1.42.1.zip
- Git ブランチ: REL1_42
旧バージョン (MediaWiki 1.41 )
- mediawiki-1.41.2.tar.gz
- mediawiki-1.41.2.zip
- Git ブランチ: REL1_41
アルファ バージョン (MediaWiki 1.43 )
詳細情報:
小突いたり愚痴ったり激しいほど大量の血と汗と涙を流したりで MediaWiki 1.7 が出来上がりました。新しいシステム要件と豊富な新機能と修正とが取り入れらています!
さあ、どこからアップグレードを始めましょうか。このガイドは 1.6 ブランチの利用者が MediaWiki 1.7 にすんなりとアップグレードできるようお手伝いします。ちょっと古い 1.5 の利用者にも役立つでしょう。
概略
editまず、MediaWiki1.7の配布パッケージに含まれている UPGRADE ファイルを読んでください。
MediaWikiのアップグレードでは、基本的なところはいつも同じです:
- システム要件を確認する
- リリースノートを読む
- 今あるファイルとデータベースをバックアップする
- 新しいファイルを展開する
- アップデートスクリプトでデータベースをチェックする
- 拡張機能をアップグレードする
- アップデートを確認する
システム要件を確認する
editMediaWiki 1.7 のシステム要件:
- PHP 5.0 以上
- 4.x以前のバージョンでは動作しません。
- MySQL 4.0 以上
- MySQL 3.x は 1.6 から対象外になりました
リリースノートを読む
edit配布パッケージのアーカイブファイルやSVNからチェックアウトしたファイルの中にはファイル名が大文字になっているファイルがいくつかあり、その中に RELEASE-NOTES
があります。さあ、1.7で何が変わったか見つけてみましょう。
ファイルとデータベースをバックアップする
editアップデートスクリプトはよく整備されていて堅牢なのですが、それでもまだ何かを壊してしまうかもしれません。データベーススキーマをアップデートする前に、ウィキのファイルとデータベース両方の完全なバックアップをとってください。
データベース
editアップデートスクリプトを実行しようとする前に、ウィキのデータベースの完全なバックアップをとってください。スキーマのアップデートに失敗しレコードが壊れたままになってしまった際の保険になります。MySQLについてくる MySQL dump などツールはいろいろあります。
設定
editLocalSettings.php
ファイルのコピーをとってください。これは基本的な設定の詳細や、もしあなたがしたのであれば、MediaWikiの動作のカスタマイズなどが記録されています。
アップロードされたファイル
editもしウィキのアップロード機能を有効にしているのであれば、アップロードディレクトリのバックアップもしておく必要があります。初期設定では、images
ディレクトリですが、もしかすると LocalSettings.php
で変更してあるかもしれません。
拡張機能とカスタムスキン
editextensions
ディレクトリやカスタムスキンを含むファイルやフォルダのすべてのコピーをとってください。
新しいファイルを展開する
edittarball パッケージを SourceForge からダウンロードしたのであれば展開し、Subversion を使ったのであれば、ファイルをどこか綺麗な場所にエクスポートしてください。それらで今あるファイルをディレクトリ構造を維持したまま上書きしてください。コアコードのアップデートは完了しました。
アップデートスクリプトを実行する
edit注意: ウィキのルートディレクトリに AdminSettings.php
ファイルがあり、正確な情報が記入されていることを確認してください。データベースのユーザは全権限が必要です。
アップデートの方法としては、コマンドラインからメンテナンススクリプトを実行するのが推奨されていますが、ウェブベースのインストーラを再実行することでも可能です。
シェル
editコマンドラインや SSH シェルなどで、maintenance
ディレクトリに移動し、アップデートスクリプトを実行します。
$ php update.php
MediaWiki はスキーマを調べ、新しいコードに必要なテーブルやカラムを追加します。1.5.x からアップグレードする場合は、この作業が終わったあとに、link テーブルを更新するために refreshLinks.php
スクリプトも実行するとよいでしょう。
他の選択肢: phpShell
editシェルにアクセスできないのであれば、phpShell のようなものも試してみるのもよいでしょう。phpShell は PHP の機能を使ってコマンドラインをエミュレートします。ホスティングサービスの設定によっては動かないかもしれません。
このような手段を用いる場合は、スクリプト開始時のカウントダウンを飛ばすことができたほうがよいこともあります。そうするには、--quick
オプションをアップデートスクリプトに渡してください:
$ php update.php --quick
インストーラを再実行する
editさらに別の選択肢として、ウェブインストーラを再実行することでもアップデートスクリプトを実行することができます:
LocalSettings.php
のファイル名をLocalSettings.php.old
に変更します。config
ディレクトリをウェブサーバが書き込み可能な状態にします。- ブラウザでウィキを開き、セットアップを開始します。
そして、インストールの時と同様にフォームを埋めてください。インストーラは MediaWiki のテーブルを検出し、スキーマをアップグレードします。完了すると新しい LocalSettings.php
ファイルが生成されます。
- 新しい設定ファイルを削除します。
LocalSettings.php.old
のファイル名をLocalSettings.php
に戻します。config
ディレクトリのパーミッションを元に戻します。
拡張機能をアップグレードする
editMediaWiki 1.7 で動作するようにアップデートされている拡張機能があります。それらの拡張機能も最新のバージョンにアップグレードするようにしてください。そのほかの拡張機能についても、自分で変更を加える必要があるかもしれません。
アップデートを確認する
editさて、アップグレードが完了したら、ブラウザでウィキを開いてページの閲覧や編集が望みどおりに動くかどうか確認しましょう。Special:Version を開き、正しいバージョンが表示されているかどうかも確認しましょう。
Links
editUpgradings documents for other versions: