Manual:Upgrading to 1.9/ja

From Linux Web Expert

{{{New Upgrade}}}

概略

まず、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 スクリプトも実行するとよいでしょう。

他の選択肢: phpShell

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

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

$ php update.php --quick

インストーラを再実行する

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

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

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

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

拡張機能をアップグレードする

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

アップデートを確認する

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

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

関連項目

他のバージョンへアップグレードする際の資料: