|
|
Zeile 1: |
Zeile 1: |
| {{DISPLAYTITLE:Upgrade von BlueSpice 3 auf BlueSpice 4}} | | {{DISPLAYTITLE:Reiter (Tabs) im Seiteninhalt}} |
| | | {{BSVersion|bsvFrom=4.4|bsvFeature=TabberNeue}} |
| ==Systemanforderungen==
| | ==Einfache Tabs== |
| ===Browser===
| | Wenn Sie Seiteninhalte in Reitern organisieren möchten, können Sie hierfür eine spezielle Syntax in der Quelltextbearbeitung verwenden.{{Textbox|boxtype=important|header=|text=Die Inhalte der Reiter können nicht im visuellen Bearbeitungsmodus eingefügt werden. Es ist jedoch möglich, [[#Transklusion|Wiki-Seiten als Inhalt der Tabs anzuzeigen (zu transkludieren)]].|icon=no}} |
| {{#dpl:title=Setup:Systemanforderungen|include=#Browser}} | |
| ===Serverumgebung===
| |
| {{#dpl:title=Setup:Systemanforderungen|include=#Serverumgebung}}
| |
| {{Hinweisbox|boxtype=Hinweis|icon=|Note text=Möglicherweise müssen Sie externe Repos hinzufügen, um die richtige PHP auf Ihrem Server zu erhalten! Bitte überprüfen Sie ihren Paketmanager auf die verfügbaren PHP-Versionen auf Ihrem System.|bgcolor=}}
| |
| ==Backup erstellen== | |
| Erstellen Sie zuerst einen temporären Migrationsordner und kopieren Sie alle nötigen Daten.<syntaxhighlight lang="bash">
| |
| mkdir /tmp/migration
| |
| cd /tmp/migration
| |
| wikifolder=/path/to/wikifolder
| |
| cp -r $wikifolder/images .
| |
| cp -r $wikifolder/extensions/BlueSpiceFoundation/config .
| |
| cp -r $wikifolder/LocalSettings.* .
| |
| #check for for locals in settings.d
| |
| find $wikifolder/settings.d/ -iname '*.local.php' -exec cp --parent {} /tmp/migration \;
| |
| | |
| | |
| </syntaxhighlight>Suchen Sie zusätzlich nach spezialisierten php Dateien in <code>settings.d</code> (normalerweise <code>090-</code> oder <code>099-</code> ).
| |
| ==Upgrade Schritt 1==
| |
| Dieser Schritt muss vor dem Upgrade Schritt 2 durchgeführt werden.{{Hinweisbox|boxtype=warning|icon=|Note text=BlueSpice 4.x kann Wikiseiten und Dateien, die von '''gelöschten Benutzern''' erstellt wurden, nicht verarbeiten. Um Datenverlust zu vermeiden, führen Sie alle Upgrade-Schritte durch!|bgcolor=}}
| |
| ===Erstellen eines "Ersatzbenutzers" for gelöschte Benutzer===
| |
| Erstellen Sie in BlueSpice 3.x einen Ersatzbenutzer mit irgendeinem Passwort:
| |
| php maintenance/createAndPromote.php --force DeletedUser someR4ndomPass
| |
| {{Hinweisbox|boxtype=note|icon=|Note text=Eventuell müssen Sie Authentifizierungs-Plugins wie LDAP-Stack, SAML oder OpenIDConnect-Erweiterungen vorübergehend deaktivieren.|bgcolor=}}
| |
| | |
| <span><span /><span /><br /></span>
| |
| Rufen Sie die <code>user_id</code> des Ersatzbenutzers ab, indem Sie folgenden Befehl in der Datenbank ausführen:
| |
| SELECT user_id FROM user WHERE user_name = "DeletedUser";
| |
| ==Sql Dump==
| |
| Erstellen Sie Ihr Daten-Backup:<syntaxhighlight lang="bash">
| |
| mysqldump -u root -p bluespice > migrationdump.sql
| |
| </syntaxhighlight>
| |
| ==Optionale Migrationsdateien==
| |
| Wenn eine der folgenden Funktionen auf Ihre Installation zutrifft, prüfen Sie, ob Migrationsschritte erforderlich sind. Fügen Sie in diesem Fall alles zu Ihrer ''tar''-Datei hinzu und senden Sie diese an den neuen Server.
| |
| | |
| Beispiele für Dateien, die Sie möglicherweise berücksichtigen müssen:
| |
| | |
| * ssl-certs
| |
| * apache.conf
| |
| * ldapprovider.json
| |
| * kerberos files (krb5.conf/keyfile)
| |
| | |
| ==Migration in das neue Wiki==
| |
| ''Grep'' <code>LocalSettings.php</code> für <code>wgDB</code> :<syntaxhighlight lang="bash">
| |
| grep wgDB LocalSettings.*
| |
| LocalSettings.local.php:$wgDBserver = "Your-IP";
| |
| LocalSettings.local.php:$wgDBname = "Your-datbase-name";
| |
| LocalSettings.local.php:$wgDBuser = "Your-database-user";
| |
| LocalSettings.local.php:$wgDBpassword = "Your-password";
| |
| </syntaxhighlight>
| |
| | |
| <span><span /><span /><br /></span>
| |
| erstellen Sie die '''Datenbank''' und '''DBuser''' mit '''DBpassword'''. Gewähren Sie '''DBuser''' in ''mysql'' alle Rechte auf der Datenbank.
| |
| | |
| Migrieren Sie die Daten:<syntaxhighlight lang="bash">
| |
| mysql -u root -p bluespice < migration.sql
| |
| cp -r images $wikifolder
| |
| cp -r extensions $wikifolder
| |
| cp -r LocalSettings.php $wikifolder
| |
| setWikiPerm $wikifolder
| |
| | |
| </syntaxhighlight>
| |
| ====LocalSettings.php modifzieren====
| |
| Ersetzen Sie:<syntaxhighlight lang="php">
| |
| $wgLogo = "$wgResourceBasePath/resources/assets/wiki.png";
| |
| </syntaxhighlight>mit:<syntaxhighlight lang="php">
| |
| $wgLogos = [ '1x' => "$wgResourceBasePath/resources/assets/wiki.png" ];
| |
| | |
| </syntaxhighlight>
| |
| *Überprüfen Sie weitere <code>LocalSettings.*</code> Dateien auf Anpassungen aus der alten BlueSpice Installation.
| |
| *Vergleichen Sie die migrierte <code>settings.d/*.local.php</code> mit der neuen <code>settings.d/*.php</code> und überprüfen Sie diese auf individuelle (wahrscheinlich veraltete) Konfigurationen. Verfahren Sie ebenso mit <code>09*-Customer.php</code>.
| |
| *Kopieren Sie nötige Einstellungen zu <code>$wikifolder/settings.d/</code> .
| |
| ==Upgrade Schritt 2==
| |
| Weisen Sie alle Seiten und Dateien ohne gültigen Bearbeitungs-Benutzer Ihrem neu erstellten Ersatzbenutzer zu:<syntaxhighlight lang="bash">
| |
| cd $wikifolder
| |
| php extensions/BlueSpiceFoundation/maintenance/PrepareActorMigration.php --unknownUserId=<user-id-from-step I. > --unknownUserName=DeletedUser
| |
| </syntaxhighlight>
| |
| ==Optional==
| |
| *Kopieren Sie die folgenden Dateien (falls in Ihrem Fall zutreffend): <code>apache.conf</code>, <code>krb5.conf,</code> <code>Kerberos-key</code>, <code>ldapprovider.json</code>
| |
| *Fügen Sie dem VirtualHost in <code>Apache.conf</code> nach den rewrite Regeln folgendes hinzu:
| |
| AllowEncodedSlashes NoDecode
| |
| ==Letzte Schritte==
| |
| Führen Sie folgende Maintenance-Skripte aus:<syntaxhighlight lang="bash">
| |
| cd $wikifolder
| |
| php maintenance/update.php --quick
| |
| php extensions/BlueSpiceExtendedSearch/maintenance/initBackends.php --quick
| |
| php extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php --quick
| |
| | |
| screen
| |
| while [ "$(php maintenance/showJobs.php)" != "0" ]; do php maintenance/runJobs.php --maxjobs 100; done
| |
| | |
| </syntaxhighlight>Der letzte Schritt wird etwas dauern.
| |
| ==Bekannte mögliche Probleme nach dem Upgrade==
| |
| ===Probleme mit VisualEditor===
| |
| <div>
| |
| Fügen Sie zu <span style="color: rgb(4, 30, 73)"><code>includes/libs/http/MultiHttpClient.php</code> nach Zeile 327 folgende Angaben hinzu:</span>
| |
| <span class="nb" style="color: rgb(0, 128, 0)">curl_setopt</span><span class="p">(</span> <span class="nv" style="color: rgb(25, 23, 124)">$ch</span><span class="p">,</span> <span class="nx">CURLOPT_SSL_VERIFYHOST</span><span class="p">,</span> <span class="mi" style="color: rgb(102, 102, 102)">0</span> <span class="p">);</span>
| |
| <span class="nb" style="color: rgb(0, 128, 0)">curl_setopt</span><span class="p">(</span> <span class="nv" style="color: rgb(25, 23, 124)">$ch</span><span class="p">,</span> <span class="nx">CURLOPT_SSL_VERIFYPEER</span><span class="p">,</span> <span class="mi" style="color: rgb(102, 102, 102)">0</span> <span class="p">);</span>
| |
| </div>
| |
| | |
| [[en:Setup:Installation_Guide/Upgrade]]
| |
| [[de:{{FULLPAGENAME}}]]
| |