==Kompatibilitätscheck==
Vor der Migration ist es wichtig, die Kompatibilität Ihrer derzeitigen MediaWiki-Installation und der gewünschten Version von BlueSpice abzuklären:
*BlueSpice Version 3.x basiert auf MediaWiki 1.31.x
*BlueSpice Version 4.x basiert auf MediaWiki 1.35.x
==Backup==
Erstellen Sie ein vollständiges Backup Ihrer derzeitigen MediaWiki-Installation. Die Befehle können je nach Betriebssystem von den folgenden Angaben abweichen.
#Erstellen Sie ein Verzeichnis, in dem das Backup gespeichert wird:<syntaxhighlight>
mkdir -p /opt/mediawiki-migration-backup/{db,web}
</syntaxhighlight>
#Erstellen Sie eine Dump-Datei der Datenbank:<syntaxhighlight>
mysqldump -u DB_USER_OR_ROOT -p MEDIAWIKI_DATABASE_NAME > /opt/mediawiki-migration-backup/db/database.sql
</syntaxhighlight>
#Kopieren Sie alles aus dem Web-Rootverzeichnis in das Backup-Verzeichnis:<syntaxhighlight>
cp -Rvf /PATH/TO/MEDIAWIKI/FOLDER/* /opt/mediawiki-migration-backup/web/
</syntaxhighlight><br />Wir werden dieses Backup später auch im Migrationsprozess benutzen.
==Vorbereitung der Migration==
Sie können ein separates Benutzerkonto und eine separate Datenbank für BlueSpice erstellen. Dieser Schritt ist optional, aber empfohlen. Die folgenden Schritte basieren auf einem solchen separat erstellten Benutzer und einer separat erstellten Datenbank. Wenn Sie sich dafür entscheiden, keinen separaten Benutzer und keine separate Datenbank zu erstellen, dann ersetzen Sie die folgenden Befehle entsprechend.
#Erstellen Sie einen MySQL/MariaDB Benutzer über MySQL CLI:<syntaxhighlight lang="text">
CREATE USER 'bluespice'@'localhost' IDENFITIED BY 'PleaseChooseAComplexPassword';
</syntaxhighlight>
#Erstellen Sie eine Datenbank für BlueSpice über MySQL CLI:<syntaxhighlight lang="text">
CREATE DATABASE bluespice;
</syntaxhighlight>
#Gewähren Sie die dem bluespice Benutzer die nötigen Berechtigungen für die bluespice Datenbank über MySQL CLI:<syntaxhighlight lang="text">
GRANT ALL PRIVILEGES ON bluespice.* TO 'bluespice'@'localhost';
FLUSH PRIVILEGES;
</syntaxhighlight>Jetzt haben wir eine leere SQL Datenbank und können mit dem Importieren beginnen.
==Daten importieren==
#Importieren Sie den SQL-Dump aus dem vorher erstellten Backup:<syntaxhighlight lang="text">
mysql -u bluespice -p bluespice < /opt/mediawiki-migration-backup/db/database.sql
</syntaxhighlight>Geben Sie nach diesem Befehl das Passwort ein, das Sie für den bluespice Datenbankbenutzer gewählt haben.
#Bereiningen Sie das alte Installationsverzeichnis und erstellen Sie ein neues:<syntaxhighlight lang="text">
rm -Rf /PATH/TO/MEDIAWIKI/FOLDER/
</syntaxhighlight>and<syntaxhighlight lang="text">
mkdir -p /PATH/TO/MEDIAWIKI/FOLDER/
</syntaxhighlight>
#Extrahieren Sie das BlueSpice Installationspaket und legen Sie es in das Verzeichnis /PATH/TO/MEDIAWIKI/FOLDER/ : <syntaxhighlight lang="text">
cd /PATH/TO/MEDIAWIKI/FOLDER/
</syntaxhighlight>
#Kopieren Sie das Verzeichnis ''images'' aus dem alten Backup zum neuen Verzeichnis /PATH/TO/MEDIAWIKI/FOLDER/ :<syntaxhighlight lang="text">
cp -Rf /opt/mediawiki-migration-backup/images
</syntaxhighlight>
#Legen Sie die korrekten Berechtigungen (je nach Betriebssystem) zum Verzeichnis /PATH/TO/MEDIAWIKI/FOLDER/ fest.
==Konfigurationseinstellungen==
#Erstellen Sie im Verzeichnis /PATH/TO/MEDIAWIKI/FOLDER/ eine neue Datei ''LocalSettings.php'' und kopieren Sie folgenden Inhalt in diese Datei:<syntaxhighlight lang="text">
"$wgResourceBasePath/resources/assets/wiki.png" ];
## in the following, UPO means: this setting also exists as a user preference option
$wgEnableEmail = true;
$wgEnableUserEmail = true; # UPO
$wgEmergencyContact = "nomail@localhost.localdomain";
$wgPasswordSender = "nomail@localhost.localdomain";
$wgEnotifUserTalk = false; # UPO
$wgEnotifWatchlist = false; # UPO
$wgEmailAuthentication = true;
## Database settings
$wgDBtype = "mysql";
$wgDBserver = "YOUR_DATABASE_SERVER";
$wgDBname = "bluespice";
$wgDBuser = "bluespice";
$wgDBpassword = "PleaseChooseAComplexPassword";
# MySQL specific settings
$wgDBprefix = "";
# MySQL table options to use during installation or update
$wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
# Shared database table
# This has no effect unless $wgSharedDB is also set.
$wgSharedTables[] = "actor";
## Shared memory settings
$wgMainCacheType = CACHE_NONE;
$wgMemCachedServers = [];
## To enable image uploads, make sure the 'images' directory
## is writable, then set this to true:
$wgEnableUploads = false;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";
# InstantCommons allows wiki to use images from https://commons.wikimedia.org
$wgUseInstantCommons = false;
# Periodically send a pingback to https://www.mediawiki.org/ with basic data
# about this MediaWiki instance. The Wikimedia Foundation shares this data
# with MediaWiki developers to help guide future development efforts.
$wgPingback = false;
## If you use ImageMagick (or any other shell command) on a
## Linux server, this will need to be set to the name of an
## available UTF-8 locale. This should ideally be set to an English
## language locale so that the behaviour of C library functions will
## be consistent with typical installations. Use $wgLanguageCode to
## localise the wiki.
$wgShellLocale = "C.UTF-8";
## Set $wgCacheDirectory to a writable directory on the web server
## to make your wiki go slightly faster. The directory should not
## be publicly accessible from the web.
#$wgCacheDirectory = "$IP/cache";
# Site language code, should be one of the list in ./languages/data/Names.php
$wgLanguageCode = "en";
$wgSecretKey = "68a265061a4101d0d3dee2a06eeb734abaa6710a7dbe103838f2a26a50fc7835";
# Changing this will log out all existing sessions.
$wgAuthenticationTokenVersion = "1";
# Site upgrade key. Must be set to a string (default provided) to turn on the
# web installer while LocalSettings.php is in place
$wgUpgradeKey = "8775d57b99d672b8";
## For attaching licensing metadata to pages, and displaying an
## appropriate copyright notice / icon. GNU Free Documentation
## License and Creative Commons licenses are supported so far.
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright
$wgRightsUrl = "";
$wgRightsText = "";
$wgRightsIcon = "";
# Path to the GNU diff3 utility. Used for conflict resolution.
$wgDiff3 = "/usr/bin/diff3";
## Default skin: you can change the default skin. Use the internal symbolic
## names, ie 'vector', 'monobook':
$wgDefaultSkin = "bluespicediscovery";
# End of automatically generated settings.
# Add more configuration options below.
# This is the main settings file for all BlueSpice extensions and settings
# It will include all files in "$IP/settings.d/" directory
require_once "$IP/LocalSettings.BlueSpice.php";
$wgUserMergeProtectedGroups = array();
$wgUserMergeUnmergeable = array();
$wgMetaNamespace = 'Project';
$bsgGroupRoles['*']['reader'] = false;
# Convenience for debugging
# $wgShowSQLErrors = true;
# $wgDebugDumpSql = true;
# $wgShowExceptionDetails = true;
# $wgShowDBErrorBacktrace = true;
</syntaxhighlight>
#Bearbeiten Sie diese ''LocalSettings.php'' und passen Sie die Werte Ihrer Installation entsprechend an. Diese aktuelle ''LocalSettings.php'' kann sich von Ihrer bisherigen MediaWiki-Installation unterscheiden, da BlueSpice ein separates Verzeichnis für Konfigurationsanpassungen benutzt (''settings.d''). <br />
==Migration des Systems==
#Führen Sie folgendes Skript aus, um die Migration zu starten:<syntaxhighlight lang="text">
php /PATH/TO/MEDIAWIKI/FOLDER/maintenance/update.php --quick
</syntaxhighlight>BlueSpice sollte nun erreichbar sein.
#Führen Sie zum Abschluss noch folgende Skripte aus:<syntaxhighlight lang="text">
php /PATH/TO/MEDIAWIKI/FOLDER/maintenance/rebuildall.php
#Schließlich für den Suchindex (Elasticsearch 6.x und ingest-attachment Plugins müssen installiert sein) php /PATH/TO/MEDIAWIKI/FOLDER/extensions/BlueSpiceExtendedSearch/maintenance/initBackends.php --quick
php /PATH/TO/MEDIAWIKI/FOLDER/extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php --quick
php /PATH/TO/MEDIAWIKI/FOLDER/maintenance/runJobs.php --memory-limit=max
</syntaxhighlight><br />
Die Migration ist komplett und BlueSpice ist nun einsatzbereit!
Sie können Ihre alten Anmeldedaten zum Login benutzen.
'''Fragen?''' Besuchen Sie unser [https://sourceforge.net/p/bluespice/discussion/1249668 BlueSpice Hilfeforum] auf sourceforge.net.
<br />
[[de:{{FULLPAGENAME}}]]
[[en:Setup:Installation_Guide/Migration_from_MediaWiki_to_BlueSpice]]
