|Start | Impressum | Sitemap | Suche|
|Druckansicht Startseite TYPO3 goes eComStation + TYPO3 goes OS/2 (en)
How to get the Web Content Management System TYPO3 to fly on OS/2
presented by Michael Oehlhof and Roland Schmalenberg on the 25th of October 2005
[Release 0.29 translated by Andreas Roederer and Roland Schmalenberg - 10th of December 2005]
Logo proposal by Ruben Schmalenberg
In autumn 2003, after a Typo3-workshop there was born the idea of running TYPO3 on OS/2 and eComStation. Unfortunately, I (Roland) was missing the skill to do it on my own. After some successful TYPO3-installations on Windows and Linux at the end of January 2004 I asked the german community if someone has the knowledge and spare time to make the necessary modifications.
I missed the resonance, TYPO3 was really unknown in our groups. The situation began to change after doing several sessions related to TYPO3 at OS/2-clubs.
Two simple mails of Michael Oehlhof (he had listened one of my sessions before) at the beginning of October changed all, in the first he asked me if I can imagine to present a session around TYPO3 at Warpstock 2005 in Dresden. My answer, I would like to do that but in my opinion it will not make real sense because a running TYPO3-environment on base of our OS/2 was still missing ...
This led to the second mail from Michael on the 10th of October 2005 with the simple statement:
"Hello Roland, I've got TYPO3 3.8.0 running on eComStation 1.1."
This was the initial ignition for more then 4 weeks now of intensive and nightfull "hours of lab" to get the big step from an only errorfree working TYPO3 backend login to a running "TYPO3 goes eComStation". The actual result seems to be very promising and should be reproducable from everyone out in the OS/2 communities on base of the following cook recipe. This will be the ticket of admission in an new area for using OS/2 as a platform for web services too.
In the meantime we check at 2 reference installations against our 2 descriptions to prove or correct them. You are reading now one version and the other can be found at Michaels project web site AMPOS/2.
One major task to do is the missing port of ImageMagick to OS/2, I have got the chance to invite Paul Smedley from Australia for that job. The most parts of the rest are available, some minor stuff like changes to phpMyAdmin code and porting of sendmail should be realizable.
We are still working hard in our spare time to make the "maiden flight" of the whole package possible before Warpstock 2005.
And if the community is interested in our work Michael, Paul und I will stay at the "joystick".
List of applications
Step 1 - Installing eCAMP respectively AMPOS/2-Server
(first some explanations: we use eCAMP according to LAMP rsp. WAMP for eComStation+Apache/2+MySQL/2+PHP/2. I also like Michaels proposal AMPOS/2 for Apache/2+MySQL/2+PHP/2+OS/2 ...)
While there is an error with the delivery of the generated webpages with apache 2.0.53 and 2.0.55, we request you to use the alternate package with apache 1.3.33. We have marked the alternative as option A.
As soon as we find the error, we will tell you.
1.1 Installing Apache/2
Normally you can update the Apache/2 with a newer version by extracting the new archive over your existing installation. The config-file (httpd.conf) will not be overwritten, while your startup.cmd unfortunately is. So please be sure to make a backup before your update.
1.2 Changing the Apache/2 configuration
Save your changes and start Apache/2 with running startup.cmd, Apache/2 should "show" itself in the OS/2-box without errors and should be able to deliver the welcome page to your browser request at localhost. Please also check the reaction to the request of a non existing page like localhost/notexist.html
Stop Apache/2 with Strg-C in the OS/2-box and check the Apache/2 log folder \logs and there the files error.log and access.log. You shouldn't find any further errors beside the faults to the non existing website request and that simply means:
1.3 Installing or updating of WarpIn
For installation of MySQL/2 as refered in 1.4 you need a WarpInstaller version 1.0.4 or newer ...
Attention: eComStation version 1.2 users
If you are running that version you have got WarpIn 1.0.2 and have to upgrade to >=1.0.4. Due to a bug you will be successful only with the following hint:
Please delete the old file c:\ecs\dll\wpirtl.dll by hand before upgrading!
1.4 Installing MySQL/2
If you had installed WarpIn before a double click to mysql-4-1-7-b2.wpi should start the installation process of this package. But please do not accept the recommendations without regards:
- if this is the first installation of MySQL/2 you have to double click the "Initial Database" also,
- change the installation path of all packages to C:\Apps\mysql41 and check the path values carefully by selecting package for package,
After that checks you are able to start the installation of the 3 packages with together 282 files.
1.5 Configuring MySQL/2
Now the real manual work begins:
- edit config.sys and add to LIBPATH
- unpack the file LIBC06B2.DLL from archive libc06b2.zip to c:\Apps\mysql41\dll,
- move mysql41.dll from folder c:\Apps\mysql41\bin\ to c:\Apps\mysql41\dll.
- create a folder \tmp at root level of your MySQL/2 install drive
- change the adjustments of the program object "Start Server" as follows:
- rename the program object "Start Server" to "Run MySQL 4.1.7 Server"
To check the changes of LIBPATH it will be a good idea to restart your pc now and to try to start and stop MySQL/2. It should work without any errors.
1.6 Correcting MySQL/2-Client
Due to compiling problems the command line client out of the MySQL/2 archive version 4.1.7 has no built-in command history for easily recall of prentered commands.
For those people missing this feature it will be helpful to know that you are able to use some files from an older version of MySQL/2 e.g. 4.0.18 to get it work. Please unpack first and copy the following files:
Last but not least you should create a program object for this mysql.exe.
1.7 Installing of PHP/2
Please unpack the archive php4.3.10-os2.zip to the folder c:\Apps\php4
1.8 Configuring PHP/2 for Apache/2
Some work has to be done by hand:
- copy file php.ini-dist to C:\MPTN\ETC\php.ini,
- copy file c:\Apps\php4\php4.dll to C:\Apps\php4\modules,
Some further changes to C:\MPTN\ETC\php.ini have to be done for supporting MySQL/2- and TYPO3:
If you want to use PHP/2 without Apache/2 you should add the LIBPATH-definition in file config.sys with:
Please remember your computer has to be restarted first before you are able to use the change of the LIBPATH-definition.
1.9 Configuring Apache/2 for PHP/2
Apache/2 has to know the new features, please open file
You have to restart Apache/2 for using that new adjustments.
1.10 Testing Apache/2 and PHP/2
For later reviewing state informations it is helpful to create a textfile phpinfo.php in C:\Apps\apache1\htdocs (Apache/2 1.3.33) or C:\Apps\apache2\htdocs (Apache/2 2.0.5x) with the following contents:
If you call 127.0.0.1/phpinfo.php afterwards with your browser a page with informations about your PHP/2-installation will be shown up you can assert:
1.11 Installing of phpMyAdmin
At first we create a folder c:\Apps\apache1\htdocs\phpmyadmin (Apache/2 1.3.33) or c:\Apps\apache2\htdocs\phpmyadmin (Apache/2 2.0.5x). Then get the archive phpMyAdmin-2.5.7-pl1.zip and unzip the contents to that folder (please be aware there is no further folder phpMyAdmin-2.5.7-pl1).
Edit the file config.inc.php and change the values of "host", "user", "password" and "authentication mode" to your request. The "host" is your mySQL/2-server. If you have followed our installation guide so far the following entry is still enough:
Calling the 127.0.0.1/phpmyadmin/index.php with your favorite browser will show up the welcome page of phpMyAdmin.
Step 2 - Installing of ImageMagick/2
Because there is no newer ImageMagick OS/2-port since version 4.2.2 (I couldn't found any) and you have to have that package for usefull operation of TYPO3, I asked (hint of Andreas Roederer) Paul Smedley trying a new port and get me tested the provisional results (Roland Schmalenberg).
It seems to be relative good and I hope, I can release that package together with Paul as a beta until Warpstock 2005.
Step 3 - Installing of TYPO3: Quickstart or Dummy?
Now we have reached the final destination, the last steps for installing of the Enterprise Content Management System TYPO3 have to be done ...
If you want to avoid stressful looking for errors we recommend to do it as follows:
1. Proof of a well working TYPO3 environment with
2. After that you should install the "empty" TYPO3-package dummy-3.8.0 for your own webproject.
Both of that alternatives will be explained now step by step, and afterwards you are able to use the offical documentation of TYPO3 for the further questions around using and operating.
3.1 Modifying TYPO3-Quickstart by hand
Before you are able to use it you have to make some adjustments for running on eComStation or OS/2. By now there are only a few people knowing that TYPO3 goes eComStation ;-)
You have to change the operating system dependent definition of the environment variable of TYPO3_OS in the following files:
Change every occurence of the string:
3.2 Modifying TYPO3-Quickstart by REXX
For this method you need my REXX-script-pack GetTypo3forOS2_1_15.zip, please download and unzip it to the folder \htdocs\ of your installed Apache/2.
Then read the GetTypo3forOS2Readme.txt and call the built-in help with the following command line entry
All you have to do for downloading from a European site and making automatically the neccessary modifications of TYPO3-Quickstart-3.8.0 to eComStation is a command line call
After that call the script has automatically changed the operating system related environment value TYPO3_OS in all of the following files:
All occurrences of :
was changed to
The script has also uncommented the line in file
Now your TYPO3 was prepared to run in the so-called 1-2-3-Install Tool and you can do the documented next steps for the successful configuration.
3.3 Installing TYPO3-Quickstart
Start MySQL/2- and Apache/2-Server before you try to load the local Quickstart-installation in your browser.
You should get a security note as follows:
Acknowledging that security message with clicking the OK-button will lead you to the TYPO3 1-2-3-Install Tool and the questions for username and password. We can skip that fields by clicking the button "Update localconf.php" because we only want a test installation ...
But please remember:
If you want to go to the real world, you have to change that access entries before!
In step 2 of the TYPO3 1-2-3 Install Tool you have to define the database to be used.
In our example we create a new database "t3_quickstart" (all TYPO3-databases should be named with a leading "t3_", this is one of the best practices of Kasper):
Okay, in the last step we have to fill the "empty" database with "t3_quickstart" to create the homepage of a soccer club as an example for learning more about TYPO3 (uups, had I mentioned that before, no, okay we haven't got any more secrets ...).
TYPO3 use a "dump" of a sql-file, please choose "database.sql" and click to the button "Import database":
After some seconds of hope and activities on your hard drive the 1-2-3 Install Tool will show its best page: a red "Go" shows us the successfull end of installation:
You're done and we won't click one of the links to the "frontend pages" or the "backend login", we follow the recommended way and click on "Continue to configure TYPO3" to make further changes.
You shall get the first page of the TYPO3 3.8.0 Install Tool:
Click the link "All Configuration" for doing a change related to the used version of Freetype/2:
Please scroll until "TTFdpi" appears (I've used the built-in search function of my Mozilla, that works better), and change the value from "72" to "96":
At the bottom of this page you will find the button "Write to localconf.php", please click it and you're ready:
That's it we have finished the first installation of TYPO3!
And what's about our presentation of the soccer club? Does it work?
We will try it ...
3.4 Starting and testing the frontend of TYPO3-Quickstart
Please get the homepage of the virtual soccer club by loading "http://127.0.0.1/quickstart-3.8.0/"
If you get presented that page of the soccer club "FC Bigfeet" you really have got a further milestone!
After that taste of good vibrations you should load all pages and test the extended features as follows:
a. Home - Guestbook - add a new entry, it should work
b. Home - Search - Searchword "filii" - Search in "Pagecontent", if you get 5 results it works fine
c. Home - Login - Click here to login - Username "john" - Password "football", you should get a changed homepage "Team Pages" with secured pages:
Cause of "TYPO3 goes eComStation" is a work in progress the following features are still missing:
a. all mail-functions until we have integrated sendmail/2 or similar
b. all functions related to picture-resizing until we have done the ImageMagick/2 available
However, if you reached this point in the installation checklist you're able to imagine what great things can be done with this implementation of "Typo3 goes eComStation" and in our eComStation- and/or OS/2-communities ...
3.5 Learning more about TYPO3
One of the preferred methods to get inside TYPO3 is learning by doing with the document "Getting Started". This tutorial is written for TYPO3-newbees and is available in different types:
Those documents are also available in Danish (original) and translations to French, German and Spanish.
Successful working with this tutorial will be the best proof of "TYPO3 goes eComStation".
If you are able to do that without any errors you have got it:
To do's of "TYPO3 goes eComStation"
Like other projects in work we still discover more and more tasks to do "on the fly":
- integrating of ImageMagick/2 (project started 17 Oct 2005, maintained by Paul Smedley + Roland Schmalenberg)
- integrating of sendmail/2 or creating a wrapper to Weasel (binaries? Maintainer?)
- using MySQL/2 "pipes" instead of "sockets" (should we have better performance?)
- creating a WarpInstall-package with a "Ready to Go"-environment for eCAMP or AMPOS/2 (project started, maintained by Michael Oehlhof + Roland Schmalenberg)
After that piece of work it is time to thank those people who helped Michael and me to guide this project to success:
This document is still a work in process by Roland Schmalenberg, if you got any proposals, changes, addons or something else, please don't hesitate to mail to roland.schmalenberg (at) lycosxxl.de
Druckansicht Startseite TYPO3 goes eComStation + TYPO3 goes OS/2 (en)