ファイル転送

ファイル転送の方法を選択してください:

• wget
• SCP または WinSCP でセキュアなコピー
• SSH File Transfer Protocol (SFTP)
• FTP クライアントを使用。
• ホスティング会社がウェブブラウザ経由で使用できるファイルマネージャーを用意しているかもしれません。ご自分が契約しているプロバイダーを調べましょう。
• その他の方法。 これらのプロトコルの一覧は w:List of file transfer protocols にあります

準備

MediaWikiに含まれるUPGRADE テキストファイルを読みましょう。

1. 要件を確認する
2. RELEASE-NOTES ファイルを読む
3. UPGRADE ファイルを読む
4. 既存のファイルとデータベースをバックアップする
5. 新しいファイルを展開する
6. 拡張機能をアップグレードする
7. 更新スクリプトを実行してデータベースをチェックする
8. アップグレードをテストする
9. 過去にインストールしたバージョンに由来する残ったファイルを除去する

tarball パッケージの使用

FTPやコマンドラインを使って、新しいファイルを設置することが出来ます。もし可能ならコマンドラインを使いましょう！FTPを通して数千のファイルを一つづつアップロードするよりもコマンドラインの方がだんぜん速いです。

$ gzip -dc mediawiki-1.43.1.tar.gz | tar xf -

その他のファイル

tarballを展開した後、古いバージョンをインストールしたディレクトリから新しい方へ幾つかのファイルやフォルダをコピーします:

• LocalSettings.php - 古い設定が含まれています。
• imagesディレクトリ（古いバージョンの場合はuploadsディレクトリ）。初期設定では、ウィキにアップロードした全てのファイルが入っています。所有権と権限を変更してください。find ./images -type d -exec chmod 755 {} \;とchgrp -R apache images（ウェブユーザーが"apache"の場合）を実行します。
• extensionsディレクトリ内の拡張機能。出来れば拡張機能も新しいバージョンを取得すべきです。古い拡張機能が新しいバージョンのMediaWikiで動く保証はありません。
• custom logoを使用している場合は、バックアップからファイルを復元する必要があります。1.24以前はskins/common/images/、1.24以降はresources/assets/かimages/ (利用者の設定による)。 それから LocalSettings.php に例えば$wgLogo = "$wgScriptPath/images/logo.png";を追加します。
• バージョン1.35では、wgLogos からロゴを復元し、LocalSettings.php に設定を追記する必要があるかもしれません (例: $wgLogos = [ '1x' => "path/to/1x_version.png", '2x' => "path/to/2x_version.png", 'svg' => "path/to/svg_version.svg" ];)。
• skins ディレクトリからカスタム外装。
• 古いバージョンでインストールしたファイルや拡張機能に加えた修正。
• .htaccess ファイル（Apacheを使用し、何かルールを定義した場合）

完了したら、新しいフォルダをウェブサーバーの公開フォルダにします。もしくは古いインストールディレクトリの名前を変更して、新しい方を古い方の名前に変更します。 ウェブ サーバーがファイルにアクセスできるように、すべてのファイルの所有者とグループを変更します。

Git の使用

Git を使用する場合は、ファイルをクリーンな場所にエクスポートし、前の節で説明したように、古いカスタマイズ済みのファイルを新しい場所にコピーします。

Composer で使用している外部の PHP ライブラリやウィキメディアのウィキ ファームを保守するために提供されているコレクションもインストールする必要があるでしょう。 インストールや外部ライブラリの更新の詳細はGit ダウンロードの説明文書ドキュメントで見つけることができます。

パッチの使用

小型パッチは通常マイナーなバージョン アップグレードに使用されます。 パッチを適用するには、patchをダウンロードしてください。 ダンプ サイトからパッチ ファイルを手動でダウンロードして抽出して、下記の wget の指示に従います。 増分パッチなので、バージョンをスキップすることはできません。

1. MediaWikiディレクトリへ cdで移ってください。(一般的に LocalSettings.php がある場所となります。)
2. バッチファイルをダウンロードし、gunzipで解凍してください。
3. patch -p1 --dry-runを使って変更されることを確認します（例えば patch -p1 --dry-run -i mediawiki-x.xx.x.patch）
4. 以上がよろしければ、--dry-run無しでpatchを実行してください。
5. 「特別:バージョン情報」を確認すると、新しいバージョン番号になっているはずです。

エラーを引き起こす可能性がある残留ファイル

古いバージョンをインストールしたディレクトリに新しいバージョンを解凍した場合、幾つかの古いファイルが問題を引き起こすかもしれません。

外装の登録

MediaWiki 1.24から VectorやMonobookやModernやCologneBlueのような同梱された外装はMediaWiki のコアの一部ではなくなりました。それらを使用するためにはLocalSettings.phpに明示的に設定する必要があります。もしそうしないとMediaWiki は外装がインストールされていないと警告します。

以下の設定は、1.24 未満のバージョンからアップグレードして、以前同梱されていた外装の 1 つを使用したい場合に LocalSettings.php に追加する必要があるものです:

wfLoadSkin( 'Vector' );
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Modern' );
wfLoadSkin( 'CologneBlue' );

他の外装は新しいskin registrationシステムに未だ適用されていないと思われるので、問題が生じた場合は、外装ごとに適切な登録方法をドキュメント・ページで参照してください。

拡張機能の登録

MediaWiki 1.25より、新しい 拡張機能の適用 システムが使われています。

以前は LocalSettings.phpで以下のようにインクルードしていたと思われます:

require_once "$IP/extensions/Cite/Cite.php";
require_once "$IP/extensions/Gadgets/Gadgets.php";
require_once "$IP/extensions/ImageMap/ImageMap.php";
require_once "$IP/extensions/InputBox/InputBox.php";
require_once "$IP/extensions/Nuke/Nuke.php";
require_once "$IP/extensions/ParserFunctions/ParserFunctions.php";
require_once "$IP/extensions/Poem/Poem.php";
require_once "$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php";
require_once "$IP/extensions/WikiEditor/WikiEditor.php";

1.25より、以下のように置き換わります:

wfLoadExtension( 'Cite' );
wfLoadExtension( 'Gadgets' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'Nuke' );
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'Poem' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
wfLoadExtension( 'WikiEditor' );

拡張機能は新しい拡張機能登録システムを使用するように作られています。 適合しない拡張機能は古い方法を使ってインストールすべきです。 詳細は各拡張機能のページのインストール指示を参照してください。

DefaultSettings.php の行を除去 (必要に応じて)

以前のバージョンの MediaWiki では、DefaultSettings.php を呼び出す LocalSettings.php 内の行が自動生成されていました。 バージョン 1.38 以降、この行は廃止予定となり、多くの拡張機能と互換性がありません。 除去する必要があります。

以下の行を削除します:

require_once( "$IP/includes/DefaultSettings.php" );

If you are upgrading to 1.40 or above, Extension:RenameUser has been merged into core. If present, this line must be deleted from LocalSettings.php or the update will fail.

wfLoadExtension( 'Renameuser' );

その他の変数

幾つかの変数は旧式になり、廃止された物もあります。 LocalSettings.php の中にそれらの変数があっても、何の効果もありません。 新しいバージョンでは新しい変数が追加されたり、既存の変数の型が変更になっている事があります。 MediaWikiは変数をまず既定値で使用してみて、型が変わっている場合は、後方互換性で使用します。 どのような場合でも、リリースノートより変更点を見てください。

コマンドライン

自分のサーバーのコマンド ラインにアクセスするか、または SSH シェル、その他似た方法を使用してください。 Windows 10 や 11 を含む主な OS の最新版にはコマンド ライン OpenSSH クライアントが標準搭載されているか、インストール可能な機能となっています。 使用しているローカル PC が Microsoft Windows で動作している場合 (Windows 8.1 以前のバージョンの場合は必須ですが)、好みに合わせて PuTTY というウィザードに似たインターフェイスを持つツール、または類似のツールをインストールしたくなるかもしれません。 コマンド ラインまたはシェルからupdate スクリプトを実行してください:

$ php maintenance/run.php update

$ php maintenance/update.php

Linux サーバーでエラーが表示されたら、root としてコマンドを実行してください (sudo コマンドを使用)。 Windows 上の単純なインストレーション (例えば XAMPP でインストール) の場合: まず最初にウェブ サーバー (例えば Apache) やデータベース (例えば MySQL) が実行中であることを確認してください。 それから update.php を実行します (右クリックで「開く」を選択して PHP.exe)。 スキーマのアップグレードが完了したら、コマンド プロンプトの結果ウィンドウは自動的に閉じるようです。

MediaWikiは既存のスキーマを検査して、新しいコードが動くように更新し、必要に応じてテーブルやカラムを追加します。

この原因で update.php が動作する場合、その半分をコメント解除します (つまり、拡張機能の 4 分の 1)。 update.php が動作しない場合、最初の半分をコメント解除し、残りの半分をコメント アウトし、その後、2番目の半分を半分にしてコメント アウトします。 update.php が動作するようになるまでこの作業を繰り返し、どれが失敗しているのかを特定します。

Error: 1142 ALTER command denied to user 'wiki'@'localhost' for table 'mytable' (localhost)
ERROR: must be the owner of the mytable relation 

Cannot get command line arguments, register_argc_argv is set to false

register_argc_argv=true

