Kurzanleitung: Contao Update von 3.5.x auf 4.5.x bei all-inkl.com mit Contao-Manager

**3dr** · 03.10.2018, 12:44

Durch die von all-inkl.com im KAS bereitgestellten Werkzeuge ist ein Update von von 3.5.x auf 4.5.x ohne Erweiterungen! mit dem Contao-Manager in kurzer Zeit (bei mir <30 Min.) erledigt. Das sind die einzelnen Schritte^1,2:

Ressourcen einrichten: neue Datenbank, neue Subdomain mit PHP-Version min. 7.1, (optional mit SSL-Verschlüsselung)
Datenbank Tabellen der alten Tabelle in die neue Tabelle übertragen im KAS unter Tools > Account-Übertragung > Datenbanken verschieben
ein neues, komplett leeres Rootverzeichnis anlegen
in diesem Verzeichnis einen Ordner /web anlegen und die neue Subdomain in diesen Ordner zeigen lassen
Die aktuelle Datei "contao-manager.phar" unter https://contao.org/de/download.html downloaden, in den Ordner /web legen und erst dann umbenennen in "contao-manager.phar.php"
der Ordner /web darf keine anderen Dateien und/oder Ordner enthalten, das sonst die Installation abbricht
Die Datei contao-manager.phar.php aufrufen, all-inkl als Server auswählen, Cloud-Resolver in einem All-Inkl-Paket "Start" oder "PrivatPlus" aktivieren, im Paket "Premium" bei mir nicht erforderlich (Stand 20.10.2018)
Installation starten
Nach erfolgreicher Installation NICHT direkt die Datenbank über das Install-Tool aktualisieren, sondern:
Die in der neuen Installation erstellten Ordner /files und /templates löschen und statt dessen dort Kopien aus der bestehenden alten Installation über das WEB-FTP oder das Tool > Account-Übertragung > FTP-Daten im KAS erstellen und einfügen lassen (sollte in der 3.5x-Installation noch der Ordner" tl_files" verwendet werden muss dieser vorab durch ein geeignetes Script in "files" geändert werden.)
Jetzt das Installtool aufrufen, die Aktualisierung der Datenbank muss bei mir mehrfach aufgerufen werden, (zuerst ein Aufruf mit allen Checkboxen abgewählt, dann mit ausgewählter Checkbox "Ändern von Tabellen", dann "Anlegen von Tabellen" und dann "Löschen von Tabellen"), anschliessend sollte die Login-Seite ins Backend aufrufbar und das Frontend aufrufbar sein
Nun noch alle benötigten Ordner im Backend von Contao auf "öffentlich" setzen
Im Backend von Contao die Systemwartung und "Daten bereinigen" ausführen lassen
CSS-Dateien anpassen, z.B für Navigationen das Tag "span" durch "strong" ersetzen
Domain der Website in den Ordner /web der neu erstellten Installation zeigen lassen
optional .htaccess anpassen
Nicht mehr benötigte Ressourcen der 3.5er Installation nach Upgrade entfernen (FTP, Datenbank) oder besser: vorerst als backup wegsichern

¹Für ein Upgrade von 3.5.x auf 4.4.x sollten die gleichen Schritte funktionieren (nicht getestet). Ein Upgrade mit Erweiterungen wird weitere Schritte erforderlich machen.
²Für eine Upgrade in einem All-Inkl-Paket "Start" und "PrivatPlus" sind zusätzlich die hier beschriebenen Schritte erforderlich, da in diesen Tarifen das Memory Limit zu niedrig ist. Die dort genannte .htaccess gibt es auch direkt hier.

Sollte diese kleine Liste Fehler enthalten oder Dinge fehlen, vielen Dank für Hinweise.

**p.etrus** · 05.02.2020, 16:09

Servus,

was meinst du: wird das Update von 3.5 auf 4.9 genau nach deiner Vorgehensweise bei all-inkl funktionieren?
Wie ich die subdomain benenne, ich ja eigentlich nicht so wichtig, weil sie ja nur temporär genutzt wird und nach er Installation gelöscht werden kann, oder?

