MediaWikiの設定 - アップグレード - 版の履歴

Wiki: Wiki がページ「MochiuWikiの設定 - アップグレード」を「MediaWikiの設定 - アップグレード」に、リダイレクトを残さずに移動しました

2024-01-13T02:10:00Z

Wiki がページ「MochiuWikiの設定 - アップグレード」を「MediaWikiの設定 - アップグレード」に、リダイレクトを残さずに移動しました

← 古い版		2024年1月13日 (土) 11:10時点における版
(相違点なし)

Wiki: /* 概要 */

2023-10-05T20:29:16Z

概要

@@ 14行目: / 14行目: @@
 <br>
 MediaWikiのアップグレードの詳細を知りたい場合は、[https://www.mediawiki.org/wiki/Manual:Upgrading/ja MediaWikiの公式Webサイト]を参照すること。<br>
 <br><br>

Wiki: /* アップグレードの実行 */

2023-07-27T20:03:18Z

アップグレードの実行

← 古い版		2023年7月28日 (金) 05:03時点における版
77行目:		77行目:
	<br>		<br>

	== アップグレードの実行 ==		==== アップグレードの実行 ====
	MediaWikiのデータベースの更新には2つの方法がある。<br>		MediaWikiのデータベースの更新には2つの方法がある。<br>
	１つはコマンドラインから行うもの、１つはWebブラウザから行うものである。<br>		１つはコマンドラインから行うもの、１つはWebブラウザから行うものである。<br>
86行目:		86行目:
	また、アップグレードスクリプトは、MediaWikiのPHPの依存関係が古くなった場合にも通知する。<br>		また、アップグレードスクリプトは、MediaWikiのPHPの依存関係が古くなった場合にも通知する。<br>
	<br>		<br>
	==== コマンドラインから行う場合 (推奨) ====		===== コマンドラインから行う場合 (推奨) =====
	maintenanceディレクトリに移動して、<code>update script</code>コマンドを実行する。<br>		maintenanceディレクトリに移動して、<code>update script</code>コマンドを実行する。<br>
	cd maintenance		cd maintenance
95行目:		95行目:
	アップグレードの完了後は、コマンドプロンプトの結果ウィンドウは自動的に閉じる。<br>		アップグレードの完了後は、コマンドプロンプトの結果ウィンドウは自動的に閉じる。<br>
	<br>		<br>
	==== Webブラウザから行う場合 (非推奨) ====		===== Webブラウザから行う場合 (非推奨) =====
	データベースが巨大な場合や稼働率が高い場合は、Webブラウザからアップグレードすべきではない。(コマンドラインから<code>update.php</code>コマンドを実行すべきである)<br>		データベースが巨大な場合や稼働率が高い場合は、Webブラウザからアップグレードすべきではない。(コマンドラインから<code>update.php</code>コマンドを実行すべきである)<br>
	これは、maximum_execution_timeに達した時、アップグレード処理がタイムアウトするからである。<br>		これは、maximum_execution_timeに達した時、アップグレード処理がタイムアウトするからである。<br>

Wiki: /* その他のファイル */

2023-07-27T20:01:58Z

その他のファイル

← 古い版		2023年7月28日 (金) 05:01時点における版
54行目:		54行目:
	<br><br>		<br><br>

	== その他のファイル ==		==== その他のファイル ====
	古いバージョンのMediaWikiにある特定のファイルを、新しいバージョンのMediaWikiにコピーする。<br>		古いバージョンのMediaWikiにある特定のファイルを、新しいバージョンのMediaWikiにコピーする。<br>
	<br>		<br>
75行目:		75行目:
	* 古いバージョンでインストールしたファイルや拡張機能に加えた修正等		* 古いバージョンでインストールしたファイルや拡張機能に加えた修正等
	* .htaccessファイル（Apacheを使用しており、何らかのルールを定義している場合）		* .htaccessファイル（Apacheを使用しており、何らかのルールを定義している場合）
	~~<br>~~<br>		<br>

	== アップグレードの実行 ==		== アップグレードの実行 ==

Wiki: /* MediaWikiのメジャーバージョンのアップグレード */

2023-07-27T20:01:43Z

MediaWikiのメジャーバージョンのアップグレード

← 古い版		2023年7月28日 (金) 05:01時点における版
40行目:		40行目:

	== MediaWikiのメジャーバージョンのアップグレード ==		== MediaWikiのメジャーバージョンのアップグレード ==
			==== MediaWikiのダウンロード ====
	[https://releases.wikimedia.org/mediawiki/ MediaWikiの公式Webサイト]にアクセスして、MediaWikiをダウンロードする。<br>		[https://releases.wikimedia.org/mediawiki/ MediaWikiの公式Webサイト]にアクセスして、MediaWikiをダウンロードする。<br>
	または、MediaWikiをインストールするディレクトリに移動して、<code>wget</code>コマンドを実行する。<br>		または、MediaWikiをインストールするディレクトリに移動して、<code>wget</code>コマンドを実行する。<br>

Wiki: /* 新しいバージョンのMediaWikiのインストール */

2023-07-27T20:00:16Z

新しいバージョンのMediaWikiのインストール

@@ 27行目: / 27行目: @@
 <br><br>
-== 新しいバージョンのMediaWikiのインストール ==
+== MediaWikiのマイナーバージョンのアップグレード ==
 [https://releases.wikimedia.org/mediawiki/ MediaWikiの公式Webサイト]にアクセスして、MediaWikiをダウンロードする。<br>
 または、MediaWikiをインストールするディレクトリに移動して、<code>wget</code>コマンドを実行する。<br>

Wiki: /* 新しいバージョンのMediaWikiのインストール */

2023-07-27T01:54:16Z

新しいバージョンのMediaWikiのインストール

← 古い版		2023年7月27日 (木) 10:54時点における版
28行目:		28行目:

	== 新しいバージョンのMediaWikiのインストール ==		== 新しいバージョンのMediaWikiのインストール ==
	~~MediaWikiをダウンロードする。~~<br>		[https://releases.wikimedia.org/mediawiki/ MediaWikiの公式Webサイト]にアクセスして、MediaWikiをダウンロードする。<br>
			または、MediaWikiをインストールするディレクトリに移動して、<code>wget</code>コマンドを実行する。<br>
	cd <MediaWikiのインストールディレクトリ>		cd <MediaWikiのインストールディレクトリ>
	wget https://releases.wikimedia.org/mediawiki/<バージョン>/mediawiki-<バージョン>.tar.gz		wget https://releases.wikimedia.org/mediawiki/<バージョン>/mediawiki-<バージョン>.tar.gz
	<br>		<br>
	~~MediaWikiのファイルを解凍する。~~<br>		ダウンロードしたファイルを解凍する。<br>
	tar xf mediawiki-<バージョン>.tar.gz		tar xf mediawiki-<バージョン>.tar.gz
	mv /mediawiki-<バージョン>/* ./		mv /mediawiki-<バージョン>/* ./

			# 不要なファイルおよびディレクトリを削除
	rm mediawiki-<バージョン>.tar.gz mediawiki-<バージョン>		rm mediawiki-<バージョン>.tar.gz mediawiki-<バージョン>
	<br><br>		<br><br>

Wiki: ページの作成:「== 概要 == * 既存のファイルとデータベースをバックアップする。 * 新しいバージョンのMediaWikiをダウンロードおよび解凍する。 * 拡張機能をアップグレードする。 * 更新スクリプトを実行してデータベースをチェックする。 * アップグレードをテストする。 * 過去にインストールしたバージョンに由来する残ったファイルを除去する。
MediaWiki 1.36…」

2023-07-24T02:10:22Z

ページの作成:「== 概要 == * 既存のファイルとデータベースをバックアップする。 * 新しいバージョンのMediaWikiをダウンロードおよび解凍する。 * 拡張機能をアップグレードする。 * 更新スクリプトを実行してデータベースをチェックする。 * アップグレードをテストする。 * 過去にインストールしたバージョンに由来する残ったファイルを除去する。 MediaWiki 1.36…」

新規ページ

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

== バックアップの取得 ==
既存のファイルとデータベースをバックアップする。 
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
 
次に、画像をバックアップする。 
これは、imagesディレクトリを圧縮するだけでよい。 
tar -cf /<出力するディレクトリ名>/MochiuWiki_images_backup_20200101.tar.gz /<MediaWikiのディレクトリ名>/images
 

== 新しいバージョンのMediaWikiのインストール ==
MediaWikiをダウンロードする。 
cd <MediaWikiのインストールディレクトリ>
wget https://releases.wikimedia.org/mediawiki/<バージョン>/mediawiki-<バージョン>.tar.gz
 
MediaWikiのファイルを解凍する。 
tar xf mediawiki-<バージョン>.tar.gz
mv /mediawiki-<バージョン>/* ./
rm mediawiki-<バージョン>.tar.gz mediawiki-<バージョン>
 

== その他のファイル ==
古いバージョンのMediaWikiにある特定のファイルを、新しいバージョンのMediaWikiにコピーする。 
 
* 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を使用しており、何らかのルールを定義している場合）
 

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

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

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