Manual:Restoring a wiki from backup/de

Man sollte regelmäßig einBackup seines Wikis durchführen, auch wenn man es niemals wiederherstellen muss: Backups sorgen dafür, dass man ruhig schlafen kann. Wie auch immer, ein Backup ist sinnlos, wenn man es nicht wiederherstellen "kann", und die Übung, ein Backup wiederherzustellen, vermeidet spätere Schwierigkeiten. Daher die folgende Anleitung.

Versions and upgrading
Die Anleitung auf dieser Seite sollte für mehr oder weniger alle bestehenden Versionen von MediaWiki zutreffend sein. Man kann die Database auf einer weiter zurückliegende Version von MediaWiki wiederherstellen, aber sollte sicherstellen, das Update-Skript durchzuführen. Die Wiederherstellung einer Database einer neueren Version in einer älteren Version der Software wird nicht unterstützt.

File transfer
Außer wenn sie direkten Zugriff auf den Server, auf dem das Wiki gehostet ist haben, (und selbst dann) können sie eine Methode auswählen, um die Datenfiles zu übertragen:


 * Secure copy with SCP or WinSCP
 * SSH File Transfer Protocol (SFTP)
 * Using a FTP client.
 * möglicherweise stellt der Host-Service einen Filemanager über einen Web-Browser zur Verfügung; prüfen Sie das mit ihrem Provider.
 * andere Methoden sind unter List of file transfer protocols aufgeslistet

Überblick

 * 1) Wiederherstellung der Database, Benutzer und Berechtigungen
 * 2) Import des Database-Backups
 * 3) Import der MediaWiki-Files
 * 4) Überprüfung der Konfigurationsdatei
 * 5) Test

Wiederherstellung der Database, Benutzer und Berechtigungen
Stellen Sie sicher, dass sie auf dem Server, auf dem sie MediaWiki wiederherstellen, Folgendes haben:


 * 1) eine funktionierende Instanz von MySQL
 * 2) einen MySQL Benutzer mit notwendigen Berechtigungen, wenn Sie nicht MySQL Root benutzen können

Wenn Sie ein Backup aufgrund eines Datenbankfehlers wiederherstellen ziehen sie in Erwägung MySQL neu zu installieren! Wenn MySQL korrekt arbeitet, erzeugen Sie eine neue MySQL Datenbank und gewähren sie ihrem Benutzer-Account die unten aufgelisteten Berechtigungen für die Database. Sie können die MySQL Dokumentation, die Control Panel Dokumentation ihres Host-Providers oder die Dokumentation von den anderen Hilfsprogrammen, die sie benutzen, heranziehen, um Informationen darüber zu erhalten, wie sie dies durchführen können. Unter der Eingabeaufforderung von MySQL können sie als MySQL Root folgendes tun:

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;

Import des Database Backups
Als nächsten Schritt importieren Sie ihr Database Backup. Dies erzeugt die Tabellen in der Database und füllt sie mit Daten. Der Import-Vorgang benötigt unterschiedlich lange, abhängig von der Anzahl der Seiten, Benutzer, Bearbeitungen, etc. in Ihrem Wiki.

Aus der Kommandozeile mit
Wenn eine Database existiert und Sie sie komplett durch das Backup ersetzen wollen. Um die vorhandene Database zu entfernen: mysqladmin -u wikidb_user -p drop wikidb Setzen sie die zutreffenden Werte für  und   ein. Der Parameter  bewirkt die Aufforderung zur Passworteingabe.

Weiter um eine neue Database zu erzeugen: mysqladmin -u wikidb_user -p create wikidb

For example after backing up with mysqldump: mysqldump --default-character-set=binary --user=wikidb_user --password=wikidb_userpassword wikidb > dump_of_wikidb.sql Stellen Sie sicher, dass das korrekte Character Set eingestellt ist, andernfalls könnte die Wiederherstellung fehlschlagen. Prüfen Sie in der, welches Character Set eingestellt ist.
 * 1) Don't do this now: This is how you might have created a backup earlier.
 * 1) The wikidatabase wikidb from which you backed up may have a different name
 * 2) than the wikidatabase wikidb you've created above. Of course wikidb_user and
 * 3) wikidb_userpassword may be different as well.