VG, P

**3dr** · 05.02.2020, 16:15

Hi,
davon ausgehend dass du eine Version 3.5.40 meinst sollte das noch genau so entspannt funktionieren mit dem einzigen Unterschied, dass du auf jeden Fall den Cloud-Resolver benötigen wirst.

**RainerG** · 05.02.2020, 21:27

Im Rootverzeichnis darf die alte .htaccess (der 3.5er) nicht stehen, sonst gibt es Probleme mit den Bildern, die von Contao erstellt werden (werden nicht erzeugt). Also umbenennen oder löschen. Das Problem hatte ich bei meiner Contao-Installation (unter all-inkl) nach dem Update von 4.7 auf 4.8. Beim Sprung von 3.5 auf 4.9 dürfte das Problem also auch auftauchen.

**3dr** · 06.02.2020, 08:06

Im Rootverzeichnis darf die alte .htaccess (der 3.5er) nicht stehen

Wenn nach meiner Anleitung vorgegangen wird, wird diese Datei nicht übertragen.

nach dem Update von 4.7 auf 4.8

Für ein solches Update ist die Anleitung nicht geeignet, das kann simpel über den Contao-Manager erledigt werden.

Beim Sprung von 3.5 auf 4.9 dürfte das Problem also auch auftauchen.

Nicht wenn nach meiner Anleitung vorgegangen wird.

**RainerG** · 06.02.2020, 15:40

Zitat von 3dr

Wenn nach meiner Anleitung vorgegangen wird, wird diese Datei nicht übertragen.

Übertragen nicht, aber sie ist ja schon da ;-).

Wenn die Contao4-Installation (/web ...) auf dem gleichen Domainspeicher abgelegt wird wie die 3.5er Installation und die .htaccess der 3.5er im Root bestehen bleibt, dann taucht genau dieses Problem (bei All-inkl) auf, auch wenn die (Sub)Domain nun auf den /web-Ordner zeigt und C4 auch seine eigene .htaccess im web-Ordner hat.
Dieses Problem tauchte auch erst mit dem Update von 4.7 auf 4.8 auf (liegt wohl daran, dass ab Contao 4.8 das Deferred Image Resizing zum Einsatz kommt).

Zitat von 3dr

Für ein solches Update ist die Anleitung nicht geeignet, das kann simpel über den Contao-Manager erledigt werden.

Den Contao Manager hatte ich ja auch ganz "simpel" genutzt und damit tauchte das von mir geschilderte Problem auf. Dahere sollte beim (großen) Sprung von 3.5 auf >= 4.8 das Problem auch auftreten. Bei Updates bis 4.7 taucht das Problem nicht auf, erst wenn 4.8 (und damit Deferred Image Resizing) und höher zum Einsatz kommt.

Zitat von 3dr

Nicht wenn nach meiner Anleitung vorgegangen wird.

Meiner Meinung kann das doch vorkommen, sofern ich C4 in einem Unterverzeichnis der Hauptdomain installiere (auch nach dem Setzen des Stammverzeichnisses, bei mir z. B. --> /webc4/web/). In diesem Fall zeigt dann die Subdomain auf ein Unterverzeichnis der Hauptdomain.

Nur wenn ich völlig unabhängigen Webspeicher (und damit "leeren") nutze, dann sollte es sauber gem. der Anleitung laufen.

Hier der Thread zu dem Thema:
https://community.contao.org/de/show...-assets-images
Entscheidend ist hier die Sichtweise "Sprung auf 4.8.x" und nicht "von 4.7.x auf 4.8.x".

**RainerG** · 06.02.2020, 15:47

Zitat von p.etrus

Servus,

was meinst du: wird das Update von 3.5 auf 4.9 genau nach deiner Vorgehensweise bei all-inkl funktionieren?
Wie ich die subdomain benenne, ich ja eigentlich nicht so wichtig, weil sie ja nur temporär genutzt wird und nach er Installation gelöscht werden kann, oder?

VG, P

