Manual:アップグレード
- mediawiki-1.42.1.tar.gz
- mediawiki-1.42.1.zip
- Git ブランチ: REL1_42
- mediawiki-1.41.2.tar.gz
- mediawiki-1.41.2.zip
- Git ブランチ: REL1_41
アルファ バージョン (MediaWiki 1.43 )
基本 的 な概要
ファイル転送
ファイル
- wget
- SCP または WinSCP でセキュアなコピー
- SSH File Transfer Protocol (SFTP)
- FTP クライアントを
使用 。 - ホスティング
会社 がウェブブラウザ経由 で使用 できるファイルマネージャーを用意 しているかもしれません。ご自分 が契約 しているプロバイダーを調 べましょう。 - その
他 の方法 。 これらのプロトコルの一覧 は w:List of file transfer protocols にあります
準備
MediaWikiに
要件 を確認 する- RELEASE-NOTES ファイルを
読 む - UPGRADE ファイルを
読 む 既存 のファイルとデータベースをバックアップする新 しいファイルを展開 する拡張 機能 をアップグレードする更新 スクリプトを実行 してデータベースをチェックする- アップグレードをテストする
過去 にインストールしたバージョンに由来 する残 ったファイルを除去 する
システム要件 の確認
MediaWiki 1.42 の
- PHP 8.1.0+
以下 のうちいずれか 1 つ:- MariaDB 10.3.0+
- MySQL 5.7.0+
- PostgreSQL 10.0+
- SQLite 3.8.0+
PostgreSQL をお
リリースノートを読 む
保留 中 のジョブの一掃
既存 のファイルとデータベースをバックアップする
完全 な説明 : Manual:ウィキのバックアップ
アップグレード・スクリプトは
- ウィキはコンテンツです。データベースから
表示 しています。(キャラクターセットの設定 は正確 に。最初 にLocalSettings.php
を確認 しましょう)。SQLデータベース・ダンプの他 にXMLダンプを作成 するのは良 いアイデアです。
- MySQLの
場合 、mysql
コマンドでSQL dumpとXML dumpを使用 します:
- MySQLの
mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb --xml > file.xml
- PostgreSQL の
場合 、データベースのダンプにはpg_restore
を使 います。以下 のように入力 してください:
- PostgreSQL の
pg_dump --create -Fc wikidb > file.db.dump
- SQLite の
場合 、バックアップ作成 には MediaWiki スクリプトを使用 します:
- SQLite の
php wikifolder/maintenance/sqlite.php --backup-to file
画像 と他 のメディアファイル (images
ディレクトリの内容 とカスタムロゴ /skins/common/images/wiki.png)設定 ファイル。例 えばLocalSettings.php
や.htaccess
(もしあれば)- MediaWikiのプログラムファイル。すべての
外装 や拡張 機能 、とくに利用 者 が修正 を加 えたもの。
新 しいファイルの展開
tarball パッケージの使用
FTPやコマンドラインを
LocalSettings.php
やimagesフォルダ、
FTP コマンドかグラフィカルか
コマンドラインからサーバへ
ローカルで
cPanel ファイル マネージャー
cPanel は
- ウィキ フォルダーのあるディレクトリに
遷移 します。 - mediawiki-1.xx.x.tar.gz ファイルをアップロードします。 「
再読 込 」を押 すと表示 される場合 があります。 - mediawiki-1.xx.x.tar.gz ファイルを
展開 します。 もう一度 再 読込 します。 - mediawiki-1.xx.x フォルダーが
存在 することを確認 します。 - tar.gz ファイルを
削除 します。 - Copy all necessary skins, extensions, image folders, customizations, and the
LocalSettings.php
into the new folder. (下記 参照 。) - When you are ready to run update.php, rename your old wiki folder and your new wiki folder. (e.g. "w" becomes "w1.34" and then "mediawiki1.35.0" becomes "w".) This step is easily reversible if you run into problems.
コマンドライン
sudo
でコマンドを
cd /path/to/your/new/installation/
wget https://releases.wikimedia.org/mediawiki/1.42/mediawiki-1.42.1.tar.gz
tar xvzf mediawiki-1.42.1.tar.gz
rm mediawiki-1.42.1.tar.gz
(Open)Solaris の
$ gzip -dc mediawiki-1.42.1.tar.gz | tar xf -
その他 のファイル
tarballを
LocalSettings.php
- contains your old configuration settings.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 で
パッチの使用
- MediaWikiディレクトリへ cdで
移 ってください。(一般 的 にLocalSettings.php
がある場所 となります。) - バッチファイルをダウンロードし、gunzipで
解凍 してください。 patch -p1 --dry-run
を使 って変更 されることを確認 します(例 えばpatch -p1 --dry-run -i mediawiki-x.xx.x.patch
)以上 がよろしければ、--dry-run
無 しでpatchを実行 してください。- 「
特別 :バージョン情報 」を確認 すると、新 しいバージョン番号 になっているはずです。
エラーを引 き起 こす可能 性 がある残留 ファイル
拡張 機能 のアップグレード
ディファレントtarballは
もし
<span id="Adapt_your_LocalSettings.php
">
今 までの LocalSettings.php
の適用
LocalSettings.php
をLocalSettings.php
をLocalSettings.php
を
外装 の登録
MediaWiki バージョン: | ≧ 1.24 |
MediaWiki 1.24から VectorやMonobookやModernやCologneBlueのようなLocalSettings.php
に
LocalSettings.php
に
wfLoadSkin( 'Vector' );
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Modern' );
wfLoadSkin( 'CologneBlue' );
拡張 機能 の登録
MediaWiki バージョン: | ≧ 1.25 |
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' );
Remove DefaultSettings.php line (if necessary)
Older versions of MediaWiki automatically generated a line in LocalSettings.php calling DefaultSettings.php . As of Version 1.38, this line is deprecated and does not work with many extensions. It needs to be removed.
Delete the following line:
require_once( "$IP/includes/DefaultSettings.php" );
その他 の変数
LocalSettings.php
の
更新 スクリプトの実行
MediaWiki データベースの
The script will also notify you if any of MediaWiki core's PHP dependencies are out of date.
コマンドライン
Access the command line of your server or an SSH shell or similar. You can access the command line by connecting to your server via SSH. Current versions of all major operating systems (including Windows 10 and 11) contain a command-line OpenSSH client either by default or as an installable feature. If the local PC you are working on runs Microsoft Windows, you may want to (or, if it’s 8.1 or older, have to) install PuTTY, which features a wizard-like interface (or a similar tool). From the command line or the Shell, execute the update script:
MediaWiki バージョン: | ≧ 1.40 |
$ php maintenance/run.php update.php
MediaWiki バージョン: | ≦ 1.39 |
$ php maintenance/update.php
Linux サーバーでエラーがupdate.php
を
MediaWikiは
What to do if it says "MediaWiki requires PHP x.y.z or higher; you are using PHP x.w.v"
See Manual:Common errors and symptoms#MediaWiki requires PHP 7.4.3 or higher; you are using PHP 7.3.17
What to do if php update.php fails to do anything, resulting in a quick pause and then return to command prompt
This can be caused by a malfunctioning extension or skin.
- Check that all extensions and skins called for in LocalSettings.php are present
- Check that extensions are using the correct registration method (wfLoadExtension vs. require_once)
- Comment out the first half of the extensions in LocalSettings.php.
If this causes update.php to work, uncomment half of that half (so 1/4 of the extensions). If this does NOT cause update.php to work, uncomment the first half but comment out the second half, and then comment out half of the second half, etc. Repeat until update.php works to find the one that is failing.
ALTER command denied to user エラー(類似 エラー)の対処 法
スクリプトが
Error: 1142 ALTER command denied to user 'wiki'@'localhost' for table 'mytable' (localhost) ERROR: must be the owner of the mytable relation
これは (
In some cases, an old $wgDBmwschema variable (for Postgres) seems to be read for the table name to update instead of $wgDBname, even when MySQL is used.
If this is the case, just get rid of the $wgDBmwschema
definition in LocalSettings.php
.
register_argc_argv is set to false エラーの対処 法
Cannot get command line arguments, register_argc_argv is set to false
- ~/maintenance に
行 き、既存 の'php.ini'を編集 するか、作成 してください。 以下 のように行 を追加 します:
register_argc_argv=true
php update.php
をもう一度 実行 します
Web ブラウザー
MediaWiki バージョン: | ≧ 1.17 |
- update.php も
参照 してください
データベースがすでに
- データベース・メンテナンスを
実行 する前 はいつでもバックアップしてください。 - ウェブ ブラウザーで
/mw-config/index.php
を開 きます。例 えば、ご利用 のウィキがhttp://example.org/w/index.php
にある場合 は、http://example.org/w/mw-config/index.php
を開 いてください。 使用 言語 を選択 し、「次 へ」をクリックします。- インストールされているウィキが
検出 されます。画面 に表示 される指示 に従 ってアップグレードします。
もし「アップグレードキー」を尋 ねられた場合 はLocalSettings.php ファイルを開 いて$wgUpgradeKey に割 り当 てられたキーを探 して下 さい。
ウェブ・アップデーターが
更新 のテスト
アップグレードが
複数 のページの閲覧 複数 のページの編集 - ファイルを
1 つアップロード - Special:Versionを
開 いて、表示 されるバージョンが正 しいか、拡張 機能 があるかを確認 します。
Remove leftovers from old installations
If you have copied your previous installation to another folder on the server, be sure to remove it or make it completely inaccessible from the web. It is very important to not leave old installations accessible from the web, since it completely defeats the purpose of upgrading, and leaves your server open to attacks.
よくある質問
アップグレードはどのくらい大変 ですか?
もし
1.4UPGRADE
ファイルの
あなたが
あなたが
本当 に古 いバージョンからどのようにアップグレードすれば良 いでしょうか?一 段階 で済 みますか?何 段階 もかかりますか?
MediaWiki バージョン: | ≦ 1.4 |
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.
(old_text
のmediumblob
であることをmediumtext
では
MediaWiki バージョン: | 1.5 – 1.35 |
MediaWiki 1.5
MediaWiki バージョン: | ≧ 1.35 |
If you are upgrading to MediaWiki 1.36 or later, only upgrades from the last two LTS releases will be supported (phab:T259771). This will mean that for very old versions, that you first upgrade to MediaWiki 1.35 and then upgrade to 1.36.
バックアップは第 一 にするべきですか?
アップグレードに
<span id="Can_I_keep_my_LocalSettings.php
?">
自分 の LocalSettings.php
を長持 ちさせることは出来 ますか?
はい、しかし
アップグレード中 にwikiをオンラインに出来 ますか?
MediaWikiのマイナーリリース
- MediaWikiの
新 バージョンを新規 ディレクトリに解凍 します。 新 しいバージョンのディレクトリの準備 :古 いバージョンのディレクトリから設定 済 みのLocalSettings.php
をコピーし、インストール済 みの拡張 機能 やカスタム外装 (ある場合 ) をコピーします。LocalSettings.php
の$wgLogo
および$wgLogos
の設定 を確認 して、必要 な場合 はロゴ ファイルを古 いバージョンのディレクトリから新 しい方 にコピーします。新 しいバージョンのリリース ノートに、LocalSettings.php
に行 う必要 のある変更 がないか調 べます。- 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.42.1'; 更新 スクリプトまたはウェブ アップデーターを新 バージョンのディレクトリで実行 する。古 いバージョンのディレクトリ内 の images サブ ディレクトリから新 バージョンのディレクトリに画像 をコピーする。古 いバージョンのディレクトリと新 バージョンのディレクトリを交換 する。 (This will make the database writable again, because $wgReadOnly was only set in the old directory's LocalSettings.php.)
アップグレードする理由
新 リリースの通知 を受 けるために mediawiki-announce を購読 しましょう。
関連 項目
- Greg Sabino Mullaneのブログでポイント・リリース(マイナーな
更新 )に関 する詳細 を知 ることが出来 ます。
- Help and Support if you need help or something went wrong