To import  from the command line you simply do: mysql -u wikidb_user -p wikidb < dump_of_wikidb.sql and afterwards if required do: php wikifolder/maintenance/update.php
 * 1) Most people name their wikifolder simply "w", making this pathname
 * 2) something like "htdocs/w/maintenance/update.php"

See also Executing SQL Statements from a Text File

With the browser for phpMyAdmin
Open the browser to your phpMyAdmin, login, choose the wiki database. (Check LocalSettings.php if you're not sure). Select Structure, localhost, Your_Table. Select CheckAll. From the drop down select Drop, then Ok to wipe the old table. Click on Import, select Browse, pick your SQL file and import it. Press Go.

Remember to also restore file system components of the wiki that might be required, eg. images, logo, and extensions, (see above under mysql).

Depending on timeout settings and the size of the SQL file, it may take multiple attempts to import everything. Failure to complete the import may leave the database in an inconsistent state, e.g. with missing revisions.

From an XML dump
Main article: 

To import an XML dump into a wiki, use the command-line tool. Do: php wikifolder/maintenance/importDump.php --dbpass wikidb_userpassword --quiet --wiki wikidb path-to-dumpfile/dumpfile.xml php wikifolder/maintenance/rebuildrecentchanges.php Substitute,   and   as appropriate.

Afterwards use to import the images: php wikifolder/maintenance/importImages.php wikifolder_backup/images

Import the MediaWiki files
Next, restore your backup of the MediaWiki filesystem: this is the final "large" step in the restore process.


 * If you followed the backup manual instructions, and backed up the entire directory, this will include the images and extensions directories, plus custom skins, etc. and the configuration file.
 * If you backed up only portions of the directory, e.g. images, extensions, etc. then you will need to first upload/copy a fresh install of the MediaWiki files, then transfer the backed-up directories and files into the correct locations in the new filesystem.

To wipe and restore the wiki file system
Remember to also restore the file system components of the wiki that might be required, eg. images, logo, and extensions. Especially to edit  to check everything is correct. A sequence of Linux commands to wipe and restore the wiki file system could look like this: wget http://download.wikimedia.org/mediawiki/ /mediawiki-.tar.gz tar -xvzf mediawiki-.tar.gz rm mediawiki-.tar.gz rm -fR wikifolder/ mv mediawiki- wikifolder rm -fR wikifolder/extensions/ cp -R wikifolder_backup/extensions wikifolder/extensions Open the wiki from the browser and click on the Set up the wiki first link. See Manual:Config script for details. If needed, you can run the command-line installer. After this is done edit  to suit the fresh install, restoring lines for extensions, etc. Restore from backup any other files, such as a custom logo and favicon to the correct paths.

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.

Check the configuration file
The final task involves verification of, and possibly modifying, the  file.


 * If you are restoring onto the same server from which you backed up, you probably need not change anything.
 * 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.

Check the following configuration options:

You might also need to check the paths to diff3, ImageMagick, etc.

Test
At this point, attempt to access the wiki on the new server and use it. Log in as a sysop and a regular user and check that viewing, creating and editing pages and uploading files still works. You will need to fix any problems reported either by PHP or MediaWiki itself.

Frequent problems
After your move you might see PHP warnings stating that certain files could not be accessed. This is most likely caused by T37472: The column md_deps in the module-deps table contains absolute file paths, which are used to locate the images and LESS files that CSS depends on. These paths will break when the wiki is e.g. moved to another folder or to another server.

Until this bug is solved, you can use this workaround to manually fix wrong entries in the module_deps table: This can be used to update wrong path segments and to fix the error.