Typo3 unter Debian Lenny mit PostgreSQL

HTS-Software SS 2009 Technische Dokumentationen/Schulungen Wagnerstr. 4a 83043 Bad Aibling Typo3 4.2.12 Typo3 unter Debian Lenny mit PostgreSQL Alexander Schucha 27. November 2009

1 Rechtliche Hinweise Bei der Erstellung von Texten und Abbildungen wurde mit gröÿter Sorgfalt gearbeitet. Trotzdem können Fehler nicht vollständig ausgeschlossen werden. Der oder die Autoren können jedoch für fehlerhafte Angaben und deren Folgen weder eine juristische Verantwortung noch irgendeine Haftung übernehmen. Für Verbesserungsvorschläge und Hinweise auf Fehler sind der Autor oder die Autoren dankbar. In diesem Dokument werden Warennamen ohne der Gewährleistung der freien Verwendbarkeit und ohne besondere Kennzeichnung benutzt. Es ist jedoch davon auszugehen, dass viele der Warennamen gleichzeitig eingetragene Warenzeichen oder als solche zu betrachten sind. 2

2.1 Aktuelle Typo3 Version besorgen Die Typo3 Projekt Website www.typo3.org bietet einen Menu Punkt Download von dort können Sie sich die aktuelle Version herunterladen. Wählen Sie die Pakete die auf.tar.gz enden die sind für Linux gedacht. Benötigt werden das Dummy und das Source Paket. Leider hat beim Typo3 Projekt keiner an Serverbetreiber gedacht deren Server keine grasche Oberäche haben und die gleich direkt auf den Server Downloaden wollen. Hier müssen Sie etwas Improvisieren und den Link erstmal mit einem Browser feststellen. Dann ist aber der Download mit wget zum Beispiel Problemlos möglich. So ging es bei der Typo3 Version 4.2.12: Dummy-Paket: wget http://downloads.sourceforge.net/project/typo3/ TYPO3%20Source%20and%20Dummy/TYPO3%204.2.12/dummy-4.2.12.tar.gz Source-Paket: wget http://downloads.sourceforge.net/project/typo3/ TYPO3%20Source%20and%20Dummy/TYPO3%204.2.12/typo3_src-4.2.12.tar.gz 2.2 Entpacken Im Doccumentroot des Apache entpacken Sie bitte die zwei zuvor heruntergeladenen Tar-Archive. Es ist möglich für mehrere Typo3 installationen nur einmal das Sourcecode Paket zu installieren. Ich habe das hier nicht so gemacht. Da oft aus verschiedenen gründen Kundenwünsche die Änderung in den Sourcen erforderlich machen. Wenn sie erst eine Testinstallation machen wollen können sie Typo3 auch in ein Unterverzeichnis im Documentroot installieren. Entpackt werden die beiden Pakete in das gleich Verzeichnis mit den folgenden Befehlen: tar xvfz dummy-4.2.12.tar.gz tar xvfz typo3_src-4.2.12.tar.gz Lassen Sie die Tar-Archive nicht im Webserververzeichnis stehen. Verschieben sie diese z.b. in das Home-Verzeichnis. Löschen würde ich die Tar-Archive noch nicht meist braucht man sie noch für Neu- oder weitere Installationen. 3

Nach dem entpacken benden sich die Verzeichnisse dummy-4.2.12 und typo3_src- 4.2.12 im Verzeichnis des Apache. Der Inhalt des dummy-4.2.12 muÿ im DocumentRoot des Apache stehen. Das läÿt sich durch verschieben der Dateien leicht machen. Das dann leere Verzeichnis dummy-4.2.12 kann einfach gelöscht werden. Ich gebe im folgenden die Pfad immer so an als wäre das Documentroot des Apache Servers das aktuelle Verzeichnis. Benden sie sich in einem anderen Verzeichnis mussen sie entweder mit dem cd Befehl in das Documentroot wechseln oder die Pfadangaben in den von mir angegebenen Befehlen anpassen. mv dummy-4.2.12/*. rm -r dummy-4.2.12 Da meine Art der Installation nicht ganz mit den Vorstellungen der Paket Macher übereinstimmt muÿ hier noch der Symolischelink typo3_src angepasst werden. rm typo3_src ln -s typo3_src-4.2.12 typo3_src 2.3 Nötige Patches Die Typo3 Version 4.2.12 benötigt für die zusammenarbeit mit PostgreSQL noch den Patch 8231_v2 dieser ist seltsamerweise trotz des Umstandes das er schon länger bekannt ist bisher nicht in die stabile Version von Typo3 integriert worden. Download des Patches: Installation des Patches: patch -p0 < bug_8231_v2.diff 2.4 Dateirechte setzen Wichtig für die Sicherheit Ihres Webservers ist es das auf Dateien nur der zugreifen kann der das auch muÿ. Die beliebte Praxis einfach allen die Lese- und Schreibrechte zu erteilen ist weder bei internen noch bei externen Server angebracht. Im Dokumentroot des Apache können sie mit folgenden Befehlen die richtigen Dateirechte setzen. Bitte ersetzen sie in den Befehlen den User alex durch einen eigenen Usernamen. Root sollten sie nicht dafür benutzen. Damit sie die Gruppenrechte auf die vom Apache benutzte Gruppe setzen können ist eine Anmeldung als User root nötig. su chown -R alex:www-data * chmod -R 750 * chmod -R 770 typo3/ext typo3temp uploads fileadmin typo3conf # Bei Dateien müssen die Ausführungsrechte wieder entfernt werden. # PHP-Scripte benötigen keine Ausführungsrechte. find. -type f -print0 xargs -0 chmod 660 4

Abbildung 2.1: Berechnung der numerischen Dateirechte für den chmod Befehl. 2.5 Anlegen einer PostgreSQL Datenbank für Typo3 Das anlegen einer Typo3 Datenbank ist im Typo3 Installtool leider nicht möglich. Scheinbar waren die DBAL Entwickler nicht der Meinung das das eine wichtige Funktion ist. Also benutzen wir dazu die PostgreSQL Kommandos. Wie sie die Datenbank benennen ist unwichtig. Wenn man aber den überblick behalten will ist ein sprechender Name sicher sinnvoll. Ich benenne meine für Typo3 benutzten Datenbanken immer mit Programmname und Domain. Das sieht dann etwa so aus: typo3-4.2_hts-software.de. # Die Komandozeilen Befehle zum anlegen der Datenbank. createdb typo3-4.2_hts-software.de createuser -P -e <DB-Username> Wenn Sie es bevorzugen eine Datenbank mit SQL-Befehlen zu erzeugen müssen Sie einen so gestallteten DB-Namen in Anführungszeichen einschlieÿen. # SQL-Befehle zum anlegen der Datenbank. create database "typo3-4.2_hts-software.de"; 2.6 Typo3 auf PostgreSQL vorbereiten Damit Typo3 klar wird das sie nicht MySql sondern PostgreSQL verwenden wollen sind in der Kongurationsdatei von Typo3 ein paar Einstellungen zu machen. Diese Datei nden sie im Verzeichnis typo3conf und der Name der Datei lautet localconf.php. Ich verwende den vim um auf der Konsole Dateien zu ändern (z.b. vi typo3conf/localconf.php). 5

// Meine C onfiguration f u e r den Postgres Einsatz. $TYPO3_CONF_VARS[ 'EXTCONF' ] [ ' dbal ' ] [ ' handlercfg ' ] = array ( '_DEFAULT' => array ( ' type ' => ' adodb ', ' enabled ' => TRUE, ' p r i n t E r r o r s ' => TRUE, ' c o n f i g ' => array ( ' d r i v e r ' => ' postgres ' ) ) ) ; // Bei der Typo3 Version 4. 2. 1 2 i s t es n i c h t moeglich d i e // ' Basic Configuration ' a u f z u r u f e n wenn noch keine // g u e l t i g e n Eintragungen f u e r den Datenbank Connect // vorhanden sind. Deshalb tragen wir es h i e r manuell ein. $typo_db_username = ' UserName ' ; $typo_db_passwort = ' Passwort ' ; $typo_db_host = ' l o c a l h o s t ' ; $typo_db = ' typo3 4.2 hts software. de ' ; // Die L i s t e welche Extensions geladen werden s o l l e n i s t // b e r e i t s in der l o c a l c o n f. php vorhanden b i t t e e r w e i t e r n // s i e d i e s e nur um d i e beiden unten. Einfach mit Komma // hinten anhaengen. $TYPO3_CONF_VARS[ 'EXT' ] [ ' e x t L i s t ' ] = '..., dbal, adodb ' ; // Bei Debian Lenny wird auf S e r v e r s e i t e standardmaessig // verwendet und d e s h a l b TYPO3 auf UTF8 u m s t e l l e n. PostgreSQL // b e n u t z t e b e n f a l l s UTF8 a l s S t a n d a r d z e i c h e n s a t z. $TYPO3_CONF_VARS[ 'SYS ' ] [ ' UTF8filesystem ' ] = ' 1 ' ; $TYPO3_CONF_VARS[ 'BE ' ] [ ' forcecharset ' ] = ' utf 8 ' ; 2.7 Installations Tool aktivieren Wenn Sie Zugri auf eine laufende Typo3 Installation haben setzen sie vor der Aktivierung des Installationstools unbedingt eine neues Passwort. Ein Standard Passwort auf einem öentlichen Internetserver ist ein groÿes Sicherheitsrisiko. Im Verzeichnis typo3conf die Datei ENABLE_INSTALL_TOOL anlegen. Die Datei wird von Typo3 nach Ablauf einer bestimmten Zeit automatisch wieder gelöscht. Das ist zum einen lästig wenn man grad am Experimentieren ist und zum anderen kann es Probleme machen wenn die Uhren der beteiligten Computer nicht syncron laufen. Ein schlauer Kopf im Typo3 Team hat daher die möglichkeit vorgesehen das automatische löschen zu verhindern. 6

Dazu müssen Sie lediglich in die Datei den Text KEEP_FILE schreiben. Bedenken Sie aber das die dauernde erreichbarkeit des Typo3 Install Tools im Produktiven Einsatz ein erhebliches Risiko für die Sicherheit Ihres Webservers darstellt. Also setzen Sie KEEP_FILE mit besonderer Vorsicht ein. Zum schluÿ müssen Sie der Datei noch mit folgenden Befehlen die richtigen Dateirechte geben. # Mit vi die Datei anlegen und bei Bedarf KEEP_FILE eintragen vi localconf/enable_install_tool # Dateirechte setzen chown alex:www-data typo3conf/enable_install_tool chmod 660 typo3conf/enable_install_tool 7

3 Starten des Typo3 Installations Tools Jetzt gehts weiter mit dem Browser ihres Vertrauens. Ich habe den Firefox alias Iceweasel von Debian Lenny benutzt. Starten sie das Installationstool mit folgendem Link: http://<domain>/typo3/install/ Sie müssen in dem Link statt dem Teil <Domain> natürlich die Domain angeben unter der ihr eigener Server zu erreichen ist. Sie erhalten dann die Login-Seite für das Installtool. Das Standardpasswort joh316 sollten sie sofort in ein anderes ändern damit keine Bösewichte ihre Typo3 konguration verändern können. Da Typo3 beliebig viele falsche Loginversuche erlaubt müssen Sie mindestens ein 10 stelliges Passwort wählen über sichere Passwörter wurde schon viel geschrieben und daher werde ich es nicht nochmal tun. Mir ist leider kein Weg bekannt wie sie ohne eine laufende Typo3 Installation den Passwort-Hash erzeugen könnten um diesen dann manuell in der Datei localconf.php anzupassen. Daher wenn sie direkt auf einem öentlichen Server installieren wäre kurzzeitig ihr Installtool für jeden erreichbar. Nicht wirklich zu empfehlen. Wenn jemand weiss wie man den Passwort-Hash für das Installationstool ohne Typo3 erzeugen kann würde ich mich über einen Hinweis freuen. Pfad zur Konfigurationsdatei: typo3conf/localconf.php Wenn sie die möglichkeit haben von einer anderen Typo3 Installation einen Passwort- Hash der nicht vom Standardpasswort stammt zu kopieren sollte sie dies unbedingt machen. Natürlich müssen sie auch das Passwort dazu kennen. Sie nden den Hash in der Datei typo3conf/localconf.php der Eintrag ist bereits in der Datei vorhanden und heisst $TYPO3_CONF_VARS['BE']['installToolPasswort'] = '...';. Statt der drei Punte müssen sie den neuen Passwort-Hash suchen. 3.1 Menupunkt: Basic Conguration Im unteren Teil der Basic Conguration gibt es ein Eingabefeld Site name hier können sie zum Beispiel den Firmen- oder Domainnamen eintragen. Ein Klick auf den Button Generate random key und zum Abschluÿ klichen sie auf den Button Update localconf.php um die gemachten Änderungen zu speichern. 8

3 Starten des Typo3 Installations Tools 3.2 Menupunkt: Database Analyser Haben sie bereits eine Typo3-Datenbank die ihre bisherige Website enthält ist es wichtig zu wissen welche Typo3 Version bisher benutzt wurde. Wenn sie von einer 4.1 auf die 4.2 wechseln machen sie eine Sicherungskopie ihrer Datenbank und benutzen dann die Compare Funktion des Datenbankanalysers. Das Ergebnis des compares muÿ man noch mit dem Button Write to database anklicken um die Anpassungen an der Datenbank durchführen. Bei mir war es nicht nötig die diversen alter Befehle auszuführen. Scheinbar ist das Tool schlau genug das zu wissen da diese auch nicht ausgewählt waren. So wie ich vermute liegen diese daran das MySql sich nicht besonders genau am SQL Standard orientiert und die von Typo3 verwendete Datenbank Abstraktionsschicht SQL-Befehle nur in einer Richtung konvertieren kann. 3.3 Update Wizard Wozu es diese Funktion in dieser Form in Typo3 gibt ist mir unklar. Wenn man das alte Verhalten extra aktivieren könnte würde ich es verstehen aber warum man jeden Anwender der neuen Versionen dazu nötigt die neuen Funktionen extra aktivieren zu müssen ist nicht mehr erklärbar. Wie aber schon an anderer stelle erwähnt hat es auch nur das Typo3 Projekt geschaft technische Begrie zu vergewaltigen um organisatorische Dinge auszudrücken. Klicken sie auf den ersten Next Button und stimmen allen Änderungen mit einem Häckchen bei Acknowledged zu. Die anderen Punkte bekommen kein Häckchen. Dann klicken sie auf den Button Perform Updates. So nun haben sie Typo3 so umgestellt das es kompatibel zu seiner aktuellen Version 4.2 ist. 9