Web ブラウザー

update.php も参照してください

データベースがすでに巨大だったり、稼働率が高い場合は、ウェブアップデートを使用すべきではありません。その理由は例えばmaximum_execution_timeに達した時、更新処理はタイムアウトするからです。そういう場合は （Webではなく）コマンドラインからupdate.phpを使用すべきです。これはまったくもってユーザーのサーバーに「大きすぎるほど大きく」依存します（例えばパフォーマンスやロードやスクリプト実行をどのくらい許すかというPHPの最大実行時間など）。Wikiがウェブアップデートを使用するには大きすぎるのに、ユーザーのホスティング会社がコマンドライン・アクセスを許可しない場合は、Wikiを他のホスティング会社に移す必要があります。できればシェル・アクセスが出来る会社が良いです。

1. データベース・メンテナンスを実行する前はいつでもバックアップしてください。
2. ウェブ ブラウザーで /mw-config/index.php を開きます。 例えば、ご利用のウィキが http://example.org/w/index.php にある場合は、http://example.org/w/mw-config/index.php を開いてください。
3. 使用言語を選択し、「次へ」をクリックします。
4. インストールされているウィキが検出されます。画面に表示される指示に従ってアップグレードします。
   もし「アップグレードキー」を尋ねられた場合はLocalSettings.php ファイルを開いて$wgUpgradeKey に割り当てられたキーを探して下さい。

ウェブ・アップデーターが作動しないように思える時があるかもしれません。最初の言語選択画面が表示される代わりに、空のWikiページが表示されるかもしれません。この場合、ユーザーのウェブサーバーがRewriteルールを使用している可能性が高いです（特にshort URLs）。これはmw-configではウェブアップデーターを表示せず、頭文字が大文字のMw-config/の時は表示します。この場合、.htaccessファイルの名前をアップデートの時だけ変更してください。そうすればウェブ・アップデーターにアクセスすることが出来るでしょう。

警告:	この方法を使った場合はアップグレード・スクリプトを実行した後に、必ず「.htaccessファイルの名称を元に戻して」ください。そうしないとshort URLやもしかすると他の物が壊れます！

アップグレードはどのくらい大変ですか?

もし修正したファイルがLocalSettings.php だけで、1.5以降からアップグレードするなら、作業はとても単純です。人間の作業は数分だけです。データベース・スキーマの変更時間はユーザーのデータベースの大きさに比例します。数百万ページのWikiなら数時間かかる可能性があります。しかし千ページ以下の典型的な大きさなら、通常は数秒で完了します。

例えば 1.42.0 から 1.42.6 のようにメジャー バージョンが同じの「マイナー アップグレード」では、スキーマの変更は全く必要ありません。 利用者はファイルの更新だけで済みます。データベースの更新は必要ありません。従ってアップデーター スクリプトの実行は必要ありません。

1.4以前からのアップグレードは複雑になる可能性があります。その理由はUTF-8以外の文字セットへの対応が廃止され、大量の文章データを並べ替えるソート構造が変わったからです。UPGRADEファイルの関連する節を読んで下さい。

あなたが私たちのソースコードを修正していて、修正を上書きされたくない場合は、アップグレードは複雑になります。diff、patch、MeldやWinMergeのようなツールが役に立つかもしれません。あなたが維持管理がなされていない拡張機能を使用している場合も、手間がかかる可能性があります。MediaWikiを更新する時は、拡張機能も一緒に更新しましょう。

あなたが外装を修正したり、カスタム外装を使用している場合は、それらが新しいバージョンのMediaWikiで動くように調整しなければならなくなる可能性が高いでしょう。

本当に古いバージョンからどのようにアップグレードすれば良いでしょうか？一段階で済みますか？何段階もかかりますか？

It depends: If you are upgrading from MediaWiki 1.4 or older, you should upgrade to MediaWiki 1.5 first. If you are upgrading from a Latin-1 wiki, use upgrade1_5.php (found in MediaWiki 1.5) to convert the relevant parts of the database to UTF-8 ($wgUseLatin1 needs to be set to true in your LocalSettings.php for this to work). Next, run update.php, and then set the $wgLegacyEncoding option in LocalSettings.php to the encoding previously used by the wiki (e.g. windows-1252). This is basically how Wikipedia and other Wikimedia Foundation sites were upgraded from MediaWiki 1.4 to 1.5 – see some related notes at Wikitech. You may need to upgrade to MediaWiki 1.4 before running the upgrade1.5 script. （例えばMySQLの）Latin-1のウィキのデータベース・ダンプを行いたい場合、text テーブルの old_text の型が mediumblob であることを確認してください。mediumtext では文字エンコーディングの問題を避けられません。

