MediaWikiの設定 - アップグレードのソースを表示

== 概要 ==
* 既存のファイルとデータベースをバックアップする。
* 新しいバージョンのMediaWikiをダウンロードおよび解凍する。
* 拡張機能をアップグレードする。
* 更新スクリプトを実行してデータベースをチェックする。
* アップグレードをテストする。
* 過去にインストールしたバージョンに由来する残ったファイルを除去する。
<br>
MediaWiki 1.36以降は、2つの主要なLTSリリースからのアップグレードをサポートすることのみを保証している。<br>
<br>
MediaWikiの古いバージョンからのアップグレードは、複数のステップで実行する必要がある。<br>
例えば、MediaWiki 1.40にアップグレードする場合において、MediaWiki 1.34以前のバージョンからアップグレードする場合は、最初に1.34を1.35または1.39にアップグレードして、<br>
さらに 1.35または1.39から1.40にアップグレードする必要がある。<br>
<br>
MediaWikiのアップグレードの詳細を知りたい場合は、[https://www.mediawiki.org/wiki/Manual:Upgrading/ja MediaWikiの公式Webサイト]を参照すること。<br>
<br><br>

== システム要件 ==
MediaWikiは、PHP 7.4.3以降、MariaDB 10.3.0以降、MySQL 5.7.0以降、SQLite 3.8.0以降、PostgreSQL 10.0以降が必要となる。<br>
主にMariaDBで動作確認しているため、MariaDBまたはMySQLを使用することが推奨される。<br>
他のデータベースサーバはあまりテストされておらず、バグに遭遇する可能性がある。<br>
<br>
MediaWikiはアップストリームのバグによりPHP 7.4.0〜7.4.2と互換性が無いため、PHP 7.4.3以降を使用する必要がある。<br>
<br>
PHP 8を使用する場合、MediaWiki 1.38.4以降を使用することが推奨される。<br>
<br><br>

== バックアップの取得 ==
既存のファイルとデータベースをバックアップする。<br>
 mysqldump -Q --host=$MYSQL_SERVER --user=$MYSQL_USER --password=$MYSQL_PASSWD --default-character-set=binary --hex-blob $MYSQL_DB_NAME > MochiuWiki_DB_backup_20200101.sql
 または
 mysqldump --host=$MYSQL_SERVER --user=$MYSQL_USER -p --default-character-set=utf8mb4 $MYSQL_DB_NAME > MochiuWiki_DB_backup_20200101.sql
<br>
次に、画像をバックアップする。<br>
これは、imagesディレクトリを圧縮するだけでよい。<br>
 tar -cf /<出力するディレクトリ名>/MochiuWiki_images_backup_20200101.tar.gz /<MediaWikiのディレクトリ名>/images
<br><br>

== MediaWikiのマイナーバージョンのアップグレード ==
マイナーバージョンは、主にセキュリティ修正と時折の機能を含むバグ修正である。<br>
(例 : 1.39.2 => 1.39.3)<br>
<br>
新しいマイナーバージョンがメジャーバージョンのMediaWikiのためにリリースされた時、タイムリーにアップグレードすることが重要である。<br>
アップグレードしない場合、未修正のセキュリティ問題によってMediaWikiが脆弱な状態になる可能性がある。<br>
<br>
マイナーバージョンのアップグレードは簡単であり、MediaWikiのファイルやディレクトリを置き換えるだけである。<br>
データベースのアップグレードは不要である。<br>
また、拡張機能はMediaWiki自身と共にチェックされるため、アップグレードする必要はない。<br>
<br><br>

== MediaWikiのメジャーバージョンのアップグレード ==
==== MediaWikiのダウンロード ====
[https://releases.wikimedia.org/mediawiki/ MediaWikiの公式Webサイト]にアクセスして、MediaWikiをダウンロードする。<br>
または、MediaWikiをインストールするディレクトリに移動して、<code>wget</code>コマンドを実行する。<br>
 cd <MediaWikiのインストールディレクトリ>
 wget https://releases.wikimedia.org/mediawiki/<バージョン>/mediawiki-<バージョン>.tar.gz 
<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf mediawiki-<バージョン>.tar.gz
 mv /mediawiki-<バージョン>/* ./
 
 # 不要なファイルおよびディレクトリを削除
 rm mediawiki-<バージョン>.tar.gz mediawiki-<バージョン>
<br><br>

==== その他のファイル ====
古いバージョンのMediaWikiにある特定のファイルを、新しいバージョンのMediaWikiにコピーする。<br>
<br>
* LocalSettings.php
* imagesディレクトリ
*: 初期設定では、MediaWikiにアップロードした全てのファイルが配置されている。
*: imagesディレクトリおよびディレクトリ内にあるファイルの所有権と権限を変更する。
*: 例: <code>find ./images -type d -exec chmod 755 {} \;</code> と <code>chgrp -R <ユーザ名> ./images</code>
* extensionsディレクトリ内の拡張機能
*: MediaWikiのバージョンに合致した拡張機能のバージョンを取得する。
*: 古いバージョンの拡張機能が新しいバージョンのMediaWikiで動作する保証はない。
* カスタムロゴファイル
*: カスタムロゴファイルを使用している場合は、バックアップからファイルを復元する必要がある。
*: MediaWiki 1.24以前は、skins/common/imagesディレクトリ
*: MediaWiki 1.24以降は、resources/assetsディレクトリ、または、imagesディレクトリ （ただし、ユーザの設定による）
*: LocalSettings.phpファイルに、<code>$wgLogo = "$wgScriptPath/images/logo.png";</code>等の設定を記述する。
*: Mediawiki 1.35では、wgLogosからロゴを復元して、LocalSettings.phpファイルに設定を追記する必要がある。
*: 例: <code>$wgLogos = [ '1x' => "path/to/1x_version.png", '2x' => "path/to/2x_version.png", 'svg' => "path/to/svg_version.svg" ];</code>
* skinsディレクトリにあるカスタム外装
* 古いバージョンでインストールしたファイルや拡張機能に加えた修正等
* .htaccessファイル （Apacheを使用しており、何らかのルールを定義している場合）
<br>

==== アップグレードの実行 ====
MediaWikiのデータベースの更新には2つの方法がある。<br>
１つはコマンドラインから行うもの、１つはWebブラウザから行うものである。<br>
<br>
もし、サーバのシェルにアクセスできる場合、コマンドラインによる更新を推奨する。<br>
これは、タイムアウトやコネクションリセットによるアップグレード処理の中断のリスクを減らすことができるからである。<br>
<br>
また、アップグレードスクリプトは、MediaWikiのPHPの依存関係が古くなった場合にも通知する。<br>
<br>
===== コマンドラインから行う場合 (推奨) =====
maintenanceディレクトリに移動して、<code>update script</code>コマンドを実行する。<br>
 cd maintenance
 php update.php または sudo php update.php
<br>
Windows上でXAMPP環境を使用している場合は、まず、Webサーバやデータベースが実行中であることを確認する。<br>
その後、<code>update.php</code>コマンドを実行する。 (右クリックで[開く]を選択して、<code>PHP.exe</code>コマンドを実行する)<br>
アップグレードの完了後は、コマンドプロンプトの結果ウィンドウは自動的に閉じる。<br>
<br>
===== Webブラウザから行う場合 (非推奨) =====
データベースが巨大な場合や稼働率が高い場合は、Webブラウザからアップグレードすべきではない。(コマンドラインから<code>update.php</code>コマンドを実行すべきである)<br>
これは、maximum_execution_timeに達した時、アップグレード処理がタイムアウトするからである。<br>
<br>
稼働しているサーバに大きく依存する。(例: パフォーマンスやロードやスクリプト実行をどのくらい許すかというPHPの最大実行時間等）<br>
<br>
# WebブラウザのURL入力欄において、http(s)://<ドメイン名>/mw-config/ を開く。(例: 使用中のMediaWikiが http://example.org/w/index.php にある場合は、http://example.org/w/mw-config/ を開く)
# 言語選択画面が表示されるので、使用言語を選択し、[次へ]を選択する。
# インストールされているMediaWikiが検出されるので、画面に表示される指示に従ってアップグレードする。
# アップグレードキーを尋ねられた場合は、LocalSettings.phpファイルを開いて<code>$wgUpgradeKey</code>に割り当てられたキーを入力する。
<br>
※注意 1<br>
Webアップデータが作動していないように見える場合(言語選択画面が表示される代わりに、空のWikiページが表示される)、WebサーバーがRewriteルールを使用している可能性が高い。<br>
(mw-configでは、Webアップデータを表示せず、頭文字が大文字のMw-config/の時は表示する等)<br>
この場合、.htaccessファイルの名前をアップデートの時だけ変更することにより、Webアップデータにアクセスすることができる。<br>
<br>
ただし、この方法を使用した場合は、アップグレードスクリプトを実行した後に、必ず、.htaccessファイルの名称を元に戻すこと。<br>
さもなければ、short URLや他のファイル等が破損する恐れがある。<br>
<br><br>

== アップグレード後のテスト ==
アップグレードの完了後は、WebブラウザからMediaWikiを閲覧して、以下に示す操作が期待通りにできるかを確認する。<br>
* 複数のページの閲覧
* 複数のページの編集
* ファイルをアップロード
* Special:Versionのページにアクセスして、表示されるバージョンが正しいかどうか、または、拡張機能が正常かどうかを確認する。
<br><br>

__FORCETOC__
[[カテゴリ:MochiuWikiの設定]]