Dieser Artikel beschreibt die Aktualisierung (Upgrade) einer bestehenden CONTENIDO-Installation . Um CONTENIDO neu zu installieren werfen sie bitte einen Blick in die Installationsanleitung.
...
| title | Wichtig |
|---|
...
4.9
...
. Wenn Sie eine ältere Version (z. B. CONTENIDO 4.8
...
| title | Wichtige Information für eine Aktualisierung von der Version 4.8 |
|---|
Wenn sie eine Aktualisierung von einer Installation der Reihe CONTENIDO 4.8 durchführen, stellen sie bitte sicher, daß es sich dabei um die aktuellste Version dieser Reihe handelt.
Eine Aktualisierung von der Version CONTENIDO 4.8 ist nicht innerhalb weniger Minuten durchgeführt!
In der Version 4.9 stehen viele alte Klassen nicht mehr zur Verfügung und somit kann die Funktionalität ihrer Webseite beeinträchtigt werden. Eine Übersicht der technischen Änderungen finden sie in der Änderungsübersicht.
...
) auf 4.9 aktualisieren möchten, lesen Sie bitte die Anleitung "Aktualisierung von CONTENIDO 4.8 auf 4.9 oder 4.10". Um CONTENIDO neu zu installieren, werfen Sie bitte einen Blick in die Installationsanleitung.
| Note | ||
|---|---|---|
| ||
Sollten sie Sie Probleme mit der Aktualisierung haben, kann ihnen Ihnen die Community im Support-Forum unter forum.contenido.org bei der Beantwortung ihrer Ihrer Fragen helfen. |
Empfehlungen für eine Aktualisierung
Es wird dringend empfohlen, Aktualisierungen von früheren Versionen (besonders der Version 4.8) zunächst lokal oder auf einem Testsystem und nicht auf dem Produktivserver durchzuführen, da, abhängig von der Menge der verwendeten Module und Plugins, viele Korrekturen und Änderungen mit der Aktualisierung einhergehen.
Wenn sie Sie die Aktualisierung auf ihrem Ihrem lokalen System erfolgreich durchgeführt haben, könnne sie Sie die Installation auf ihremIhrem Produktivserver mit der akzualisierten aktualisierten Version von ihrem Ihrem lokalen Sytsem ersetzen.
| Info | ||
|---|---|---|
| ||
Das Aktualisieren auf einem lokalen oder Testsystem hat den riesigen Vorteil, daß ihr dass Ihr Produktivsystem nur für kurze Zeit nicht erreichbar sein wird und sie beleibig Sie beliebig viel Zeit für die Aktualisierung haben. Besonders bei der Aktualisierung einer Version 4.8 ist dies empfehlenswert, da die händischen Anpassungen einige Zeit in Anspruch nehmen können. Allerdings muß muss in diesem Fall sichergestellt werden, daß dass in der Zwischenzeit kein weiterer Content zu der Seite hinzugefügt wird, sobald sie Sie eine Kopie des Systems angefertigt haben. Andernfalls wird dieser beim Zurückspielen der aktualisierten Version überschrieben. Um die Wartungszeit der Webseite Website zu minimieren, können sie Sie ein weiteres Backup der Datenbank und der Dateien an dem Tag, an dem sie Sie die Aktualisierung auf dem Produktivsystem durchführen, anfertigen. Stellen sie Sie sicher, daß sie dass Sie alle Schritte dieser Anleitung durchführen um Fehler zu vermeiden. |
| Info | ||
|---|---|---|
| ||
Ab Version 4.10.0 setzt CONTENIDO nicht mehr Verzeichnis-Rechte 777, sondern nur noch 755 voraus. Ihre Verzeichnisse sollten deshalb die CHMOD-Rechte 755 besitzen. Allerdings funktioniert CONTENIDO weiterhin auch mit CHMOD-Rechten 777, da diese weitergehend sind. Beachten Sie bitte unbedingt, dass Sie nicht nur die Verzeichnis-Rechte korrekt setzen (755), sondern auch die Eigentümer-Rechte (chown) auf Ihrem Webserver berücksichtigen. Diese müssen so gesetzt sein, dass von CONTENIDO angelegte und ggf. über das Backend bearbeitbare Dateien und Ordner ausführbar sind. |
Prüfungen vor einer Aktualisierung
Eine Aktualisierung auf eine andere Version von CONTENIDO kann das Verhalten des Systems beeinflussen. Deshalb müssen Module und Plugins überprüft werden. Prüfen sie Sie zuvor die von den Plugins unterstützten Versionen von CONTENIDO. Besonders bei der Aktualisierung von der Version 4.8 ist es notwendig, daß der Autor des fraglichen Plugins eine Version anbietet die mit der Version 4.9 kompatibel ist. Plugins für die Version 4.8 sind i.d.R. nicht kompatibel zu CONTENIDO 4.9, da sich das Plugin-System geändert hat. Chains sollten allerdings nachwievor funktionieren.Prüfen sie bei der Aktualisierung alle Sprachen aller Mandanten, ob für diese ein Sprach- bzw. Ländercode konfigurert wurde. Die Aktualisierung kann nicht durchgeführt werden wenn diese fehlen. Konfigurieren sie diese Codes in der Sprachverwaltung von CONTENIDO indem sie einen Wert für Land und Sprache angeben
Bewährt hat sich auch ein Vergleich der eingesetzten Dateien des Grundsystems mit der originalen Version von der CONTENIDO-Homepage, damit etwaige Anpassungen am Core-System, die mit dem Update überschrieben würden, zu identifizieren, sichern und nach dem Update wieder zu integrieren. Hierzu ist es ratsam, den Vergleich mittels eines geeigneten Programms, z.B. WinMerge, durchzuführen. Core-Anpassungen sollten nach Möglichkeit vermieden werden und durch Plugins und Chains realisiert werden.
Erstellen von Sicherungskopien des Dateisystems und der Datenbank
Zuallererst Zu aller erst sollte eine Sicherungskopie aller Dateien ihrer Ihrer Website (inklusive der Mandantenordner und deren Upload-Verzeichnisse) erstellt werden. Dasselbe gilt für die ganze Datenbank.
| Warning | ||
|---|---|---|
| ||
Es wird dringend empfohlen, diese Sicherungskopien anzufertigen, um im Falle eines Fehlers bei der Aktualisierung, diese wieder einspielen zu können, so daß ihr System nachwievor sodass Ihr System nach wie vor funktionstüchtig ist. Ansonsten können ihre Ihre Inhalte unwiederbringlich unwiderruflich verloren gehen. |
Herunterladen und Entpacken der aktuellsten Version von CONTENIDO
Laden sie Sie von contenido.org die aktuellste Version von CONTENIDO herunter. Verwenden sie Sie hierbei am Besten keine anderen Quellen! Entpacken die Sie das Archiv an einer beliebigen Stelle auf ihrem Ihrem Computer.
Vorbereiten der Mandantenordner für die Aktualisierung
| Info | ||
|---|---|---|
| ||
Wenn sie Sie die Aktualisierung auf einem Produktivsystem durchführen, sollten sie Sie sicherstellen, daß dass alle Anfragen an eine Wartungsseite weitergeleitet werden, da ab jetzt während der Aktualisierung das Frontend beeinträchtigt ist und Fehler dargestellt würden. |
Löschen sie Sie (sofern vorhanden) in ihren Ihren Mandantenordnern folgende Verzeichnisse und Dateien:
- includes/
- dbfs.php
- error.php
- front_content.php
- front_crcloginform.inc.php
- index.php
Ersetzen früherer Systemdateien
Benennen sie Sie alle Verzeichnisse um, indem sie Sie ihnen den das Suffix "_old" anhängen, mit Ausnahme von "data" bei Installationen die diesen Ordner besitzen.Laden sie dann alle Verzeichnisse ihrer entpackten Verision . Im Ursprung belassen sollten Sie dabei jedoch die Ordner Ihrer Mandanten (im Beispielmandanten "cms" genannt) sowie zunächst den Ordner "data", der sich im Hauptverzeichnis Ihrer CONTENIDO-Installation befindet.
Laden Sie dann alle Verzeichnisse Ihrer entpackten Version von CONTENIDO 4.9 in dieses Verzeichnis hoch.
| Info | ||
|---|---|---|
| ||
Wenn sie Sie mehrere Mandanten haben oder ihr Ihr Mandantenverzeichnis nicht "cms" lautet, müssen Sie in jeden Mandantenordner die Dateien aus dem Ordner "cms" des Downloads kopieren. Achten Sie darauf, keine individuellen Änderungen zu überschreiben. |
"data"-Ordner aktualisieren
Der Data-Ordner ("data") beinhaltet unter anderem diverse Konfigurationsdateien (in der Regel: "data/config/production") und die Übersetzungen ("data/locale"). Bei der Aktualisierung von CONTENIDO müssen Sie auch den "data"-Ordner aus dem Download-Archiv auf Ihren Server kopieren. Bitte achten Sie darauf, keine individuellen Änderungen in Ihren Konfigurationsdateien zu überschreiben. Tipp: Sofern Sie individuelle Anpassungen vorgenommen haben, notieren Sie sich diese vorher und tragen sie bei Ihrer Aktualisierung von CONTENIDO in den neuen Dateien wieder ein.
| Info |
|---|
Wenn Sie mehrere Umgebungen haben oder Ihre Umgebung nicht "production" lautet, müssen Sie in jedem Umgebungsordner unter "data/config" die Dateien in all diesen Mandantenverzeichnissen ersetztenaus dem Ordner "production" des Downloads kopieren. Ansonsten kann es zu einer Fehlfunktion von CONTENIDO kommen. |
Wiederherstellen dritter Plugins
Die im alten CONTENIDO-Ordner befindlichen Plugins von Dritten müssen wieder in den Plugin-Ordner der neuen CONTENIDO-Installation verschoben werden, da ansonsten unerwartete Fehler bei der Ausführung des Upgrade-Prozesses auftreten können.
Ausführen der Aktualisierung
Öffnen sie Sie die Aktualisierungs-Oberfläche, indem sie Sie die URL http://<ihre_domain>/setup/ in ihrem Ihrem Browser aufrufen.Open the upgrade web interface by visitting "setup/" of your installation.
| Info | ||
|---|---|---|
| ||
Nochmal: stellen sie Stellen Sie nochmals sicher, daß sie dass Sie eine Sicherungskopie ihrer Ihrer Datenbank angefertigt haben, da ab nun die Datenbankinhalte verändert werden"! |
Wählen sie Sie den Setup-Typ "upgradeUpgrade" und fahren sie Sie fort.
| Info | ||
|---|---|---|
| ||
Wenn sie Sie gebeten werden die Zugangsdaten für ihre Ihre Datenbank anzugeben, sind dieselben Daten wie bei der Erstinstallation anzugeben. Andernfalls wird die Aktualisierung scheitern. |
Test des Logins im Backend nach der Aktualisierung
Wenn der Aktualisierungs-Prozess erfolgreich abgeschlossen wurde, versuchen sie Sie sich bitte sich im Backend mit dem von ihnen Ihnen gewählten Paßwort Kennwort anzumelden. Bitte löschen sie Sie zuvor die Inhalte ihres Ihres Browser-Caches, um Probleme bei der Darstellung zu vermeiden.
Wenn sie Sie eigene Plugins installiert haben, kann es vorkommen, daß dass im oberen Frame des Backend Backends eine Fehlermeldung ausgegeben wird. Sobald die Plugins auf die Version 4.9 portiert wurden sollte diese Fehlermeldung nicht mehr dargestellt werden.Sollten sie Die Fehlermeldung wird nicht mehr angezeigt, sobald Sie das Plugin deaktiviert/deinstalliert bzw. auf eine aktuelle, zur neuesten CONTENIDO-Installation kompatible Version aktualisiert haben.
Sollten Sie während der Aktualisierung irgendwelche Probleme haben, werfen sie Sie bitte einen Blick in das Support-Forum unter forum.contenido.org. Vielleicht hatte ein anderer Benutzer bereits dasselbe Problem, so daß sie sodass Sie dort eine Lösung finden können.
Verschieben der Konfigurationsdateien
Wenn sie eine Aktualisierung von der Version 4.8 durchführen, müssen sie die Konfigurationsdateien aus dem Mandantenverzeichnis in das Verzeichnis data/config/ des Mandanten verschieben. Vergessen sie dabei nicht auch die Dateien config.local.php und config.after.php zu berücksichtigen.
Sollten sie Änderungen an der Konfiguration des Backend vorgenommen haben, müssen diese nun auch auf die neuen Konfigurationsdateien in data/config/ENVIRONMENT angewendet werden. Wir empfehlen in diesem Fall eine Datei config.local.php zu erzeugen, die ihre Änderungen enthält, so daß keine Dateien des Cores angepaßt werden müssen.
Anpassung von veralteter Funktionalität
Jedesmal, wenn eine Aktualisierung veraltete Funktionen entfernt (so wie dieses bei einer Aktualisierung von der Version 4.8 der Fall ist) , sind die verwendeten Module und Plugins daraufhin zu überprüfen. Wenn sie Sie dies nicht tun, kann sich das Backend und Frontend unerwartet verhalten.
Ob in der Version, zu der sie Aktualisieren Sie aktualisieren, veraltete Funktionen entfernt wurden, können sie Sie in der Änderungshistorie (Changelog) nachlesen. Für eine Aktualisierung von der Version 4.8 lesen sie bitte diesen Artikel (Changes between versions 4. 8 and 4.9). Bitte berücksichtigen sie, daß Plugins in der Version 4.9 eine andere Struktur haben und nicht auf Anhieb funktionieren werden. Bitte kontaktieren sie den Autoren des Plugins um zu erfahren wie sie Bitte kontaktieren Sie bei Problemen mit installierten Plugins deren Autoren, um zu erfahren, wie Sie mit diesem bei einer Aktualisierung vorgehen sollen.
Aufräumen und Beenden der Aktualisierung
Sobald sie Sie eine lokale Kopie der Sicherungskopie des Dateisystems heruntergeladen haben, können sie Sie die Verzeichnisse, denen sie Sie den Suffix "_old" gegeben haben, löschen. Diese Verzeichnisse werden nicht mehr benötigt.
Deaktivieren sie Sie nun den Wartungsmodus (sofern sie Sie diesen aktiviert hatten), ihre Ihre Website sollte nun mit der neuen CONTENIDO-Version laufen.
Ersetzen des Produktivsystems mit dem aktualisierten System
Zu Beginn dieser Anleitung wurde empfohlen, die Aktualisierung zunächste zunächst lokal durchzuführen. Die dort durchgeführten Änderungen müssen nun auf das Produktivsystem übertragen werden. Dazu sind alle Dateien der CONTENIDO-Installation zu kopieren und die Datenbank zu ersetzen.
| Info | ||
|---|---|---|
| ||
Vergessen sie Sie nicht, die Schreibrechte für Dateien nud und Verzeichnisse zu setzen. Sie können diese im Backend im Bereich Systemintegrität überprüfen. |
Wiederherstellen einer alten Installation bei einem Fehler während der Aktualisierung
Um ihre Ihre alte Installation wiederherzustellen , - sollte die Aktualisierung fehlschlagen -, sind alle Verzeichnisse zu löschen, die nicht den Suffix "_old" haben. Anschließend ist dieser Suffix von diesen Verzeichnissen zu entfernen. Schließlich ist die Datenbank mit ihrer Ihrer Sicherungskopie wiederherzustellen.
Womöglich ist es notwendig ihren , Ihren Browser-Cache zu löschen.
Module des Beispielmandanten: Verhalten bei einer CONTENIDO-Aktualisierung
Wurden in einer neuen CONTENIDO-Version Fehler in den Modulen des Beispielmandanten behoben, so werden diese Fehlerbehebungen, aber auch Verbesserungen oder neue Funktionen, bei einer Aktualisierung von CONTENIDO nicht berücksichtigt. Ihr Modul-Ordner im Beispielmandanten verbleibt in seinem bisherigen Stand. Dies hat den Hintergrund, dass ansonsten mögliche individuelle Anpassungen von Ihnen an den Modulen des Beispielmandanten überschrieben werden würden. Wenn Sie auf aktualisierte Module angewiesen sind, so müssten Sie die Module manuell aktualisieren. Sie finden die aktuellsten Modul-Dateien stets im Ordner setup/data/examples/data/modules innerhalb der CONTENIDO-Verzeichnisstruktur. Zur Aktualisierung eines Modules können Sie den gesamten Ordner auf Ihrem Server mit dem äquivalenten Ordner aus dem Setup-Verzeichnis überschreiben - insoweit Ihnen klar ist, dass Sie damit ggf. individuelle Anpassungen überschreiben.
Mail-Server
| Info | ||
|---|---|---|
| ||
Dies gilt ab CONTENIDO-Version 4.10.0 |
CONTENIDO stellt automatisch den Mail-Transport-Typ "SMTP" ein. Damit E-Mails über CONTENIDO versendet werden können, beispielsweise für "Passwort vergessen" oder für das Kontaktformular, müssen Sie im Backend die Zugangsdaten zu einem Mail-Server hinterlegen. Hierzu klicken Sie im Backend bitte auf den Hauptmenüpunkt "System" und dort auf "Konfiguration". Sollten Sie kein SMTP nutzen wollen oder können, gibt es auch die Möglichkeit, den Transport-Typ auf "PHP mail" zu ändern. Damit wird auf die Standard-E-Mail-Funktion von PHP zurückgegriffen. Dies funktioniert allerdings lediglich dann, wenn auf Ihrem Webserver die Mail-Komponente von PHP eingerichtet ist.