Setup:Installationsanleitung/Patch Update: Unterschied zwischen den Versionen

(Die Seite wurde neu angelegt: „Bei großen Versionssprüngen (z.B. BlueSpice 3.2.x auf 4.1.x) ist eine Neuinstallation grundsätzlich empfohlen. Bei einem Patch-Update (z.B. Version 4.1.x a…“)
Markierung: 2017-Quelltext-Bearbeitung
 
Keine Bearbeitungszusammenfassung
 
(15 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
Bei großen Versionssprüngen (z.B. BlueSpice 3.2.x auf 4.1.x) ist eine Neuinstallation grundsätzlich empfohlen.
Diese Seite ist eine Anleitung für ein Patch-Update (z. B. Version 4.2.x auf eine höhere Version 4.2.x+).


Bei einem Patch-Update (z.B. Version 4.1.x auf eine höhere Version 4.1.x) gehen Sie wie folgt vor:
==Sicherung==
Zuerst müssen Sie eine Sicherungskopie Ihrer Datenbank erstellen:<syntaxhighlight lang="bash">
mysqldump -u root -p --all-databases > all_databases.sql


#'''Backup erstellen:''' Ziehen Sie sich hierzu einen Dump der Datenbank und sichern diesen zusammen mit der kompletten Codebase an einen anderen Speicherort weg.
</syntaxhighlight>Um Ihre Codebase sicherer zu machen, speichern Sie sie an einem sicheren Ort Ihrer Wahl:
#'''Codebase erneuern:''' Überschreiben Sie die Codebase der aktuellen Version mit der neuen Codebase der höheren Version.
#Versionsvergleich: Überprüfen Sie nach dem Überschreiben die folgenden Dateien und Ordner. Kopieren Sie dies, falls nötig aus Ihrem Backup:
##Wenn Sie eine angepasste Skin benutzen, überprüfen Sie den Ordner <code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);">skins/</code>.
##<code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);">LocalSettings.php</code>
##<code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);">extensions/BlueSpiceFoundation/config</code>
##<code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);">settings.d/</code> In <code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);">settings.d</code> vor allem  die <code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);">*.local.php</code> <span>Dateien. Kopieren Sie auch diese, falls nötig, aus dem Backup.</span>
#'''Update durchführen:'''
##Öffnen Sie eine Konsole und begeben sich dort in den Installationsordner (auf Ebene der LocalSettings.php)
##Geben Sie dann folgenden Befehl ein: php maintenance/update.php


<br />Sollten Sie Linux als Grundlage Ihrer BlueSpice-Installation einsetzen, beachten Sie, dass beim Überschreiben der Codebase unter Umständen Dateisystemrechte verloren gehen. Mehr Info hierzu finden Sie unter [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte|Dateisystemrechte]].
<syntaxhighlight lang="bash">
#Linux-Bash
cp -r codebase your_secure_place
</syntaxhighlight>


{{Hinweisbox|boxtype=Hinweis|Note text=Im Patch-Update werden normalerweise keine Datenbankschemas geändert. Unter Umständen ist das Durchführen von update.php nicht zwingend nötig.}}
<syntaxhighlight lang="bash">
# Win bash
xcopy codebase your_secure_place\ /E
</syntaxhighlight>


==Codebase erneuern==
Archiv entpacken (neue Wiki-Version). Überschreiben Sie die alte Wiki-Codebasis mit dem Code der neuen Wiki-Version.


<syntaxhighlight lang="bash">
#Linux-Bash
cp -r new_version_codebase old_version_codebase
rm -rf new_version_codebase
</syntaxhighlight>


<br />
<syntaxhighlight lang="bash">
#Win bash
xcopy new_version_codebase old_version_codebase\ /E/H #path/ -  to tell xcopy that path is a directory.
rmdir new_version_codebase /Q/S
</syntaxhighlight>


[[de: {{FULLPAGENAME}}]]
==Lokale Einstellungen und Daten==
[[en:Setup:Installation Guide/Patch Update]]
[[Datei:cutedResult.png|rechts|1025x1025px|verweis=Special:FilePath/cutedResult.png|alternativtext=Screenshot der Baumstruktur von cuted Ergebnis ]]
 
======Lokale Dateien und einige manuell vorgenommene Einstellungen vergleichen======
Die folgenden Dateien und Ordner enthalten lokale Änderungen:
*Einstellungsdateien
**Ordner <code>settings.d/</code><span><span /><span /><span /><span /><span /><span /><span /><span /><br /></span> ODER <span /><span /><span /><span /><span /><span /><span /><span /><span /><br />
**alle Dateien im Ordner <code>settings.d/</code>, die <code>local.php</code> enthalten <span /><span /><span /><span /><span /><br /><span /><span /><span /><span />[[Datei:File localMathPHP.png|verweis=Special:FilePath/File_localMathPHP.png|alternativtext=screenshot Beispiel Ordner 050-Math.local.php]]
*''Bis BlueSpice 4.2.x:''{{Bsvs|bsvTo=4.2.x}} Ordner <code>extension/BlueSpiceFoundation/config/</code>
*Ordner <code>images/</code>
*alle <code>LocalSettings.php</code>-Dateien<span><span /><span /><span /><span /><span /><span /><span /><span /><br /></span> [[Datei:File settingsPHP.png|File settingsPHP.png|verweis=Special:FilePath/File_settingsPHP.png|alternativtext=Screenshot von Beispiel LocalSettings.php Dateien]] <span /><span /><span /><span /><span /><span /><span /><span /><span /><br />
 
======Kopieren Sie von Ihrem Backup lokale Dateien und einige manuell vorgenommene Einstellungen======
Verwenden Sie für eine schnelle Kopie diesen Bash-Befehl:
 
<syntaxhighlight lang="bash">
#Linux-Bash
cd your_secure_place
cp -r images/ LocalSettings.* settings.d/ codebase/
cp -r /extensions/BlueSpiceFoundation/config /codebase/extensions/BlueSpiceFoundation/
</syntaxhighlight>
 
<syntaxhighlight lang="bash">
#Windows bash
cd your_secure_place
für %I in (images/ LocalSettings.* settings.d/) kopiere %I codebase/
für %I in (config/data/) kopiere %I codebase/extensions/BlueSpiceFoundation/
</syntaxhighlight>
 
== Führen Sie das Update aus==
Nachdem alle Vorbereitungen abgeschlossen sind und die Codebase überschrieben wurde, führen Sie die folgenden Schritte aus:
 
#Öffnen Sie eine Konsole und gehen Sie zum Installationsordner ''(''<code>LocalSettings.php</code>-Verzeichnisebene, siehe: rechtes Bild)
#Geben Sie den folgenden Befehl ein:<syntaxhighlight lang="bash">
php maintenance/update.php
</syntaxhighlight>
{{Hinweisbox|boxtype=Hinweis|Note text=Wenn Sie Linux für Ihre BlueSpice-Installation verwenden, beachten Sie bitte, dass die Dateisystemberechtigungen beim Überschreiben der Codebase verloren gehen können!}}
==Überprüfen Sie Ihre aktuelle Version==
Öffnen Sie die Seite <code>Special:Version</code> in Ihrem Wiki und überprüfen Sie die Info unter ''BlueSpice(Credits):''[[Datei:version43 cuted.png|alternativtext=Screenshot Versionsanzeige auf Spezialseite "Version"|zentriert]]
==Wenn Probleme auftreten==
 
*Besuchen Sie unsere [https://sourceforge.net/p/bluespice/support-requests/sourceforge.net sourceforge.net]-Website mit häufig gestellten Fragen oder öffnen Sie ein  [http://sourceforge.net/tracker/?func=add&group_id=358032&atid=1494709 Bug-Ticket].
*Bei allgemeinen Fragen zur Installation, Wartung und Nutzung von BlueSpice Free: besuchen Sie unser [https://sourceforge.net/p/bluespice/discussion/1249668/ SourceForge-Hilfeforum] .
 
<span><br /></span>
[[en:Setup:Installation_Guide/Patch_Update]]
[[de:{{FULLPAGENAME}}]]

Aktuelle Version vom 27. März 2024, 11:59 Uhr

Diese Seite ist eine Anleitung für ein Patch-Update (z. B. Version 4.2.x auf eine höhere Version 4.2.x+).

Sicherung

Zuerst müssen Sie eine Sicherungskopie Ihrer Datenbank erstellen:

mysqldump -u root -p --all-databases > all_databases.sql

Um Ihre Codebase sicherer zu machen, speichern Sie sie an einem sicheren Ort Ihrer Wahl:

#Linux-Bash
cp -r codebase your_secure_place
# Win bash
xcopy codebase your_secure_place\ /E

Codebase erneuern

Archiv entpacken (neue Wiki-Version). Überschreiben Sie die alte Wiki-Codebasis mit dem Code der neuen Wiki-Version.

#Linux-Bash
cp -r new_version_codebase old_version_codebase
rm -rf new_version_codebase
#Win bash
xcopy new_version_codebase old_version_codebase\ /E/H #path/ -  to tell xcopy that path is a directory.
rmdir new_version_codebase /Q/S

Lokale Einstellungen und Daten

Screenshot der Baumstruktur von cuted Ergebnis
Lokale Dateien und einige manuell vorgenommene Einstellungen vergleichen

Die folgenden Dateien und Ordner enthalten lokale Änderungen:

  • Einstellungsdateien
    • Ordner settings.d/
      ODER
    • alle Dateien im Ordner settings.d/, die local.php enthalten
      screenshot Beispiel Ordner 050-Math.local.php
  • Bis BlueSpice 4.2.x:  -v4.2.x Ordner extension/BlueSpiceFoundation/config/
  • Ordner images/
  • alle LocalSettings.php-Dateien
    Screenshot von Beispiel LocalSettings.php Dateien
Kopieren Sie von Ihrem Backup lokale Dateien und einige manuell vorgenommene Einstellungen

Verwenden Sie für eine schnelle Kopie diesen Bash-Befehl:

#Linux-Bash
cd your_secure_place
cp -r images/ LocalSettings.* settings.d/ codebase/
cp -r /extensions/BlueSpiceFoundation/config /codebase/extensions/BlueSpiceFoundation/
#Windows bash
cd your_secure_place
für %I in (images/ LocalSettings.* settings.d/) kopiere %I codebase/
für %I in (config/data/) kopiere %I codebase/extensions/BlueSpiceFoundation/

Führen Sie das Update aus

Nachdem alle Vorbereitungen abgeschlossen sind und die Codebase überschrieben wurde, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie eine Konsole und gehen Sie zum Installationsordner (LocalSettings.php-Verzeichnisebene, siehe: rechtes Bild)
  2. Geben Sie den folgenden Befehl ein:
    php maintenance/update.php
    
Hinweis:Wenn Sie Linux für Ihre BlueSpice-Installation verwenden, beachten Sie bitte, dass die Dateisystemberechtigungen beim Überschreiben der Codebase verloren gehen können!

Überprüfen Sie Ihre aktuelle Version

Öffnen Sie die Seite Special:Version in Ihrem Wiki und überprüfen Sie die Info unter BlueSpice(Credits):

Screenshot Versionsanzeige auf Spezialseite "Version"

Wenn Probleme auftreten




Feedback zur Dokumentation ist im Community-Forum möglich.