Keine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung |
||
Zeile 1: | Zeile 1: | ||
{{DISPLAYTITLE:Upgrade von BlueSpice 3 auf BlueSpice 4}} | |||
==Systemanforderungen== | |||
===Browser=== | |||
{{#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. | |||
'''Hinweis:''' Das Verzeichnis <code>extensions/BlueSpiceFoundation/config</code> existiert nur bis BlueSpice 4.2.x.{{Bsvs|bsvTo=4.2.x}}<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}}]] |
Version vom 25. Juli 2023, 12:49 Uhr
Systemanforderungen
Browser
- Microsoft Edge
- Google Chrome
- Firefox
Serverumgebung
- Betriebssystem:
- Wir empfehlen nachdrücklich Linux (vorzugsweise Debian 11, Ubuntu 22.04, CentOS 7)
- Microsoft Windows Server ab 2016 ist möglich. Einschränkungen bei der Performance auf Windows Server sind hier bekannt und leider nicht auszuschließen.
- Webserver:
- Apache 2.4.x, IIS >= 10 oder nginx 1.x (nginx in WikiFarm nicht möglich)
- PHP:
- PHP 8.1 / PHP 8.2
- Database:
- MySQL: >= 5.6 oder
- MariaDB >= 10.3
- (Virtuelle) Hardware-Anforderungen:
- CPU:
- Linux: 8 Cores (min. 4 Cores)
- Windows: 16 Cores (min. 8 Cores)
- Hauptspeicher:
- Linux: 16 GB (min. 8 GB)
- Windows: min. 16 GB
- Freier Festplattenspeicher:
- > 20 GB (abhängig von der geplanten Datenspeichermenge)
- CPU:
- Zusätzlich:
- Apache Tomcat >= 9 oder Jetty >= 9
- ElasticSearch 6.8 mit Plugin “ingest-attachment”
- OpenJDK >= 10
- NodeJS 16
Backup erstellen
Erstellen Sie zuerst einen temporären Migrationsordner und kopieren Sie alle nötigen Daten.
Hinweis: Das Verzeichnis extensions/BlueSpiceFoundation/config
existiert nur bis BlueSpice 4.2.x. -v4.2.x
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 \;
Suchen Sie zusätzlich nach spezialisierten php Dateien in settings.d
(normalerweise 090-
oder 099-
).
Upgrade Schritt 1
Dieser Schritt muss vor dem Upgrade Schritt 2 durchgeführt werden.
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
Rufen Sie die user_id
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:
mysqldump -u root -p bluespice > migrationdump.sql
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 LocalSettings.php
für wgDB
:
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";
erstellen Sie die Datenbank und DBuser mit DBpassword. Gewähren Sie DBuser in mysql alle Rechte auf der Datenbank.
Migrieren Sie die Daten:
mysql -u root -p bluespice < migration.sql
cp -r images $wikifolder
cp -r extensions $wikifolder
cp -r LocalSettings.php $wikifolder
setWikiPerm $wikifolder
LocalSettings.php modifzieren
Ersetzen Sie:
$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png";
mit:
$wgLogos = [ '1x' => "$wgResourceBasePath/resources/assets/wiki.png" ];
- Überprüfen Sie weitere
LocalSettings.*
Dateien auf Anpassungen aus der alten BlueSpice Installation. - Vergleichen Sie die migrierte
settings.d/*.local.php
mit der neuensettings.d/*.php
und überprüfen Sie diese auf individuelle (wahrscheinlich veraltete) Konfigurationen. Verfahren Sie ebenso mit09*-Customer.php
. - Kopieren Sie nötige Einstellungen zu
$wikifolder/settings.d/
.
Upgrade Schritt 2
Weisen Sie alle Seiten und Dateien ohne gültigen Bearbeitungs-Benutzer Ihrem neu erstellten Ersatzbenutzer zu:
cd $wikifolder
php extensions/BlueSpiceFoundation/maintenance/PrepareActorMigration.php --unknownUserId=<user-id-from-step I. > --unknownUserName=DeletedUser
Optional
- Kopieren Sie die folgenden Dateien (falls in Ihrem Fall zutreffend):
apache.conf
,krb5.conf,
Kerberos-key
,ldapprovider.json
- Fügen Sie dem VirtualHost in
Apache.conf
nach den rewrite Regeln folgendes hinzu:
AllowEncodedSlashes NoDecode
Letzte Schritte
Führen Sie folgende Maintenance-Skripte aus:
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
Der letzte Schritt wird etwas dauern.
Bekannte mögliche Probleme nach dem Upgrade
Probleme mit VisualEditor
Fügen Sie zu includes/libs/http/MultiHttpClient.php
nach Zeile 327 folgende Angaben hinzu:
curl_setopt( $ch, CURLOPT_SSL_VERIFYHOST, 0 ); curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, 0 );
Dateiversionen
Klicke auf einen Zeitpunkt, um diese Version zu laden.
Version vom | Vorschaubild | Maße | Benutzer | Kommentar | |
---|---|---|---|---|---|
aktuell | 10:37, 14. Jan. 2022 | 1.165 × 789 (147 KB) | Margit Link-Rodrigue (Diskussion | Beiträge) |
Du kannst diese Datei nicht überschreiben.
Dateiverwendung
Die folgende Seite verwendet diese Datei: