Typo3 Update: Symlinks unter Apple OSX mit dem Terminal neu setzen

Da ich gestern länger gesessen bin um eine Typo3 Installation zu aktualisieren, möchte ich hier gerne mein Wissen weitergeben und zeigen welche Schritte nötig sind und wie Symlinks unter Apple OSX mit dem Terminal geändert werden.

Ich gehe bei dieser kurzen Zusammenfassung von einem Apache Webserver aus. Ich beschreiben in diesem Fall das Update von Typo3 4.0 auf Typo3 4.1.7.  Ich denke aber, dass der Vorgang auch auf andere Updates zutrifft.

Natürlich rät es sich vor einem Update die Datenbank und alle wichtigen Verzeichnisse zu sichern. Ich habe folgende Daten zuvor lokal gesichert und einen SQL dump via phpMyAdmin durchgeführt:

• fileadmin
• typo3conf
• uploads
• typo3_src-4.0/typo3/ext

Auf meinem Server gab es vor dem Update folgende Dateistruktur:

• fileadmin
• typo3_src-4.0 (der Sourcecode)
• typo3conf
• typo3temp
• uploads
• .htaccess
• clear.gif
• index.php (Symlink)
• t3lib (Symlink)
• typo3 (Symlink)
• typo3_src (Symlink)

1. Neuen Sourcecode via FTP hochladen
Ausgetauscht wird eigentlich nur der Typo3 Sourcecode (typo3_src-4.0); alles anderen Dateien bleiben bestehen. Der neue Sourcecode (bei mir typo3_src-4.1.7) wird entpackt und via FTP hochgeladen (das könnte man auch direkt vom Server erledigen lassen). Der neue Ordner "typo3_src-4.1.7" liegt danach bei mir im selben Verzeichnis wie der alte Sourcecode.

2. Symlinks neu setzen
Danach müssen die Symlinks auf das neue Verzeichnis "typo3_src-4.1.7" gerichtet werden. Dazu benötigt man einen SSH Zugang, den Login Namen und das Passwort.

Folgende Kommandos im Terminal erledigen diesen Prozess:

ssh benutzername@ftp.beispiel.at

Nun befindet man sich im obersten Verzeichnis des Webservers. Falls die Verbindung intakt ist, wird man aufgefordert das Passwort einzugeben.

Durch den Aufruf "dir" kann man feststellen welche Ordner und Verzeichnisse hier vorhanden sind. Mit "cd ein_ordner" kann man von hier in ein Unterverzeichnis wechseln. So kann man durch die Ordnerstruktur navigieren und den Platz aufsuchen, an dem sich die oben aufgelisteten Dateien und Ordner  befinden. Danach kann man durch folgende Zeile die Symlinks aktualisieren.

a) Symlink zur index.php

ln -s typo3_src-4.1.7/index.php index.php

b) Symlink zum Sourcecode

ln -s typo3_src-4.1.7 typo3_src

c) Symlink zum Verzeichnis t3lib

ln -s typo3_src/t3lib t3lib

d) Symlink zum Verzeichnis typo3

ln -s typo3_src/typo3 typo3

Wahrscheinlich kann man sich Punkt c und d sparen, da die beiden Links ja sowieso über den Pfad "typo3_src" laufen. 

3. Update Wizard und DB Compare aufrufen
Um das Update abzuschließen, wird dann noch über das Install Tool von Typo3 der Update Wizard aufgerufen und ein Datenbank Compare gemacht. Danach sollte die Installation eigentlich reibungslos laufen.

4. Kleine Fehler beheben
Bei mir kam es nach dem Update zu zwei kleineren Problemen. Einerseits wurde der Seitenbaum nicht mehr ganz richtig dargestellt (es gab lauter Bullet Points) andererseits konnte der RTE nicht mehr geladen werden.

Die Sache mit dem Seitenbau war leicht behoben. Firefox hatte noch die alte CSS Definition im Cache. Es hat gereicht den Cache zu löschen und die Datei "stylesheet.css" neu zu laden.

Nach längerem Suchen ist mir auch klar geworden warum der RTE spinnt: Ich hatte bei der Vorversion meiner Typo3 Installation den RTE 1.4.3 installiert. Diese neue Version wird aber bereits mit dem RTE 1.5.3 ausgeliefert. Ich musste daher den RTE 1.4.3 deinstallieren, den dazugehörigen Ordner im Verzeichnis typo3conf/ext löschen, und alles lief wieder wie geschmiert.