Zuletzt bearbeitet vor einem Jahr
von Margit Link-Rodrigue

Quiz:Seiten bearbeiten und Setup:Installationsanleitung/Upgrade: Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
hw>Mlink-rodrigue
Keine Bearbeitungszusammenfassung
 
Keine Bearbeitungszusammenfassung
Markierungen: Manuelle Zurücksetzung 2017-Quelltext-Bearbeitung
 
Zeile 1: Zeile 1:
=Seiten bearbeiten=
{{DISPLAYTITLE:Upgrade von BlueSpice 3 auf BlueSpice 4}}


<quiz display="simple">
==Systemanforderungen==
{Es ist möglich eine neue Seite zu erstellen, indem ich den aktuellen Seitennamen in der Adressleiste des Browsers überschreibe.
===Browser===
|type="()"}
{{#dpl:title=Setup:Systemanforderungen|include=#Browser}}
+ richtig
===Serverumgebung===
- falsch
{{#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=}}
{Welches Tastaturkürzel gibt es, um Inhalte aus der Zwischenablage auf einer Wikiseite in Klartextformat einzufügen?
==Backup erstellen==
|type="()"}
Erstellen Sie zuerst einen temporären Migrationsordner und kopieren Sie alle nötigen Daten.<syntaxhighlight lang="bash">
- Strg + v
mkdir /tmp/migration
+ Strg + Umschalt + v
cd /tmp/migration
- Umschalt + p
wikifolder=/path/to/wikifolder
- Strg + p
cp -r $wikifolder/images .
- Hierfür gibt es kein Tastaturkürzel
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 \;


{Was passiert, wenn Sie Ihr Browsertab schließen ohne die Änderungen der Seite zu speichern?
|type="()"}
- Das Wiki speichert Seiten automatisch in einen Zwischenspeicher. Beim nächsten Laden der Seite sind die Änderungen noch vorhanden.
+ Die Änderungen gehen verloren. Zwischenspeicherungen sind nur für "unfreiwillige" Bearbeitungsabbrüchen wie Timeouts oder Seitenfehlern verfügbar.
- Ich kann einen Administrator kontaktieren und die Inhalte wiederherstellen lassen.


{Ich muss in den Bearbeitungsmodus einer Seite wechseln, um eine Seite zu kategorisieren.
</syntaxhighlight>Suchen Sie zusätzlich nach spezialisierten php Dateien in  <code>settings.d</code> (normalerweise <code>090-</code> oder <code>099-</code> ).
|type="()"}
==Upgrade Schritt 1==
- richtig
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=}}
+ falsch
===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=}}


{Welches Element kann über den visuellen Editor auf einer Seite eingefügt werden? (Mehrere Antworten möglich)
<span><span /><span /><br /></span>
|type="[]"}
Rufen Sie die <code>user_id</code>  des Ersatzbenutzers ab, indem Sie  folgenden Befehl in der Datenbank ausführen:
+ Bild
SELECT user_id FROM user WHERE user_name = "DeletedUser";
+ Bildergalerie
==Sql Dump==
- Video
Erstellen Sie Ihr Daten-Backup:<syntaxhighlight lang="bash">
+ Code-Block
mysqldump -u root -p bluespice > migrationdump.sql
+ Vorlage
</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.


{Eine Wikiseite erzeugt automatisch ein Inhaltsverzeichnis, wenn mindestens eine Hauptüberschrift existiert.
Beispiele für Dateien, die Sie möglicherweise berücksichtigen müssen:
|type="()"}
 
+ richtig
* ssl-certs
- falsch
* apache.conf
</quiz>
* ldapprovider.json
__HIDETITLE__
* 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}}]]

Aktuelle Version vom 25. Juli 2023, 12:08 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)
  • Zusätzlich:
    • Apache Tomcat >= 9 oder Jetty >= 9
    • ElasticSearch 6.8 mit Plugin “ingest-attachment”
    • OpenJDK >= 10
    • NodeJS 16
Hinweis: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.

Backup erstellen

Erstellen Sie zuerst einen temporären Migrationsordner und kopieren Sie alle nötigen Daten.

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.

Achtung!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!

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
Hinweis:Eventuell müssen Sie Authentifizierungs-Plugins wie LDAP-Stack, SAML oder OpenIDConnect-Erweiterungen vorübergehend deaktivieren.



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 neuen settings.d/*.php und überprüfen Sie diese auf individuelle (wahrscheinlich veraltete) Konfigurationen. Verfahren Sie ebenso mit 09*-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 );
Keine Kategorien vergebenBearbeiten

Diskussionen