Ein Problem könnte noch sein, falls noch das Verzeichnis tl_files zum Tragen kommt (z. B. weil früher von 2.x auf 3.x geupdatet wurde). Jetzt muss es das 'files'-Verzeichnis sein. In dem Fall müssen alle DB-Einträge die tl_files-Pfadangaben enthalten auf files angepasst werden.
Dieses Script sollte helfen: https://gist.github.com/leofeyer/3304014 (aber wohl schon recht alt).

Also prüfe, welche Verzeichnisstruktur in deiner 3.5-Installation genutzt wird (falls die Urinstallation auf C2.x basierte). Kommt '/files/' zum Tragen, dann ist alles sauber.

**3dr** · 06.02.2020, 17:34

Übertragen nicht, aber sie ist ja schon da ;-)

nur wenn man eine neue Installation innerhalb des Rootverzeichnis einer bestehenden Installation durchführt, was man nie tun sollte; eine Neuinstallation sollte natürlich immer in einem völlig leeren Verzeichnis erfolgen. Ein solches Vorgehen konnte ich mir einfach nicht vorstellen, die Anleitung ist jetzt entsprechend angepasst.

Ein Problem könnte noch sein, falls noch das Verzeichnis tl_files zum Tragen kommt

Meine Anleitung gilt für ein Update einer 3.5.x-Installation mit regulärem files-Ordner, auch hierzu habe ich die Anleitung angepasst.

**p.etrus** · 20.02.2020, 20:06

Hi Alle,
ich habs jetzt mal gestartet, stecke aber bei Punkt 11 der Anleitung.
Das Installtool wird nicht gefunden (404), ich habs auch nirgends gesehen, im FTP.
Was kann ich machen?
Im Manager kann ich das Installtool auch nur sperren. Will ich das?

Bitte um eure Hilfe!

LG, p.etrus

***xchs*** · 20.02.2020, 20:08

Wie hast Du das Contao Installtool aufgerufen?

**p.etrus** · 20.02.2020, 20:18

Über den Manager im Menü Tools -> Installtool
geht das auch anders?
--
EDIT:
Hier die adresse, die dadurch aufgerufen wir:
https://contao4.perzgartler.com/contao/install

***xchs*** · 20.02.2020, 20:21

Ja, natürlich. Das Contao Installtool kannst Du - wie in der Vergangenheit auch schon - direkt über https://example.com/contao/install aufrufen.

Aber nachdem das bei Dir über den Contao Manager nicht funktioniert, hast Du wohl ein Problem mit Deinem DocumentRoot, Deiner .htaccess Datei oder mit mod_rewrite.

Kannst Du das Contao Installtool über https://example.com/app.php/contao/install aufrufen? Hast Du den DocumentRoot Deiner Domain korrekt auf den web/ Unterordner gesetzt? Gibt es im web/ Unterordner eine .htaccess?

**p.etrus** · 20.02.2020, 20:27

Kannst Du das Contao Installtool über https://example.com/app.php/contao/install aufrufen?

nein, leider

Hast Du den DocumentRoot Deiner Domain korrekt auf den web/ Unterordner gesetzt?

leider auch nein, probiere das als erstes.
super, danke, das scheint zu funktionieren!
Danke!

Gibt es im web/ Unterordner eine .htaccess?

Ja, immerhin :-)

***xchs*** · 20.02.2020, 20:29

Zitat von p.etrus

leider auch nein, probiere das als erstes.

Ja, den DocumentRoot zu konfigurieren, ist auch normalerweise ganz der erste Schritt.

Das wäre oben in der Anleitung Punkt 4.

**p.etrus** · 20.02.2020, 20:38

Hm, das ist komisch.
Ich habe also /web als Rootverzeichnis gesetzt (eigentlich erst Punkt 15) kann das Installtool aufrufen
dort Datenbanken aktualisieren, aber die weiteren Schritte sind ageblich schon elredigt, inkl. Admin Kontoerstellen etc. Hab ich aber gar noch nicht gemacht...

Punkt 12

Nun noch alle benötigten Ordner im Backend von Contao auf "öffentlich" setzen

zB. habe ich noch gar nicht gemacht, welche Ordner wären das denn?

**p.etrus** · 20.02.2020, 20:39

Zitat von xchs

Ja, den DocumentRoot zu konfigurieren, ist auch normalerweise ganz der erste Schritt.

Das wäre oben in der Anleitung Punkt 4.

Aha, ok, das war wohl mein Fehler: ich hatte den DocumentRoot im von mir angelegten Unterverzeichnis

--
EDIT:
soll ich am besten alles nochmal löschen und neu starten?

**p.etrus** · 21.02.2020, 08:21

Moin,
habe das nochmal neu installiert, die Installation hat wohl gut funktioniert.
Wenn ich aber die Seiten werden nicht angezeigt, 404.
Muss man an der htaccess auf jeden Fall standardmässig etwas ändern beim dem Schritt von 3.5.40 auf 4.9?
Ich kenn mich da leider nicht aus...
Fällt euch nochwas ein, was nicht passen könnte?
Bitte um eure Hilfe!

**Nightwing** · 21.02.2020, 08:25

Zitat von p.etrus

Moin,
Muss man an der htaccess auf jeden Fall standardmässig etwas ändern beim dem Schritt von 3.5.40 auf 4.9?

Würde ich auf jeden Fall tun: nimm erstmal die originale und unveränderte, dann füge hinzu, was auch immer Du benötigst.
Am besten kurz vor dem Ende nach:

Code:

    # If the requested filename exists, simply serve it.
    # We only want to let Apache serve files and not directories.
    RewriteCond %{REQUEST_FILENAME} -f
    RewriteRule ^ - [L]

und vor:

Code:

    # Rewrite all other queries to the front controller.
    RewriteRule ^ %{ENV:BASE}/index.php [L]
</IfModule>

ToM

**3dr** · 21.02.2020, 08:47

Bei einer Neuinstallation wird die jeweils aktuelle .htaccess angelegt, Anpassungen sollten darin zumindest bei all-inkl.com nicht notwendig sein. Laut meiner Anleitung sollte die .htaccess einer vorhandenen älteren Installation nicht übernommen werden.

**Nightwing** · 21.02.2020, 09:12

Jub, da hast schon recht, aber: wir alle haben ja die ein oder andere RewriteRule, non-www vs www-only, ssl dasselbe, usw, deswegen mein Hinweis.

ToM

**3dr** · 21.02.2020, 09:20

Hi ToM, um eine Website bei all-inkl.com via SSL auszuliefern ist bei mir keine Anpassung der .htaccess erforderlich.

**Nightwing** · 21.02.2020, 10:18

Das stimmt, allerdings trifft das auf www / non-www nicht zu, was Dich ja dann dazu führt, der originalen .htaccess was hinzuzufügen. Das meinte ich ja.
Niemals alles einfach so übernehmen, aber nach und nach anpassen.
Daher auch mein Hinweis, an welcher Stelle (hab ich hier von Spooky in den Tiefen des Forums irgendwo gelesen).
Klar, standardmäßig ists ja nicht, aber der Fall kommt, wo man was hinzufügt (oder manch Rule gerne übernehmen möchte), dann macht es schon Sinn zu Wissen, wo genau rein damit.

ToM

PS: Deine Anleitung war sehr hilfreich beim Update von 2.11.xx über 3.5.xx auf damals 4.6.x

**p.etrus** · 21.02.2020, 20:33

Hi,
danke für eure Hilfe, jetzt rennts's!

@3dr: deine Anleitung funktioniert also auch für das Upgrade 3.5.40 auf 4.9.0
Ich habe nur das Documentsroot nicht auf das /web Verzeichnis zeigen lassen, das hatte ich mißverstanden.
Und dass der Admin-Account von der bestehenden contao Installation übernommen wird, hat mich bisserl verwirrt.

Muss noch ein, zwei alte Erweiterungen zum laufen bringen, mal sehen wie ich das schaffe.