Contenido Update/Upgrade Schritt für Schritt (für einen Mandanten)

Eine immer wieder, auch im Forum von Contenido, gestellte Frage ist, wie mache ich ein Update/Upgrade von Contenido? Wie so oft im Internet und bei der Programmierung führen auch hier „viele Wege nach Rom“. Einen dieser Wege, und zwar einen Praxis erprobten, möchte ich hier aufzeigen.

1. Ausgangslage

Nehmen wir mal an wir haben eine funktionierendes Contenido 4.6.15 mit ModRewrite-Erweiterung und Standardmodulen installiert. Dieses ist (noch) nicht gehackt und alle Core-Dateien im Webspace sind noch original.
Wir möchten dieses nun auf eine aktuelle Version von Contenido (z.Z. 4.8.12), unter Verwendung des AMR-Plugins (Advanced ModRewrite Version 0.5.4), upgraden.

2. Vorbereitung

Um ordentlich und in Ruhe arbeiten zu können, sollte es nach Möglichkeit keinerlei Zugriffe auf Seite und DB geben. Bei Liveauftritten von Kunden führe ich daher solche Arbeiten gerne in der Nacht durch, wobei ich hingehe und die Seiten quasi „Offline“ nehme, indem ich eine Wartungsseite vorschalte.

Für den Fall das die Seite auf Wunsch des Kunden nun doch überhaupt nicht offline gehen , bzw. die Ausfallzeit minimiert werden, soll, besteht auch die Möglichkeit das Update über eine Kopie der Datenbank zu machen, wobei Zugriffe an der Live-DB während dieser Zeit verloren gehen. Es kommt also wie fast immer auf die mit dem Kunden gemachten Absprachen an.

Auch sollte man bevor man anfängt vorhandene errorlogs checken, nicht das schon Fehler eingebaut sind. Nach dem Update heißt es sonst oft dies oder jenes habe vorher funktioniert und geht nun nicht mehr.

Wichtig!

Ein vorhandenes ModRewrite sollte, je nach verwendeter Version, deaktiviert bzw. deinstalliert werden. Man sollte sich aber die Form der URL merken, so das man später mit dem AMR-Plugin versuchen kann, diese wieder nachzubilden.

3. Backup

Das Wichtigste machen wir zuerst. Backup… Backup… Backup…

Die Datenbank

Sicherlich kann man einfach einen DB-Dump machen und fertig, ich gehe aber grundsätzlich hin und mache mir zusätzlich ein wenig mehr Arbeit. Bestimmte Einträge in der DB benötigen wir bei unserem Backup bzw. für unser Update nicht, da diese z.B. einen Dump unnötig aufblähen. Dazu gehören die Tabellen con_code oder auch con_mod_history, die es in einer 4.8er Version nicht mehr gibt, da hier die Modulhistory über XML-Dateien gemacht wird. Potentielle Kandidaten sind aber auch die Tabellen con_actionlog (Backendbenutzer Log) oder con_stat_archive (Statistik Archiv).
Nur bitte, keine dieser DB-Tabellen löschen, wenn ihr die Daten nicht mehr benötigt, dann nur Leeren.

Auch sollte man die Datenbank prüfen bzw. optimieren. Funktionen dazu gibt es sowohl für den Kommandozeilen Client als auch bei phpMyAdmin.
Für große Datenbanken kann ich für das Backup MySQLdumper oder BigDump empfehlen, beide benötigen aber zusätzliche Installationen und auch etwas Zeit zur Einarbeitung, wobei BigDump da einfacher, aber auch nur auf Englisch ist.

Der Webspace

Hier reicht es zumeist ersteinmal aus alle Verzeichnisse von Contenido in ein neu zu erstellendes Verzeichnis, z. B. /backup, zu verschieben. Man kann auch zur Sicherheit alles downloaden oder, falls man Zugriff per SSH hat, in ein zip oder gzip Archiv packen.

Um Fragen zuvor zu kommen, nein ich spiele die neuen Dateien nicht einfach über die alte Installation. Dieses kann man sicherlich noch bei einem Update von 1 oder 2 Versionsschritten machen. Bei so einem großen Sprung kann ich es nicht empfehlen. Dateien die in der neuen Version nicht vorhanden sind, bzw. auch nicht mehr benötigt werden, verbleiben von der alten Version und können dann immer noch potentielle Sicherheitslöcher darstellen. Also besser Alles runter und neu hochgeladen.

4. Contenido Update/Upgrade

