3.4. Aktualisierungen für Version kleiner 1.0.0

3.4.1. Dateien aktualisieren

Sichern Sie in einem ersten Schritt unbedingt folgende Dateien Ihrer aktuellen Installation:

  • core/conf/sys.inc.php

  • files/

  • files/global_files/

  • files/media/

[Warnung] Warnung

Achten achten Sie darauf, die o.g. Dateien oder/und Ordner auf jeden Fall lokal zu sichern. Die Datei sys.inc.php ist die zentrale Konfigurationsdatei von Welcompose. In dem Unterordner der Verzeichnisses files/ befinden sich ihre binären Dateien.

[Anmerkung] Anmerkung

Sollten Sie weitere Dateien der Installation manuell angepasst oder hinzugefügt haben - beispielsweise ein der Standardinstallation hinzugefügtes Textmakro, Smarty-Plugin oder eine .htaccess Datei für URL-Rewrites - sollten diese selbstredend ebenfalls lokal gesichert werden, bevor Sie das entpackte Archiv des Updates auf den Server laden, da diese Dateien ggf. sonst überschrieben werden.

Nach der Sicherung der oben genannten Dateien und Verzeichnisse, empfiehlt es sich, die komplette Installation vom Server zu löschen. So stellen Sie sicher, dass keine Dateileichen zurückbleiben.

Haben Sie dies erledigt, gilt es, die aktuelle Welcompose-Version zu beschaffen. Laden Sie dazu die aktuelle Welcompose-Version in Quellform aus dem Download-Bereich der Software-Webseite herunter. Sie erkennen die richtige Datei an der Endung des Dateinamens (welcompose-x.x.x-full-src.suffix).

Entpacken Sie die Welcompose-Distribution und laden Sie alle Daten aus dem entpackten Welcompose-Archiv auf den Server.

[Anmerkung] Anmerkung

Den Ordner setup/ aus der entpackten Distribution brauchen Sie für die Aktualisisierung nicht mit auf den Server laden.

Stellen Sie sicher, dass alle Ordner und Dateien über Schreibrechte verfügen, die vom PHP (respektive Welcompose) beschrieben werden können müssen.

Folgende Verzeichnisse müssen für PHP beschreibbar sein:

  • admin/smarty/compiled/

  • smarty/compiled/

  • smarty/cache/

  • files/media/

  • files/global_templates/

  • tmp/

  • tmp/captchas/

  • tmp/flickr_cache/

  • tmp/installer/

  • tmp/log/

  • tmp/mail_attachments/

  • tmp/sitemaps/

  • tmp/updater/

Nachdem alle Dateien auf den Server hochgeladen sind, müssen wir unsere lokal gespeicherte Konfigurationsdatei sys.inc.php mit der gleichnamigen Datei auf dem Server (Im Verzeichnis core/conf) abgleichen.

[Warnung] Warnung

Ersetzen Sie die neu hochgeladene Konfigurationsdatei bitte nicht einfach durch die ältere, lokale Datei. Es ist möglich, dass neue Konfiguration-Parameter hinzugekommen sind oder Bestehende modifiziert sind.

Um die beiden Konfigurations-Dateien zu vergleichen, öffnen Sie bitte beide in einem Text-Editor Ihrer Wahl, kopieren aus der lokalen sys.inc.php Datei die Abschnitte, die mit denen der neu hochgeladenen sys.inc.php Datei identisch sind und ersetzen diese.

[Anmerkung] Anmerkung

Bitte überprüfen Sie genau, ob die Angaben der lokal gespeicherten Datei mit denen der Datei aus dem Aktualisierungspaket übereinstimmen. Durch hinzugekommene Seitentypen können sich bspw. die Angaben im Abschnitt [urls] ändern. Konfigurationsbeispiele für die jeweils aktuelle Version finden Sie im Kapitel 12, Welcompose konfigurieren

Nachdem Sie die auf dem Server liegende Konfigurations-Datei sys.inc.php angepasst und gespeichert haben, laden Sie die zuvor lokal gesicherten Dateien/Ordner wieder auf den Server. Falls die Sie bisher mit einer Standardinstallation gearbeitet haben, betrifft dies den Ordern files/ inklusive seiner Unterordner, in dem Ihre binären Dateien liegen.

