Installation eines Updates: Unterschied zwischen den Versionen

Aus DynPG-Wiki
Wechseln zu: Navigation, Suche
K
 
(14 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
[[en:Installation of Updates]]
 
 
[[Kategorie:Installation und Update]]
 
[[Kategorie:Installation und Update]]
Entzippen Sie als erstes das entsprechende Update. Achten Sie darauf, dass Sie die
+
[[en:Installation of Updates]]
Updates der Reihenfolge nach vornehmen, sollten allenfalls mehrere gleichzeitig
+
 
notwendig sein.
+
== Übersicht ==
 +
<center>
 +
<gallery perrow="5">
 +
Bild:update01.png|1. Update-Dateien entpacken
 +
Bild:update02.png|2. Dateien hochladen
 +
Bild:update05.png|3. Update-Webseite aufrufen
 +
Bild:update06.png|4. Überprüfen der Voraussetzungen
 +
Bild:update07.png|5. Update Ausführen
 +
Bild:update09.png|6. Zu löschende Dateien bestimmen
 +
Bild:update08.png|7. Dateien löschen
 +
</gallery>
 +
</center>
 +
 
 +
== Vorbereitung ==
 +
 
 +
=== Entpacken ===
 +
Entzippen Sie als erstes das entsprechende Update.
 +
 
 +
{{Caution
 +
|Achten Sie darauf, dass Sie die Updates der Reihenfolge nach vornehmen, sofern Sie mehrere gleichzeitig durchführen. Stellen Sie dabei sicher, das die Versionen der Updates einander entsprechen, d.h. das die neue Versionsummer eines Updates der Ausgangsversion des nächsten Updates entspricht. Die Versionsnummer der aktuell installierten Version von DynPG finden Sie im Backend, wenn Sie in der oberen Leiste auf das [[Image:Btn_info.jpg|25px]] Info-Symbol klicken.}}
 +
 
 +
=== Hochladen ===
 +
* Wechseln Sie zu Ihrem FTP-Programm und stellen die Verbindung zu Ihrem Server her.
 +
* Versichern Sie sich, dass im Verzeichnis Update alle Dateien mit dem Namen "update.* entfernt worden sind, welche ggf. von einem vorgängigen Update noch vorhanden sind.
 +
* Kopieren Sie die Dateien des Updates in den Ordner, in dem sich Ihre DynPG Installation befindet. Dabei wird üblicherweise eine Viehlzahl von Dateien überschrieben, was zum normalen Update-Prozess gehört.
 +
 
  
[[Bild:update01.png]]
+
{{Caution
 +
|Bevor Sie die Update-Dateien hochladen, sollten Sie eine Kopie aller Dateien von DynPG anlegen, die evtl. verändert wurden. Dies können z.B. CSS Style Sheets oder Templates von DynPG sein. Sollten Sie sich nicht sicher sein, ob Dateien im CMS-Ordner verändert wurden, dann können Sie ein auch ein Backup des gesamten CMS-Ordners anlegen und lokal auf Ihrem Computer speichern, um ggf. veränderte Dateien später wieder hochzuladen.}}
  
Kopieren Sie die Dateien in Ihre Website in ein leeres Verzeichnis, oder kopieren Sie
+
=== Rechtevergabe ===
einfach den Hauptordner des entpackten ZIP-Files in Ihre Website hinein. Es ist
+
Wenn Sie alle Dateien hochgeladen haben, navigieren Sie auf dem Server in das Verzeichnis <tt>update/</tt> und geben Sie dort für den Ordner <tt>bin/</tt> die alle Rechte an (Schreib-, Lese- und Ausführungsrechte), sofern Sie dies noch nicht bei der Installation getan haben. Sie können dies z.B. mit den meisten gängigen FTP-Programmen tun.
empfehlenswert, diesen Vorgang nicht im Web-Editor sondern über den Dateibrowser
+
Ihres Systems vorzunehmen.
+
  
Danach wechseln Sie zum FTP-Programm und stellen die Verbindung zum virtuellen
+
[[Image:Ordnerrechte.png|Beispiel: Rechtevergabe im FTP Programm]]
Server her.
+
  
Versichern Sie sich vor dem Hochladen, dass im Verzeichnis Update alle Dateien mit dem
+
== Updatevorgang ==
Namen "update.* entfernt worden sind, welche allenfalls von einem vorgängigen Update
+
Wechseln Sie nun zum Browser und rufen die Seite auf, über die Sie sich normalerweise in das Backend einloggen (z.B. <tt>www.beispiel.de/cms</tt> oder <tt>www.beispiel.de/dynpg</tt>). Dort wird Ihnen der Update-Bildschirm angezeigt. Hier sehen Sie die Änderungen, welche seit der letzten Version vorgenommen wurden und die Lizenzbestimmungen, sowie den aktuellen Stand der Vorbereitungen zum Update-Prozess. Wenn die angezeigten Voraussetzungen alle erfüllt sind, bestätigen Sie die Lizenzbedingungen und starten Sie das Update mit einem Klick auf den entsprechenden Button.
noch vorhanden sind.
+
  
In unserem Beispiel sehen Sie nun das geöffnete FTP-Programm. Wir haben das ganze
+
== Abschließende Schritte ==
Update in das Verzeichnis "tool" gelegt, weil wir auch auf dem Server das gleichnamige
+
Nach dem Update wird Ihnen eine List zu löschender Dateien angezeigt. Aktualisieren Sie bitte dazu erst das Verzeichnis <tt>update/</tt>. Dadurch sehen Sie dann alle vorhandenen Dateien, die Sie dann gemäß der Beschreibung löschen können. Klicken Sie danach auf den Link zur Administration. Sobald Sie die Dateien gelöscht haben, ist das Update abgeschlossen und Sie können sich wieder in das Backend einloggen.
Verzeichnis haben. Nun markieren Sie den Inhalt des Verzeichnisses und schieben diesen
+
Inhalt in der genau gleichen Hierarchie auf Ihren Webserver.
+
  
[[Bild:update02.png]]
+
== Updates auf Versionen ab 4.6 ==
 +
Seit Version 4.6 ist DynPG auf die Zeichenkodierung UTF-8 festgelegt. Dies bietet den Vorteil zu älteren Versionen, dass zum einen mehr Zeichen unterstützt werden und zum anderen, dass
 +
die Kompatibilität zu aktuellen Vesionen von PHP (5.4 und neuer), sowie MySQL verbessert wird.  
  
Wenn Sie alle Dateien hochgeladen haben, gehen Sie auf dem virtuellen Server in das
+
{{Caution
Verzeichnis Update und geben der Datei die erforderlichen Rechte 777.
+
|Sollten Sie DynPG von einer Version älter als oder identisch zu 4.5.3 updaten auf eine Version ab 4.6, dann beachten Sie bitte die nun folgenden Hinweise zur Umstellung der alten DynPG ISO Versionen auf die neueren Versionen mit UTF-8 Unterstützung.}}
  
Rechte vorher:
+
Nachdem Sie das Update auf eine neue UTF-8 Version von DynPG wie oben beschrieben durchgeführt haben, dann ist es notwendig, dass sie einmalig nach dem Update die folgenden drei Schritte ausführen, um Ihre Webseite kompatibel mit der neuen Version von DynPG zu machen.
  
[[Bild:update03.png]]
+
=== Schritt 1: Plugins Updaten ===
  
Rechte danach:
+
Alle vorhandenen Plugins müssen ebenfalls auf neue, UTF-8 kompatible Versionen, geupdated werden. Dies sind alle Versionen mit einem Bereitsstellungsdatum ab dem 21.07.2014. Laden Sie sich dazu die Plugins-Updates herunter und installieren Sie diese wie gewohnt (siehe auch [[Installation von Modulen]]).
  
[[Bild:update04.png]]
+
=== Schritt 2: MySQL Encoding Umstellen ===
  
Nun wechseln Sie zum Browser und rufen das Verzeichnis auf, in welchem sich das
+
In der config.php (siehe [[Einstellungen in der Konfigurationsdatei]]), stellen Sie bitte das MySQL-Encoding auf UTF-8 um. Dazu modifizieren Sie die Parameter <tt>config_force_mysql_encoding</tt>, <tt>config_mysql_encoding</tt>, <tt>config_mysql_collation</tt> wiefolgt:
Backend befindet. In unserem Fall ist dies das Verzeichnis www.domain.ch/tool. Dabei
+
wird uns dieser Bildschirm angezeigt:
+
  
[[Bild:update05.png]]
+
{| class="wikitable"
 +
! <center>'''Bezeichner'''</center>
 +
! <center>'''Wert'''</center>
  
Hier ersehen Sie die Änderungen, welche seit der letzten Version vorgenommen wurden.
+
|-
Gleich darunter finden Sie die Lizenzbestimmungen und der aktuelle Stand des
+
| <tt>config_force_mysql_encoding</tt>
Installationsvorganges.
+
| <code>true</code>
  
[[Bild:update06.png]]
+
|-
 +
| <tt>config_mysql_encoding</tt>
 +
| <code>'utf8'</code>
  
Wenn obige Voraussetzungen erfüllt sind, bestätigen Sie die Lizenzbedingungen und
+
|-
beginnen mit der Installation bzw. schliessen sie schon wieder ab.
+
| <tt>config_mysql_collation</tt>
 +
| <code>'utf8_unicode_ci'</code>
  
[[Bild:update07.png]]
+
|}
  
Bevor Sie die Dateien vom Server löschen, aktualisieren Sie doch bitte erst das
+
=== Schritt 3: Bestehende PHP-Dateien umstellen ===
Verzeichnis. Dadurch sehen Sie dann alle vorhandenen Dateien, welche dann auch
+
gemäss Beschreibung gelöscht werden müssen.
+
  
[[Bild:update08.png]]
+
Zuletzt ist es notwendig, auch bestehende PHP-Dateien, in welche Sie Snippets von DynPG integriert haben, in UTF-8 codiert auszugeben. Dazu ändern Sie zunächst den META-Type der Seite auf UTF-8:
  
Klicken Sie danach auf den Link zur Administration. Wenn Sie obige update-Dateien nicht
+
<code>[html,N]<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"></code>
gelöscht haben, werden Sie nicht über die nächste Maske hinauskommen.
+
  
[[Bild:update09.png]]
+
Anschließend ändern Sie die Kodierung der PHP-Datei in UTF-8, sofern Umlaute direkt darin vorkommen (z.B. mithilfe von Notepad++ [http://notepad-plus-plus.org/]) und weisen DynPG an, die Codierung vor dem Senden an den Browser in UTF-8 festzuschreiben:
  
Sobald Sie die Dateien gelöscht haben ist das Update abgeschlossen und Sie können sich
+
<code>[php,N]
wieder in das Backend einloggen.
+
<?php
 +
    require('./dynpg/getcontent.php');
 +
    $GLOBALS["DynPG"]->init('./dynpg/');
 +
    $GLOBALS["DynPG"]->sendHTTPHeader('utf-8');
 +
?>
 +
</code>
  
== Diese Informationen als PDF ==
+
Beachten Sie, dass dies auf ggf. vorhandene RSS Feeds betrifft, die z.B. nach [[Tutorial - RSS-Feeds]] erstellt wurden.
Dieser Artikel existiert auch als PDF, jedoch möglicherweise nicht so aktuell:[[Media:Install_update.pdf|Install_update.pdf]]
+

Aktuelle Version vom 5. September 2014, 00:07 Uhr


Übersicht

Vorbereitung

Entpacken

Entzippen Sie als erstes das entsprechende Update.

Caution.png Achtung: Achten Sie darauf, dass Sie die Updates der Reihenfolge nach vornehmen, sofern Sie mehrere gleichzeitig durchführen. Stellen Sie dabei sicher, das die Versionen der Updates einander entsprechen, d.h. das die neue Versionsummer eines Updates der Ausgangsversion des nächsten Updates entspricht. Die Versionsnummer der aktuell installierten Version von DynPG finden Sie im Backend, wenn Sie in der oberen Leiste auf das Btn info.jpg Info-Symbol klicken.

Hochladen

  • Wechseln Sie zu Ihrem FTP-Programm und stellen die Verbindung zu Ihrem Server her.
  • Versichern Sie sich, dass im Verzeichnis Update alle Dateien mit dem Namen "update.* entfernt worden sind, welche ggf. von einem vorgängigen Update noch vorhanden sind.
  • Kopieren Sie die Dateien des Updates in den Ordner, in dem sich Ihre DynPG Installation befindet. Dabei wird üblicherweise eine Viehlzahl von Dateien überschrieben, was zum normalen Update-Prozess gehört.


Caution.png Achtung: Bevor Sie die Update-Dateien hochladen, sollten Sie eine Kopie aller Dateien von DynPG anlegen, die evtl. verändert wurden. Dies können z.B. CSS Style Sheets oder Templates von DynPG sein. Sollten Sie sich nicht sicher sein, ob Dateien im CMS-Ordner verändert wurden, dann können Sie ein auch ein Backup des gesamten CMS-Ordners anlegen und lokal auf Ihrem Computer speichern, um ggf. veränderte Dateien später wieder hochzuladen.

Rechtevergabe

Wenn Sie alle Dateien hochgeladen haben, navigieren Sie auf dem Server in das Verzeichnis update/ und geben Sie dort für den Ordner bin/ die alle Rechte an (Schreib-, Lese- und Ausführungsrechte), sofern Sie dies noch nicht bei der Installation getan haben. Sie können dies z.B. mit den meisten gängigen FTP-Programmen tun.

Beispiel: Rechtevergabe im FTP Programm

Updatevorgang

Wechseln Sie nun zum Browser und rufen die Seite auf, über die Sie sich normalerweise in das Backend einloggen (z.B. www.beispiel.de/cms oder www.beispiel.de/dynpg). Dort wird Ihnen der Update-Bildschirm angezeigt. Hier sehen Sie die Änderungen, welche seit der letzten Version vorgenommen wurden und die Lizenzbestimmungen, sowie den aktuellen Stand der Vorbereitungen zum Update-Prozess. Wenn die angezeigten Voraussetzungen alle erfüllt sind, bestätigen Sie die Lizenzbedingungen und starten Sie das Update mit einem Klick auf den entsprechenden Button.

Abschließende Schritte

Nach dem Update wird Ihnen eine List zu löschender Dateien angezeigt. Aktualisieren Sie bitte dazu erst das Verzeichnis update/. Dadurch sehen Sie dann alle vorhandenen Dateien, die Sie dann gemäß der Beschreibung löschen können. Klicken Sie danach auf den Link zur Administration. Sobald Sie die Dateien gelöscht haben, ist das Update abgeschlossen und Sie können sich wieder in das Backend einloggen.

Updates auf Versionen ab 4.6

Seit Version 4.6 ist DynPG auf die Zeichenkodierung UTF-8 festgelegt. Dies bietet den Vorteil zu älteren Versionen, dass zum einen mehr Zeichen unterstützt werden und zum anderen, dass die Kompatibilität zu aktuellen Vesionen von PHP (5.4 und neuer), sowie MySQL verbessert wird.

Caution.png Achtung: Sollten Sie DynPG von einer Version älter als oder identisch zu 4.5.3 updaten auf eine Version ab 4.6, dann beachten Sie bitte die nun folgenden Hinweise zur Umstellung der alten DynPG ISO Versionen auf die neueren Versionen mit UTF-8 Unterstützung.

Nachdem Sie das Update auf eine neue UTF-8 Version von DynPG wie oben beschrieben durchgeführt haben, dann ist es notwendig, dass sie einmalig nach dem Update die folgenden drei Schritte ausführen, um Ihre Webseite kompatibel mit der neuen Version von DynPG zu machen.

Schritt 1: Plugins Updaten

Alle vorhandenen Plugins müssen ebenfalls auf neue, UTF-8 kompatible Versionen, geupdated werden. Dies sind alle Versionen mit einem Bereitsstellungsdatum ab dem 21.07.2014. Laden Sie sich dazu die Plugins-Updates herunter und installieren Sie diese wie gewohnt (siehe auch Installation von Modulen).

Schritt 2: MySQL Encoding Umstellen

In der config.php (siehe Einstellungen in der Konfigurationsdatei), stellen Sie bitte das MySQL-Encoding auf UTF-8 um. Dazu modifizieren Sie die Parameter config_force_mysql_encoding, config_mysql_encoding, config_mysql_collation wiefolgt:

Bezeichner
Wert
config_force_mysql_encoding true
config_mysql_encoding 'utf8'
config_mysql_collation 'utf8_unicode_ci'

Schritt 3: Bestehende PHP-Dateien umstellen

Zuletzt ist es notwendig, auch bestehende PHP-Dateien, in welche Sie Snippets von DynPG integriert haben, in UTF-8 codiert auszugeben. Dazu ändern Sie zunächst den META-Type der Seite auf UTF-8:

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

Anschließend ändern Sie die Kodierung der PHP-Datei in UTF-8, sofern Umlaute direkt darin vorkommen (z.B. mithilfe von Notepad++ [1]) und weisen DynPG an, die Codierung vor dem Senden an den Browser in UTF-8 festzuschreiben:

<?php
    require('./dynpg/getcontent.php');
    $GLOBALS["DynPG"]->init('./dynpg/');
    $GLOBALS["DynPG"]->sendHTTPHeader('utf-8');
?>

Beachten Sie, dass dies auf ggf. vorhandene RSS Feeds betrifft, die z.B. nach Tutorial - RSS-Feeds erstellt wurden.