Ich denke jedem der bis hier gelesen hat ist klar was nun kommt. Nun gut, trotzdem zum Nachvollziehen. Wir laden uns die Sourcen der benötigten Version von contenido.org und entzippen diese entweder, und wenn möglich, direkt auf unserem Webspace, oder machen dies erst lokal und laden dann alles per FTP hoch. Hierbei empfehle ich FileZilla, da dessen Grundeinstellung schon weitestgehend für den Praxiseinsatz optimiert sind.

Sind alle Dateien „oben“ kopieren wir noch aus unserem Backupverzeichnis die Konfigdatei (contenido/includes/config.php) in das entsprechende Verzeichnis unserer Upgradeversion und Starten das Setup durch Aufruf von unsere_domain.tld/setup. Nach Auswahl der Sprache im 1. Schritt, wählen wir im nächsten Schritt „Bestehende Contenido Installation upgraden“. Alle weiteren Schritte sind prinzipiell die selben wie bei einer Neuinstallation, wobei es noch einen wichtigen Punkt zu beachten gibt.

Schreibrechte

Da das Setup bei einem Upgrade zum Einen davon ausgeht, das ja nur die Dateien überschrieben wurden und zum Anderen auch nicht wissen kann, wo der aktive Mandant liegt, bzw. ob es mehrere Mandanten gibt, wird vom Setup auch nicht auf die Schreibrechte geprüft. Setup geht einfach davon aus, das alles korrekt ist. Da wir unseren CMS-Ordner aber neu hochgeladen haben, stimmen dort die Schreibrechte garantiert nicht. Also müssen wir den wichtigsten Verzeichnissen erst die richtigen Rechte geben, bevor wir mit Contenido problemlos arbeiten können. Welche Verzeichnisse das sind kann man in der mitgelieferten README.txt nachlesen.

Kopieren von Dateien

Nachdem das Setup fertig ist und wir die heruntergeladene config.php wieder per FTP hochgeladen haben, rufen wir im nächsten Schritt das Backend auf und testen dort Zugang und Funktionen. Geht dort Alles, können wir zwar das Frontend nun auch schon aufrufen, da aber Bilder und CSS noch fehlen, sieht es meist noch etwas „unschön“ aus.

Also kopieren wir nun im nächsten Schritt alle benötigten Dateien, wie Bilder, CSS , den upload-Ordner, Javascripte und/oder zusätzliche php-Dateien,  aus unserem Backupordner in den CMS-Ordner. Nun sollte unser Frontend wieder funktionieren.

5. Module

Hier scheiden sich die Gemüter. Oft bekomme ich recht aktuelle Installationen von Contenido zu Gesicht, bei denen noch „ältere“ Versionen von Modulen laufen. Gerade bei Navigation oder Sitemap sollte man sich aber überlegen, diese gegen die „Neuen“ der Upgradeversion auszutauschen. Dieses ist Mehrarbeit, die sich in Form von Performancegewinn und zufriedenen Kunden bemerkbar macht.
Durch neuere verwendete Funktionen aus dem Core von Contenido sind die Module der neuen Version schneller und besser abgestimmt.

6. AMR-Plugin installieren

Läuft unsere Installation wieder können wir nun noch das Advanced ModRewrite Plugin installieren und Einrichten. Dieses gibt es immer passend zu der aktuellen Contenidoversion, soll aber hier nicht ausführlicher besprochen werden. Informationen zur aktuellen Version und Installation findet ihr im Contenido Forum.

7. Aufräumen

Zu guter Letzt sollten wir noch unseren „Arbeitsplatz“ aufräumen. Dazu gehört ein Umbenennen oder Löschen des Setup-Verzeichnisses (besser Löschen!) genauso, wie ein nochmaliges Prüfen des Front- und Backends.
Unseren Backupordner sollten wir noch eine Zeit lang im Web liegen lassen, wir können ihn aber zur Sicherheit mit einer htaccess-Datei vor Zugriffen schützen. Spätestens beim nächsten Upgrade gehört er dann aber in den Papierkorb oder ins Archiv.

8. Resumée

Auch wenn wir für dieses Upgrade etwas länger brauchen, als wenn wir nur einfach alles Neue hochladen und ein Setup drüber fahren, finde ich diese Vorgehensweise besser. Alle, nicht mehr benötigten,  „Altlasten“ werden dabei entsorgt und man kann sicher sein, das es nicht weiterhin noch Dateien mit altbekannten Sicherheitslücken gibt.

Ich hoffe, ich konnte euch mit diesem Beitrag zum Upgrade von Contenido helfen. Eine punktuell zusammengefasste Version des Updatevorgangs könnt ihr auch in der Contenido-FAQ finden.
Und wie immer, Fragen und Anregungen sind natürlich willkommen. 😉