3.4.2. Update-Prozedur ausführen

Nun muss die Datenbank aktualisiert werden, was mit Hilfe der automatischen Update-Prozedur geschieht. Rufen Sie dazu mit dem Browser die index.php im Ordner update/ Ihrer Welcompose-Installation auf.

Abbildung 3.1. Update: Lizenz anerkennen

Update: Lizenz anerkennen

Zuerst müssen Sie wieder die Bedingungen der Lizenz anerkennen. Dieser Schritt wird nach dem Setup wiederholt, da sich die Lizenz seit der ersten Installation geändert haben kann.

Nun kommen Sie wieder zur Überprüfung der Voraussetzungen. In diesem Schritt wird vom Update-Assistenten überprüft, ob der Webserver, auf dem Welcompose betrieben wird, die nötigen Voraussetzungen für das Update und einen späteren reibungslosen Betrieb erfüllt. Die Ermittlung der Daten erfolgt anhand hinterlegter Tests auf Versionsnummern und das Vorhandensein bestimmter Funktionen. Tests können entweder Fehlschlagen (rote Warnmeldung neben der getesteten Komponente), eine Warnung verursachen (orange Warnmeldung) oder passieren (grüne Meldung). Sollten Probleme auftauchen, konsulierten Sie bitte Abschnitt 2.4.2, „Voraussetzungen“.

Abbildung 3.2. Update: Voraussetzungen

Update: Voraussetzungen

Nachdem Sie Überprüfung der Voraussetzungen überstanden haben, werden Sie noch einmal daran erinnert, Backups zu erstellen.

Abbildung 3.3. Update: Backups

Update: Backups

Nun kommen Sie zum eigentlichen Update-Prozess, der die Datenbank aktualisiert. Der Update-Prozess besteht aus etlichen einzelnen Aufgaben, sogenannten Tasks, die nacheinander ausgeführt werden. Der Updater ermittelt selber, welche Tasks ausgeführt werden müssen. Sobald Sie auf Update starten klicken, werden die einzelnen Tasks ausgeführt.

Abbildung 3.4. Update: Datenbank aktualisieren

Update: Datenbank aktualisieren

Ein Symbol indiziert jeweils, ob ein ein Task erfolgreich ausgeführt werden konnte oder nicht. Konnte ein Task nicht erfolgreich ausgeführt werden, erscheint eine Fehlermeldung und der Update-Prozess wird abgebrochen. Beheben Sie den Fehler und führen daraufhin den Updater erneut aus. Es werden dann nur diejenigen Tasks ausgeführt, die bisher nicht erfolgreich ausgeführt werden konnten.

Abbildung 3.5. Update: Datenbank erfolgreich aktualisiert

Update: Datenbank erfolgreich aktualisiert

Nachdem die Datenbank erfolgreich aktualisiert wurde, können Sie auf die Schaltfläche Update beenden klicken, um den Aktualisierungs-Prozess zu beenden. Auf der letzten Seite werden Sie noch daran erinnert, das Verzeichnis mit dem Updater vom Server zu löschen. Danach können Sie sich in die Admin-Oberfläche einloggen und mit Ihrer neuen Welcompose-Version arbeiten!

Abbildung 3.6. Update: Aktualisierung erfolgreich beendet

Update: Aktualisierung erfolgreich beendet

[Warnung] Warnung

Vergessen Sie nicht, das Verzeichnis update/ vom Server zu löschen. Sonst kann es unter Umständen zur Manipulation Ihrer Webpräsenz missbraucht werden.

[Anmerkung] Anmerkung

Gegebenenfalls ist es nach dem Aktualisierungsprozeß notwendig, die zuvor kompilierten Smarty-Vorlagen unter /admin/smarty/compiled zu löschen um evtl. neue Ansichten oder/und Menüpunkte anzuzeigen. Bitte denken sie auch daran, den Cache ihres Browsers zu löschen!