![]() |
![]() |
![]() |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Start | Impressum & Datenschutz | Sitemap | Suche | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
Druckansicht Startseite ![]() ![]() ![]() Wie man das Web Content Management System TYPO3 unter OS/2 zum Laufen bringt ![]() von Michael Oehlhof und Roland Schmalenberg vorgetragen am 29.10.2005 [Version 0.29 vom 10.12.2005] ![]()
![]() Logo-Vorschlag von Ruben Schmalenberg ![]() Inhalt ![]() Liste der zu installierenden Applikationen Schritt 1 - eCAMP bzw. AMPOS/2-Server installieren
Schritt 2 - ImageMagick/2 installieren Schritt 3 - TYPO3 installieren, Quickstart oder Dummy?
Die ToDo-Liste zu "TYPO3 goes eComStation"
![]() Vorwort ![]() Schon im Herbst 2003 nach einem TYPO3-Workshop war die Idee geboren worden, TYPO3 auch unter OS/2 bzw. eComStation lauffähig zu machen. Leider fehlte mir (Roland) der entsprechende Skill-Level, dies selbst zu tun. Deshalb habe ich nach einigen erfolgreichen TYPO3-Installationen auf Windows und Linux Ende Januar 2004 die Frage an die deutschsprachige OS/2-Community gestellt, ob es nicht jemanden gäbe, der mit der richtigen Expertise und der nötigen freien Zeit eine Anpassung versuchen könne. Damals hatte ich recht wenig Resonanz gespürt, TYPO3 war in unseren Kreisen einfach zu unbekannt. Dies änderte sich erst, nachdem ich mehrere Sessions zu TYPO3 bei TeamOS/2-Vereinen durchgeführt hatte. Den Knoten durchschlagen hat aber letztlich eine Mail von Michael Oehlhof Anfang Oktober mit einer Anfrage, ob ich nicht eine Session zu TYPO3 in Dresden bei der Warpstock 2005 machen könne. Meine Antwort, es fehle aus meiner Sicht der richtige OS/2-Bezug mit einer lauffähigen TYPO3-Umgebung wurde von ihm am 10. Oktober 2005 mit einer einfachen Feststellung beantwortet: "Hallo Roland, ich habe bei mir TYPO3 3.8.0 unter eComStation 1.1 am laufen."
Dies war die Initialzündung für jetzt 4 Wochen mit intensiven und teils auch nächtelangen "Laborstunden", um vom unter OS/2 gezeigten fehlerfreien Backend zum lauffähigen "TYPO3 goes eComStation" zu kommen. Das momentane Ergebnis kann sich aber schon sehen lassen und ist dank nachfolgendem Kochrezept für den Eintritt in eine neue Ära der Weiternutzung von OS/2 als Webserver auf höherem Niveau auch von der OS/2-Community reproduzierbar. Noch prüfen wir aber in zwei Referenzinstallationen gegen die fortlaufend von uns beiden verbesserte Installationsanleitung, die man hier und auf Michaels Projektwebseite zu AMPOS/2 nachlesen kann. Die "dickste" Aufgabe besteht aber weiterhin in der noch fehlenden Portierung von ImageMagick nach OS/2, dafür konnte ich aber Paul Smedley aus Australien gewinnen. Der Rest ist weitestgehend verfügbar, Kleinigkeiten wie die Anpassung von phpMyAdmin oder sendmail werden realisierbar sein.
Den anvisierten "Jungfernflug" des Gesamtpaketes noch vor der Warpstock 2005 werden wir wohl hinbekommen, zumindest arbeiten wir mit vereinten Kräften an der Erreichung dieses Zieles.
Und wenn die Gemeinschaft es möchte, bleiben Michael, Paul und ich auch weiter am "Joystick".
![]() Liste der zu installierenden Applikationen ![]()
![]() Schritt 1 - eCAMP bzw. AMPOS/2-Server installieren ![]() (zunächst eine kurze Erläuterung der Abkürzungen: eCAMP steht in Anlehnung an LAMP bzw. WAMP für eComStation+Apache/2+MySQL/2+PHP/2, Michaels Vorschlag für AMPOS/2 für Apache/2+MySQL/2+PHP/2+OS/2 gefällt mir aber auch ...)
![]() Achtung: ![]() Wegen eines noch nicht näher eingekreisten Fehlers bei der Auslieferung der erstellten Webseiten mit Apache/2 Version 2.0.53 oder 2.0.55 wird gebeten, bis auf weiteres die Alternativ-Installation mit dem Apache/2 in der Version 1.3.33 zu benutzen. Die Alternativinstallationen sind im folgenden als Variante A gekennzeichnet. Sobald wir den Fehler entdeckt haben, geben wir hier Entwarnung!
![]() 1.1 Apache/2 installieren ![]()
Ein Update von Apache kann später normalerweise einfach über diese Version entpackt werden (die Konfigurationsdatei httpd.conf bleibt i.d.R. erhalten), nur die Datei startup.cmd wird leider immer überschrieben und muss jedesmal wieder angepasst werden.
![]() 1.2 Apache/2 konfigurieren ![]()
Änderungen abspeichern und den Apache/2 über startup.cmd starten, er sollte sich im OS/2-Fenster ohne Fehlermeldung "zeigen" und die Begrüßungsseite anzeigen, wenn man mit dem Browser auf localhost geht. Bitte auch mal testweise eine nicht existente Seite aufrufen, z.B. localhost/notexist.html Apache/2 nun durch Strg-C beenden und im Apache/2-Unterverzeichnis \logs die Dateien error.log und access.log prüfen. Ausser dem zuvor selbst provozierten Aufruf einer nicht existierenden Seite sollten keine Hinweise auf andere Fehler auftauchen, was einfach bedeutet:
![]() 1.3 WarpIn installieren oder aktualisieren ![]() Für die Installation von MySQL/2 gem. Ziffer 1.4 wird zwingend ein lauffähiger WarpInstaller mindestens in der Version 1.0.4 benötigt, die Installation ist eigentlich selbsterklärend ... Leider gibt es aber ein bekanntes Problem, wenn man auf Basis einer eComStation 1.2-Installation von WarpIn 1.0.2 auf >=1.0.4 upgraden möchte. Man muss manuell die alte Datei c:\ecs\dll\wpirtl.dll löschen, sonst bleibt man erfolglos!
![]() 1.4 MySQL/2 installieren ![]() Bei installiertem WarpIn reicht ein Doppelklick auf das zuvor heruntergeladene Archiv mysql-4-1-7-b2.wpi, um in die Installationsabfragen des Installers zu gelangen. Bitte aber nicht einfach allen Empfehlungen folgen, sondern folgende Anpassungen vornehmen: - bei einer Erstinstallation von MySQL/2 auch die "Initial Database" mit einem Doppelklick auswählen, - den Installationspfad aller Pakete abändern auf C:\Apps\mysql41 und anschliessend einzeln auswählen und den Pfad nochmals prüfen, - danach startet man die Installation der 3 Pakete und insgesamt 282 Dateien.
![]() 1.5 MySQL/2 konfigurieren ![]() Bisher ging es noch recht automatisch, jetzt beginnt die Handarbeit: - ergänze in der config.sys die LIBPATH-Zuweisung am Ende um
- entpacke die Datei LIBC06B2.DLL aus dem Archiv libc06b2.zip nach c:\Apps\mysql41\dll, - verschiebe die Datei mysql41.dll aus dem Verzeichnis c:\Apps\mysql41\bin\ nach c:\Apps\mysql41\dll. - erzeuge auf dem MySQL/2-Installationslaufwerk in der Wurzel ein Verzeichnis \tmp - ändere die Einstellungen zum Programmobjekt "Starte Server" wie folgt:
- benenne das Programmobjekt "Starte Server" um in "Run MySQL 4.1.7 Server"
Jetzt wäre ein geeigneter Zeitpunkt, den PC durchzustarten, damit die Änderung des LIBPATH greift. MySQL/2 sollte sich dann fehlerfrei starten und stoppen lassen.
![]() 1.6 MySQL/2-Client korrigieren ![]() Dem zusammen mit dem MySQL/2-Paket 4.1.7 ausgelieferten Kommandozeilen-Client fehlt die Befehlshistorie, mit der man bereits zuvor eingegebene Befehle bequem wieder aufrufen kann. Wer auf dieses Feature nicht verzichten mag, kann aus einer älteren MySQL/2-Version z.B. Version 4.0.18 nach dem Auspacken folgende Dateien kopieren:
Anschliessend bitte ein Programmobjekt für vorgenannte mysql.exe erstellen.
![]() 1.7 PHP/2 installieren ![]() Das Archiv php4.3.10-os2.zip wird in das Verzeichnis c:\Apps\php4 entpackt.
![]() 1.8 PHP/2 für Apache/2 konfigurieren ![]() Leider müssen auch hier einige Dinge manuell erledigt werden: - kopiere die Datei php.ini-dist nach C:\MPTN\ETC\php.ini, - kopiere die Datei c:\Apps\php4\php4.dll nach C:\Apps\php4\modules\
Für die MySQL/2- und Typo3-Unterstützung müssen in der C:\MPTN\ETC\php.ini noch Anpassungen vorgenommen werden.
Damit die PHP/2-Module auch unabhängig von der Verwendung mit Apache/2 eingesetzt werden können, ist erneut eine Ergänzung der LIBPATH-Zuweisung in der config.sys vorzunehmen:
Anschliessend bitte wieder den PC durchstarten, um die Änderung des LIBPATH wirksam werden zu lassen.
![]() 1.9 Apache/2 für PHP/2 konfigurieren ![]() Unserem Apache/2 müssen die neuen Möglichkeiten noch bekannt gemacht werden, hierzu bitte die Datei
Damit die Einstellungen übernommen werden, ist für die folgenden Tests ein Neustart des Apache/2 erforderlich.
![]() 1.10 Apache/2 und PHP/2 testen ![]() Zum späteren einfacheren Abruf der Statusinformationen ist es hilfreich, in C:\Apps\apache1\htdocs (Apache/2 1.3.33) oder C:\Apps\apache2\htdocs (Apache/2 2.0.5x) eine Textdatei phpinfo.php mit folgendem Inhalt zu erstellen:
Rufen Sie dann bitte im Browser die Adresse 127.0.0.1/phpinfo.php auf, wird dann eine Seite mit Angaben über die PHP/2-Installation angezeigt, gilt:
![]() 1.11 phpMyAdmin installieren ![]() Zunächst wird manuell ein Verzeichnis c:\Apps\apache1\htdocs\phpmyadmin (Apache/2 1.3.33) oder c:\Apps\apache2\htdocs\phpmyadmin (Apache/2 2.0.5x) angelegt und dort das Archiv phpMyAdmin-2.5.7-pl1.zip so entpackt, dass unterhalb des manuell angelegten Ordners kein Verzeichnis phpMyAdmin-2.5.7-pl1 entsteht.
Laden Sie die Datei config.inc.php in einen Editor und passen Sie die Angaben für "host", "user", "password" und "authentication mode" an Ihre Gegebenheiten an. Der "host" ist der MySQL/2-Server. Wenn Sie die Installation bisher nach der Anleitung vorgenommen haben, so reicht es aus, nur den folgenden Eintrag vorzunehmen:
Geben Sie 127.0.0.1/phpmyadmin/index.php im Browser ein. phpMyAdmin sollte nun eine Willkommensseite und die Datenbank anzeigen.
![]() Schritt 2 - ImageMagick/2 installieren ![]() Da es seit ImageMagick 4.2.2 keinen OS/2-Port mehr gab (ich habe jedenfalls keinen gefunden) und dieses Paket für den sinnvollen Einsatz von TYPO3 aber benötigt werden wird, habe ich auf Tipp von Andreas Roederer Paul Smedley gebeten, einen Port zu versuchen und die Zwischenergebnisse von mir (Roland Schmalenberg) testen zu lassen. Es sieht schon relativ gut aus und ich hoffe deshalb, das Paket noch zur Warpstock 2005 zusammen mit Paul vorläufig freigeben zu können.
![]() Schritt 3 - TYPO3 installieren, Quickstart oder Dummy? ![]() Endlich sind wir da angekommen, wo wir hinwollten, zur Installation des Enterprise Content Management Systems TYPO3. Wir empfehlen insbesondere TYPO3-Neueinsteigern wie folgt vorzugehen, um ein späteres mühevolles Fehlersuchen zu vermeiden:
1. Nachweis einer funktionierenden TYPO3-Umgebung mit der Installation von quickstart-3.8.0, dabei kann die Installation, der Betrieb des Backends (BE) und die korrekte Auslieferung der Webseiten für das Frontend (FE) getestet werden. 2. Erst danach Installation des "leeren" TYPO3-Paketes dummy-3.8.0 für die eigenen Webprojekte.
Im nachfolgenden werden beide Varianten Schritt für Schritt so erläutert, dass man anschliessend mit der offiziellen TYPO3-Dokumentation alleine weiterkommt.
![]() 3.1 TYPO3-Quickstart manuell anpassen ![]() Auf der Downloads-Webseite von typo3.org findet man das für Windows bestimmte Paket quickstart-3.8.0.zip, dieses entpackt man in das Verzeichnis \htdocs\ des zuvor installierten Apache/2.
Vor der Benutzung müssen in dem ausgepackten Paket noch einige Anpassungen für eComStation bzw. OS/2 vorgenommen werden. Noch wissen nur wir, dass TYPO3 auch auf unserem OS-Favoriten läuft ;-)
Im einzelnen geht es um den Austausch der betriebssystemabhängigen Definition der Umgebungsvariablen TYPO3_OS in folgenden Dateien:
Folgende Zeile muss jeweils ausgetauscht werden:
gegen
![]() 3.2 TYPO3-Quickstart automatisiert anpassen ![]() Für diese Installationsvariante wird mein REXX-Script-Paket GetTypo3forOS2_1_15.zip benötigt, es muß in das Verzeichnis \htdocs\ des zuvor installierten Apache/2 heruntergeladen und entpackt werden. Die GetTypo3forOS2Readme.txt lesen und auf der Kommandozeile GetTypo3forOS2.cmd -h ausführen.
Damit wird die Hilfe aufgerufen: ![]() ![]()
Wir brauchen für den Download und die Anpassung des TYPO3-Paketes quickstart-3.8.0 an eComStation also nur GetTypo3forOS2.cmd -exec einzugeben, um das Paket in Europa herunterladen und die notwendigen Anpassungen vornehmen zu lassen: ![]()
![]() Damit wurden die Anpassungen der betriebssystemabhängigen Umgebungsvariablen TYPO3_OS in folgenden Dateien automatisch vorgenommen:
Folgende Zeilen wurden jeweils ausgetauscht:
gegen
Darüberhinaus wurde in der folgenden Datei
folgende Zeile:
auskommentiert:
Damit wird TYPO3 in den 1-2-3-Installationsmode versetzt und die nachfolgend beschriebenen Schritte zur Erstkonfiguration können erfolgreich vorgenommen werden.
![]() 3.3 TYPO3-Quickstart installieren ![]() Zunächst sind MySQL/2- und Apache/2-Server zu starten, danach startet man mittels Browser die lokale Quickstart-Installation.
Es wird dann eine Seite mit Sicherheitshinweisen angezeigt:
![]() ![]() Nach Klick auf OK geht es richtig los, im nächsten Fenster zeigt sich das 1-2-3-Installationsmodul, für den Testbetrieb lasse ich die Felder Username und Password leer (dies dürfen wir aus Sicherheitsgründen bei einer Produktivumgebung natürlich niemals zulassen) und bestätige die Schaltfläche "Update localconf.php": ![]() ![]() Im Schritt 2 geben wir dem TYPO3-Installationsmodul den Auftrag, die Datenbank "t3_quickstart" anzulegen (alle TYPO3-Datenbanknamen sollten mit "t3_" anfangen, dies ist eine sehr gute Empfehlung von Kasper, irgendwann sieht man vor lauter Wald nämlich die Bäume nicht mehr): ![]() ![]() Fast sind wir fertig, im letzten Schritt müssen wir unsere bisher "leere" Datenbank "t3_quickstart" mit Leben füllen, schließlich wollen wir als einfachen Einstieg den Webauftritt eines Fußballvereines zeigen (ach, das hatte ich noch gar nicht erwähnt, macht nichts, jetzt ist es heraus ...). Dies geschieht bei TYPO3 immer durch einen "dump" mit einer sql-Datei, hier mit "database.sql" und einem Klick auf die Schaltfläche "Import database": ![]() ![]() Nach einiger Aktivität auf der Festplatte zeigt sich das 1-2-3-Installationsmodul von seiner schönsten Seite, mit einem roten "Go" wird das erfolgreiche Ende der Installation angezeigt: ![]() ![]() Wir werden jetzt der Versuchung widerstehen und weder das Frontend- noch das Backend-Modul aufrufen, sondern der Empfehlung folgen und noch einige Tests und Änderungen durchführen. Wir bleiben also im Installationstool und konfigurieren jetzt weiter TYPO3, indem wir auf den Link "Continue to configure TYPO3" klicken. Es erscheint die Einstiegsseite des TYPO3-Installationstools: ![]() ![]() Wir rufen nun den Link "All Configuration" auf, weil wir für OS/2 und eComStation noch die Freetype-Version anpassen müssen: ![]() ![]() und scrollen solange, bis die Einstellung für "TTFdpi" zu sehen ist (tatsächlich habe ich die Suchfunktion des Mozilla benutzt), hier überschreiben wir den Wert "72" mit "96": ![]() ![]() Die Schaltfläche für das Abspeichern befindet sich am Ende der Bildschirmseite, ein Klick auf "Write to localconf.php" und wir sind fertig: ![]()
![]() Das war es, wir sind mit der Installation fürs erste fertig! Jetzt können wir mal sehen, wie es um unseren Fußballvereinsauftritt bestellt ist! ![]() ![]() 3.4 TYPO3-Quickstart-Frontend starten und testen ![]() Dazu startet man mittels Browser den Webauftritt eines fiktiven Vereines.
Wird nun die Seite des Fußball-Vereins "FC Bigfeet" angezeigt, hat man es geschafft!: ![]() ![]() Man sollte nun alle Seiten einmal aufmachen und auch die erweiterten Funktionen wie folgt ausprobieren: a. Home - Guestbook - neuen Eintrag vornehmen, es sollte funktionieren b. Home - Search - Searchword "filii" - Search in "Pagecontent", es sollten 5 Treffer angezeigt werden c. Home - Login - Click here to login - Username "john" - Password "football", es sollte eine neue Homepage "Team Pages" erscheinen mit geschützten Unterseiten:
Folgendes kann derzeit leider noch nicht funktionieren: a. Alle Mail-Funktionen, weil wir sendmail/2 noch nicht integriert haben b. Alle Bild-Vergrösserungsfunktionen, weil wir ImageMagick/2 noch nicht integriert haben
Dennoch, wer bis hierher gekommen ist, dürfte schon erahnen, welche Möglichkeiten sich mit der Implementation von "TYPO3 goes eComStation" für uns OS/2er bieten ...
![]() 3.5 TYPO3-Quickstart weiter testen und TYPO3 kennenlernen ![]() Eine der besten Methoden, TYPO3 kennenzulernen, geht schrittweise mit dem Quickstart-Tutorial für TYPO3-Anfänger, dieses Dokument gibt es in verschiedenen Ausführungen:
Quickstart-Getting Started (english, online), Quickstart-Getting Started (english, OpenOfficeDocument, 3.2 MB), Quickstart-Getting Started (english, PDF, 5.8 MB),
Quickstart-Der Einstieg (deutsch, OpenOfficeDocument, 3.3 MB), Quickstart-Der Einstieg (deutsch, PDF, 5.8 MB),
Das Durcharbeiten stellt auch den besten Test für die funktionierende TYPO3-Umgebung unter eComStation bzw. OS/2 dar.
Läuft alles fehlerfrei, darf man nun behaupten:
![]() Die ToDo-Liste zu "TYPO3 goes eComStation" ![]() Wie immer bei so einem großen Projekt entdeckt man "on the fly" neue Baustellen:
- ImageMagick/2 integrieren (Projekt angefangen, Maintainer Paul Smedley + Roland Schmalenberg) - sendmail/2 integrieren (binaries?, Maintainer?) - MySQL/2 über "pipes" statt "sockets" bedienen (Performanceverbesserung?) - ein "Pack and Go"-WarpInstaller-Paket mit fertig vorkonfiguriertem eCAMP bzw. AMPOS/2 (Projekt angefangen, Maintainer Michael Oehlhof + Roland Schmalenberg)
![]() Danksagungen ![]() Wenn man so weit gekommen ist, gilt es, an dieser Stelle auch einmal danke zu sagen für alle, die Michael und mir beim Gelingen dieses Projektes geholfen haben: ![]()
![]() Dieses Dokument wird fortlaufend aktualisiert von Roland Schmalenberg, Vorschläge für Änderungen, Ergänzungen etc. erbeten an meine Mail-Adresse (die gibt es wirklich noch): roland.schmalenberg (at) lycosxxl.de ![]()
![]() Druckansicht Startseite ![]() ![]() ![]() |
Vereinstermine ![]() ![]() |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |