View source for Manual:Restoring a wiki from backup/ja

<languages/>
例え復元する必要がないウィキであっても、定期的に[[Special:MyLanguage/Manual:Backing up a wiki|ウィキのバックアップ]]を実施すべきです。バックアップは安心を与えてくれます。
ところが、バックアップは復元'''できない'''と役に立ちません。バックアップを復元すれば後の面倒な作業をしなくて済むのです。
以下はその方法についての説明です。

<span id="Versions_and_upgrading"></span>
== バージョンとアップグレード ==
このページにある説明は概ねどのバージョンの MediaWiki にも通用する内容となっているでしょう。
データベースはより新しいバージョンの MediaWiki に復元できますが、[[Special:MyLanguage/Manual:Upgrading#Run the update script|更新スクリプト]]を忘れず実行するようにしてください。
新しいバージョンのデータベースを古いバージョンのソフトウェアに復元する操作はサポートしていません。

<span id="File_transfer"></span>
=== ファイル転送 ===

ウィキを置いているサーバへ直接アクセスできない場合、ファイルを転送する方法を選ぶ必要があります。

* [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html putty] または [[:ja:WinSCP|WinSCP]] を使って安全にコピーする
* [[:ja:SSH File Transfer Protocol|SSH ファイル転送プロトコル]]（SFTP）
* [[:ja:File Transfer Protocol|FTP]] クライアントを使う
* ホスティング会社がウェブブラウザを使ったファイル管理インタフェースを提供しているかもしれません。提供会社から提供されている情報を確認してください。
* この他の手段は、これらの手法を記した[[w:en:List of file transfer protocols|ファイル転送プロトコル一覧]]に記載されています。

<span id="Overview"></span>
== 概要 ==

# データベース、ユーザ、アクセス権限の再構築
# データベースのバックアップのインポート
# MediaWikiファイルのインポート
# 設定ファイルの確認
# テスト

<span id="Re-create_the_database,_user_and_permissions"></span>
== データベース、ユーザ、アクセス権限の再構築 ==

サーバにMediaWikiを復元するとき、以下の環境が満たされていることを確認してください。

# 正常に動作するMySQLデータベースサーバがあること
# あなたがMySQLのrootユーザを利用できない場合、必要な権限を持ったMySQLユーザを利用できること

<div class="mw-translate-fuzzy">
データベースが壊れたためにバックアップから復元しようとしているなら、MySQLの再インストールを検討してください。MySQLが正常動作しているなら、新たなMySQLデータベースをつくり、あなたのユーザがアクセスできるよう下記のデータベースで権限を付与してください。どうやってそれを行うのかについては、[$mysql-doc/ MySQL文書]、あなたのサーバを提供するサービスプロバイダの設定パネルの文書、あるいはその他のあなたが使っているユーティリティに関する文書を調べる必要があるかもしれません。MySQLのrootユーザであれば、MySQLプロンプトから以下の操作を行うことができます。
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">Once MySQL is working properly, create a new MySQL database and grant your user account permissions on the database listed below.</span> <div lang="en" dir="ltr" class="mw-content-ltr">
You may need to consult the [https://dev.mysql.com/doc/ MySQL documentation], your hosting provider's control panel documentation, or the documentation of any other utilities you are using for information on how to do this.
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">From the MySQL prompt as MySQL user root you can:</span>
<!-- I used &#39; in the second line instead of six times an ' which looks even more confusing ~~~ --> 

 CREATE DATABASE '''''wikidb''''';
 CREATE USER '''''wikidb_user''''' IDENTIFIED BY &#39;'''''wikidb_userpassword'''''&#39;;
 
 USE '''''wikidb''''';
 GRANT SELECT, UPDATE, INSERT, DELETE, ALTER, CREATE, INDEX, DROP, LOCK TABLES, USAGE ON '''''wikidb.*''''' TO '''''wikidb_user''''';

{{Note|1=<span class="mw-translate-fuzzy">データベースの名前は上記事例と同じでなくても構いません。実際、商用ホスティング環境ではホスティングアカウント名の接頭辞がつくことがよくあり、ほとんどは別の名前のデータベースに対して権限が与えられています。さらに、ユーザ名やパスワードも別の値を使って結構です。また $ls を新たな別の場所に置いた場合は、それに合うよう設定を調整してください。</span> <span lang="en" dir="ltr" class="mw-content-ltr">In addition, the username can differ, as can that user's password.</span> <span lang="en" dir="ltr" class="mw-content-ltr">You will have to adjust the <code>LocalSettings.php</code> file on the new location accordingly.</span>}}

<span id="Import_the_database_backup"></span>
== データベースのバックアップのインポート ==
''See also [[Manual:Importing XML dumps]]''

<div class="mw-translate-fuzzy">
次に[[Special:MyLanguage/Manual:Backing up a wiki#Database|データベースのバックアップ]]を復元します。この操作によりデータベース内にテーブルが作成され、データも復元されます。取り込みにはしばらく時間がかかりますが、所要時間はウィキ内のページ数、ユーザ数、版の数に依存します。
</div> <span lang="en" dir="ltr" class="mw-content-ltr">This will create the tables in the database and populate them with data.</span> <div lang="en" dir="ltr" class="mw-content-ltr">
Importing takes a variable amount of time, depending upon the number of pages, users, edits, etc. in your wiki.
</div>

<span id="Methods"></span>
=== 方法 ===

<span id="From_the_command_line_using_mysqladmin"></span>
==== <code>mysqladmin</code>を使ってコマンドラインから実行する ====

データベースが既に存在しバックアップと完全に入れ替える場合は、既存のデータベースを削除します。

 mysqladmin -u '''''wikidb_user''''' -p drop '''''wikidb'''''

<span class="mw-translate-fuzzy"><code>'''''wikidb_user'''''</code> と <code>'''''wikidb'''''</code> はしかるべき値に置き換えてください。$p パラメータをつけるとパスワード入力を促すプロンプトが出ます。</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The <code>-p</code> parameter will prompt you for the password.</span>

次に新たなデータベースをつくります。

 mysqladmin -u '''''wikidb_user''''' -p create '''''wikidb'''''

<span lang="en" dir="ltr" class="mw-content-ltr">For example after backing up with [http://dev.mysql.com/doc/refman/5.0/en/mysqldump.html mysqldump]:</span>
 # <span lang="en" dir="ltr" class="mw-content-ltr">Don't do this now: This is how you might have created a backup earlier.</span>
 mysqldump --default-character-set=binary --user='''''wikidb_user''''' --password='''''wikidb_userpassword''''' '''''wikidb''''' > '''''dump_of_wikidb.sql'''''
 # <span lang="en" dir="ltr" class="mw-content-ltr">The wikidatabase '''''wikidb''''' from which you backed up may have a different name</span>
 # <span lang="en" dir="ltr" class="mw-content-ltr">than the wikidatabase '''''wikidb''''' you've created above. Of course '''''wikidb_user''''' and</span>
 # <span lang="en" dir="ltr" class="mw-content-ltr">'''''wikidb_userpassword''''' may be different as well.</span>

<div class="mw-translate-fuzzy">
正しい文字セットを指定してください。そうしないと復元に失敗します。
<code>LocalSettings.php</code>を見て指定するべき文字セットを確認してください。
</div>

コマンドラインから <code>'''''dump_of_wikidb.sql'''''</code> を取り込む場合、必要となるのは以下のコマンドだけです。

 mysql -u '''''wikidb_user''''' -p '''''wikidb''''' < '''''dump_of_wikidb.sql'''''

その後、[[Special:MyLanguage/Manual:update.php|必要があれば]]以下の操作も行ってください:

 php '''''wikifolder'''''/maintenance/update.php
 # <span lang="en" dir="ltr" class="mw-content-ltr">Most people name their '''''wikifolder''''' simply "w", making this pathname</span> 
 # <span lang="en" dir="ltr" class="mw-content-ltr">something like "htdocs/w/maintenance/update.php"</span>

{{Note|1=<span class="mw-translate-fuzzy"><code>dump</code>を使用した後は、<code>mysqlimport</code>を使用してウィキデータベースを復元しないでください。<code>sql</code>を使用してください。$mysqlimp2はデータを区切られたテキスト形式で読み込む必要があるためです。$csvですが、$dump2の出力は一連のSQL文です。</span> <span lang="en" dir="ltr" class="mw-content-ltr">Because <code>mysqlimport</code> requires the data to be loaded in some delimited text format, eg. CSV, whereas the output of <code>mysqldump</code> is a sequence of SQL statements.</span>}} 

{{Note|1=古い<code>LocalSettings.php</code>を新しいインストールにコピーしない場合は、$prefixを実行する前に、データベースの接頭辞が新しいインストールで以前のインストールに設定されていることを確認してください}}

関連項目 [https://dev.mysql.com/doc/refman/8.0/en/mysql-batch-commands.html テキストファイルからのSQL文の実行]

{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">If your site is slow after importing a database dump, you may need to rebuild indexes.</span> <span lang="en" dir="ltr" class="mw-content-ltr">See [http://stackoverflow.com/questions/3210310/after-importing-sql-files-indexes-in-place-but-not-actually-indexed After importing sql files indexes in place, but not actually indexed]</span>}}

<div lang="en" dir="ltr" class="mw-content-ltr">
==== With the browser for phpMyAdmin ====
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">Open the browser to your phpMyAdmin, login, choose the wiki database. (Check LocalSettings.php if you're not sure).</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Follow the instructions in the [https://docs.phpmyadmin.net/en/latest/faq.html#how-can-i-restore-upload-my-database-or-table-using-a-dump-how-can-i-run-a-sql-file phpMyAdmin documentation].</span>

<span id="From_an_XML_dump"></span>
==== XMLダンプからの復元 ====

''メイン記事: {{ll|Manual:Importing XML dumps}}''

[[Special:MyLanguage/Manual:DumpBackup.php|XML ダンプ]]をウィキに取り込むには、コマンドライン ツール {{ll|Manual:importDump.php|importDump.php}} を使用して以下の操作を行ってください:

 php '''''wikifolder'''''/maintenance/importDump.php --dbpass '''''wikidb_userpassword''''' --quiet '''''--wiki wikidb''''' '''''path-to-dumpfile/dumpfile.xml'''''
 php '''''wikifolder'''''/maintenance/rebuildrecentchanges.php

<div lang="en" dir="ltr" class="mw-content-ltr">
Substitute <code>'''''wikidb_userpassword'''''</code>, <code>'''''wikidb'''''</code> and <code>'''''path-to-dumpfile/dumpfile.xml'''''</code> as appropriate.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Afterwards use {{ll|Manual:ImportImages.php|ImportImages.php}} to import the images:
</div>

 php '''''wikifolder'''''/maintenance/importImages.php '''''wikifolder_backup/images'''''

<span id="Import_the_MediaWiki_files"></span>
== MediaWikiファイルのインポート ==
''See also [[Manual:importImages.php]]''

次に[[Special:MyLanguage/Manual:Backing_up_a_wiki#File_system|MediaWikiファイルシステムのバックアップ]]を復元します。これが復元処理の「主要な」ステップとしては最後になります。

* [[Special:MyLanguage/Manual:Backing_up_a_wiki|バックアップマニュアル]]に書かれた指示にしたがい、ディレクトリ全体をバックアップしていれば、images と extensions のディレクトリがバックアップに含まれているでしょう。また独自に導入した外装や設定もあるかもしれません。 
* imagesやextensionsなどディレクトリの一部分だけをバックアップした場合、まずMediaWikiの新規インストールファイル群をアップロードするかまたはどこかからコピーしてくる必要があります。その後、バックアップしたディレクトリやファイルを新たなファイルシステムの正しい場所に復元します。

<span id="To_wipe_and_restore_the_wiki_file_system"></span>
=====ウィキのファイルシステムを完全に復元するには=====
<span class="mw-translate-fuzzy">ウィキに必要となるimages、logo、extensions. などのサブディレクトリも復元することを忘れないようにしてください。特に<code>LocalSettings.php</code>の内容がすべて正しいことを確認し、必要があれば修正しください。Linux系環境では、以下のようなコマンド操作により既存内容を一旦すべて消去してからウィキのファイルシステムを復元することができます。</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Especially to edit <code>LocalSettings.php</code> to check everything is correct.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">A sequence of Linux commands to wipe and restore the wiki file system could look like this:</span>

 wget <nowiki>http://download.wikimedia.org/mediawiki/</nowiki>{{MW stable branch number}}/mediawiki-{{MW stable release number}}.tar.gz
 tar -xvzf mediawiki-{{MW stable release number}}.tar.gz
 rm mediawiki-{{MW stable release number}}.tar.gz
 rm -fR '''''wikifolder'''''/
 mv mediawiki-{{MW stable release number}} '''''wikifolder'''''
 rm -fR '''''wikifolder'''''/extensions/
 cp -R '''''wikifolder_backup'''''/extensions '''''wikifolder'''''/extensions

<span lang="en" dir="ltr" class="mw-content-ltr">Open the wiki from the browser and click on the ''Set up the wiki first'' link.</span>
詳細は {{ll|Manual:Config script}} を参照してください。
<span lang="en" dir="ltr" class="mw-content-ltr">If needed, you can run the command-line installer <code>php '''''wikifolder'''''/maintenance/install.php</code>.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">After this is done edit <code>LocalSettings.php</code> to suit the fresh install, restoring lines for extensions, etc.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Restore from backup any other files, such as a custom logo and favicon to the correct paths.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you've not installed as a root Linux/Unix user and the images and thumbnails don't work, you'll need to fix the owner or permissions '''recursively''' on the folder that has the uploaded images, usually in '''''wikifolder'''''/images.
</div>

<span id="Notes"></span>
=== 注記 ===
* <span lang="en" dir="ltr" class="mw-content-ltr">If following the latter process, ensure that your "fresh install" consists of the same version of MediaWiki as the old one did</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">Check that the upload directory (e.g. images in version 13) has the correct permissions set if using uploads; it needs to be writable by the web server.</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">Make sure any extension directories have the correct permissions as well (e.g. if linux: <code>chmod -R o=rx extensions</code> or <code>chmod -R o=rx includes</code>)</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">The best method to use when manually transferring a wiki from a windows platform to a Linux platform involves:</span>
*# <span lang="en" dir="ltr" class="mw-content-ltr">Manually installing MediaWiki on the Linux platform from a tar file as outlined here: [[Special:MyLanguage/Manual:Running MediaWiki on Debian GNU/Linux#Get latest MediaWiki|Manual Install of Wiki]] (i.e. try not to use install from a automated package)</span>
*# <span lang="en" dir="ltr" class="mw-content-ltr">Replacing the newly installed MediaWiki folder (e.g. <code>/var/www/mediawiki</code>...) on your Linux machine with the MediaWiki base folder from your windows machine</span>
*# <span lang="en" dir="ltr" class="mw-content-ltr">Updating your Linux machine's MySQL Database (e.g. wikidb) with the wiki database from your windows machine (i.e. use the backup and restore features of mysql as outlined above)</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">After importing a wiki database, even if the database can work, some minor problems may arise:</span>
*# <span lang="en" dir="ltr" class="mw-content-ltr">Searchindex may need to be repaired: In phpMyAdmin, enter <code>REPAIR TABLE ''wikidb''.searchindex;</code> for rebuilding the search index.</span> <span lang="en" dir="ltr" class="mw-content-ltr">''wikidb'' is your database's name.</span>
*# <span lang="en" dir="ltr" class="mw-content-ltr">The collation of some rows may be changed. Cross check it with the original database.</span>

<span id="Check_the_configuration_file"></span>
== 設定ファイルの確認 ==

<div lang="en" dir="ltr" class="mw-content-ltr">
The final task involves verification of, and possibly modifying, the <code>{{ll|Manual:LocalSettings.php|LocalSettings.php}}</code> file.
</div>

* <span lang="en" dir="ltr" class="mw-content-ltr">If you are restoring onto the same server from which you backed up, you probably need not change anything.</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">If you are restoring onto a new server (i.e., if you are moving or duplicating the MediaWiki), certain entries will almost undoubtedly require changing, and you may need to change the database connection information as well.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">Check the following configuration options:</span>

{|class="wikitable"
|-valign=top
! <span lang="en" dir="ltr" class="mw-content-ltr">Configuration option</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">Action required</span>
! 既定値/例
|-valign=top
|'''{{ll|Manual:$IP|$IP}}'''||<span lang="en" dir="ltr" class="mw-content-ltr">Needs to be correct for the paths on the new server</span>

<span lang="en" dir="ltr" class="mw-content-ltr">(Usually remains the same, so change is not required)</span>
| 既定値:
<pre>
 if( defined( 'MW_INSTALL_PATH' ) ) {
 	$IP = MW_INSTALL_PATH;
 } else {
 	$IP = dirname( __FILE__ );
 }
</pre>
|-valign=top
|'''{{ll|Manual:$wgScriptPath|$wgScriptPath}}'''||<span lang="en" dir="ltr" class="mw-content-ltr">Needs to be correct for the path on the new server</span>
|
<code>$wgScriptPath	    = "'''''wikifolder'''''";</code><br/>
例:<br/>
<code>$wgScriptPath	    = "/w";</code>
|-valign=top
|'''{{ll|Manual:$wgArticlePath|$wgArticlePath}}'''||<span lang="en" dir="ltr" class="mw-content-ltr">Needs to be correct for the path on the new server</span>
|
例:<br/>
<code>$wgArticlePath      = "$wgScriptPath/$1";</code><br/>
<code>$wgArticlePath      = "/wiki/$1";</code>
|-valign=top
|'''{{ll|Manual:$wgDBserver|$wgDBserver}}'''||<span lang="en" dir="ltr" class="mw-content-ltr">Check the database server name is correct</span>
|
例:<br/>
<code>$wgDBserver         = "localhost";</code>
|-valign=top
|'''{{ll|Manual:$wgDBname|$wgDBname}}'''||<span lang="en" dir="ltr" class="mw-content-ltr">This might have changed in a shared hosting environment</span>
|
<code>$wgDBname           = "'''''wikidb'''''";</code>
|-valign=top
|'''{{ll|Manual:$wgDBuser|$wgDBuser}}'''||<span lang="en" dir="ltr" class="mw-content-ltr">This might have changed in a shared hosting environment</span>
|
<code>$wgDBuser           = "'''''wikidb_user'''''";</code>
|-valign=top
|'''{{ll|Manual:$wgDBpassword|$wgDBpassword}}'''||<span lang="en" dir="ltr" class="mw-content-ltr">Check this is correct for the new user</span>
|
<code>$wgDBpassword       = "'''''wikidb_userpassword'''''";</code>
|}<!--- LIST OF PLACEHOLDERS USED ON THIS Manual: PAGE
<code>'''''wikifolder'''''</code>
<code>'''''wikidb'''''</code>
<code>'''''wikidb_user'''''</code>
<code>'''''wikidb_userpassword'''''</code> END OF LIST -->
<div lang="en" dir="ltr" class="mw-content-ltr">
You might also need to check the paths to [[w:Diff|diff3]], [[w:ImageMagick|ImageMagick]], etc.
</div>

<span id="Test"></span>
== テスト ==
<span lang="en" dir="ltr" class="mw-content-ltr">At this point, attempt to access the wiki on the new server and use it.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Log in as a sysop and a regular user and check that viewing, creating and editing pages and uploading files still works.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">You will need to fix any problems reported either by PHP or MediaWiki itself.</span>

<span id="Frequent_problems"></span>
=== よくある問題 ===
<span lang="en" dir="ltr" class="mw-content-ltr">After your move you might see PHP warnings stating that certain files could not be accessed.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This is most likely caused by [[phabricator:T37472]]:</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The column md_deps in the [[Special:MyLanguage/Manual:Module_deps_table|module-deps]] table contains absolute file paths, which are used to locate the images and LESS files that CSS depends on.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">These paths will break when the wiki is e.g. moved to another folder or to another server.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
Until this bug is solved, you can use this workaround to manually fix wrong entries in the module_deps table:
</div>

<syntaxhighlight lang="sql">
SET @old='wiki.old-domain.org';
SET @new='wiki.new-domain.org';

UPDATE `module_deps` SET `md_deps` = REPLACE( `md_deps`, @old, @new );
</syntaxhighlight>
<span lang="en" dir="ltr" class="mw-content-ltr">This can be used to update wrong path segments and to fix the error.</span>

<span id="See_also"></span>
== 関連項目 ==
* {{ll|Manual:Backing up a wiki}}
* {{ll|Manual:Moving a wiki}}
* {{ll|Manual:Restoring wiki code from cached HTML}} （バックアップに失敗した場合）
* {{ll|Manual:Upgrading}}
* {{ll|Manual:Installing MediaWiki}}
* スクリプト: [[Fullsiterestore]]
* {{ll|Manual:importImages.php}}

<span id="References"></span>
== 脚注 ==
<references />

[[Category:Import/Export{{#translation:}}|{{PAGENAME}}]]