MediaWiki 1.5 以降から 1.35 にアップグレードする場合は、古いバージョンから最新の安定バージョンに1ステップでアップグレードできます。 数多くの報告や自動テストが非常に上手く行くと指示しています。 あなたがもしそれを信じられないなら、メーリングリストのこの投稿を読んで下さい。 しかし注意して頂きたいことは、もしあなたが古い版から更新するならば、直前の版から更新する時よりもPHPエラーに遭遇する場合が多くなります。 バージョンをスキップしていなければ、とにかくこれらのエラーを受け取っていたでしょうが、エラーは個々の更新に関連付けられていたでしょう。 Instead, if you update several versions at once, you'll get the same set of errors all at the same time. この場合、更新が更に難しくなるでしょうが、あなたが飛ばした途中の版に更新すれば、その不具合が起きないことをお忘れなく！

バックアップは第一にするべきですか?

簡潔な回答: はい。

長い回答：a) あなたは自分のデータをどのくらい高く評価するか、b) バックアップ作成がどのくらい大変か、c) あなたはMySQLの保守管理にどのくらい自信があるかによります。

アップグレードに失敗すると、あなたのデータベースは２つの版の間で矛盾した状態になるかもしれません。 更新中にPHPやMySQLエラーが発生すると、あなたのデータベースは一部だけ更新された状態になってしまうかもしれません。 そのような状況でも、たくさん手作業をすれば、なんとか問題を修正できるかもしれません。 しかしもっと簡単な方法があります。それはupdate.phpを実行して足踏みをする前にちょっとデータベースをバックアップすることであり、その後も継続的に行う事です。 そうしないと不要な作業を何時間もすることになるかもしれませんよ。

復旧は複雑になりがちです。 もしあなたがバックアップを怠って、更新関係の破損から復旧したいと助けを求めても、サポート フォーラムのボランティア達は好印象を持たないでしょう。 よりよい対応は、あなたがご自分のバックアップで復旧して、MediaWiki プロジェクトの担当者に更新処理の不具合を報告することです。

<span id="Can_I_keep_my_LocalSettings.php?">

自分の LocalSettings.php を長持ちさせることは出来ますか？

はい、しかし利用者は幾つかのマイナーな変更を行わなければならないかもしれません。LocalSettings.php のフォーマットは大部分に後方互換性があります。 LocalSettings.php の互換性を壊すような変更はリリースノートの「後方互換性のない変更」節に文章化されて公表されます。

アップグレード中にwikiをオンラインに出来ますか？

一般的には YES です。しかし、Git でアップグレードすると、Git は一時的に (数秒間) ウィキを壊す可能性があります。

MediaWikiのマイナーリリース間のアップデートなら、行うべきことはソースファイルを更新するだけです。

注意: 以下はコマンドラインによる操作を想定しています。MediaWikiのメジャーリリース間のアップデートを行う場合に推奨される手順は以下の通りです:

1. MediaWikiの新バージョンを新規ディレクトリに解凍します。
2. 新しいバージョンのディレクトリの準備: 古いバージョンのディレクトリから設定済みの LocalSettings.php をコピーし、インストール済みの拡張機能やカスタム外装 (ある場合) をコピーします。 LocalSettings.php の $wgLogo および $wgLogos の設定を確認して、必要な場合はロゴ ファイルを古いバージョンのディレクトリから新しい方にコピーします。
3. 新しいバージョンのリリース ノートに、LocalSettings.php に行う必要のある変更がないか調べます。
4. In the old directory, edit LocalSettings.php and insert the following code. This will place the database in read-only mode for regular wiki activity, without restricting your own update actions. Users will see the message provided if they attempt an edit during the upgrade process:
   
   $adminTask = ( PHP_SAPI === 'cli' || defined( 'MEDIAWIKI_INSTALL' ) );
   $wgReadOnly = $adminTask ? false : 'Upgrading to MediaWiki 1.43.1';
5. 更新スクリプトまたはウェブ アップデーターを新バージョンのディレクトリで実行する。
6. 古いバージョンのディレクトリ内の images サブ ディレクトリから新バージョンのディレクトリに画像をコピーする。
7. 古いバージョンのディレクトリと新バージョンのディレクトリを交換する。 (This will make the database writable again, because $wgReadOnly was only set in the old directory's LocalSettings.php.)

アップグレードする理由

新リリースの通知を受けるために mediawiki-announce を購読しましょう。

最近のリリースではあなたのウィキやホストを荒らし行為から守り安全に保つためのセキュリティ修正を受け取れる一方で、旧版のリリースでは (バージョン ライフサイクル を見れば分かるように) 受け取れません。

新しいメジャーリリースはあなたが使いたくなるような新しい機能を備えています。詳細はリリースノートを参照してください。