Startseite  TYPO3 goes eComStation  + TYPO3 goes OS/2 (en)  

---

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

Foreword

List of applications

Step 1 - Installing eCAMP respectively AMPOS/2-Server

1.1 Installing Apache/2

1.2 Changing the Apache/2 configuration

1.3 Installing or updating of WarpIn

1.4 Installing MySQL/2

1.5 Configuring MySQL/2

1.6 Correcting MySQL/2-Client

1.7 Installing of PHP/2

1.8 Configuring PHP/2 for Apache/2

1.9 Configuring Apache/2 for PHP/2

1.10 Testing Apache/2 and PHP/2

1.11 Installing of phpMyAdmin

Step 2 - Installing of ImageMagick/2

Step 3 - Installing of TYPO3: Quickstart or Dummy?

3.1 Modifying TYPO3-Quickstart by hand

3.2 Modifying TYPO3-Quickstart by REXX

3.3 Installing TYPO3-Quickstart

3.4 Starting and testing the frontend of TYPO3-Quickstart

3.5 Learning more about TYPO3

To do's of "TYPO3 goes eComStation"

Acknowledgements

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".

(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.

 

Option A: Apache/2 1.3.33

Extract the package apache_1.3.33-os2.zip to the directory \Apps\apache1 of your harddrive. Then create a file startup.cmd with the following content

@echo off

rem adjust as necessary

set beginlibpath=C:\Apps\apache1;C:\Apps\apache1\libexec;

c:

cd c:\Apps\apache1

httpd -d .

 

Option B: Apache/2 2.0.5x

Extract the package httpd-2.0.53-os2.zip or httpd-2.0.55-os2.zip to the directory C:\Apps\apache2. Then you will find the apache under C:\Apps\apache2. Next you have to change the file startup.cmd. Find the line

set beginlibpath=F:\Apps\apache2\bin;F:\Apps\apache2\modules;

and change the path to

set beginlibpath=C:\Apps\apache2\bin;C:\Apps\apache2\modules;

.

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.

 

Option A: Apache/2 1.3.33

 

Go to the subdirectory \Apps\apache1\conf and copy httpd.conf-dist-os2 to httpd.conf. Then open the file with any text-editor you like.

Now change any occurrence of

@@ServerRoot@@

to the path

\Apps\apache1

 

 

Please adjust the following parameters to your own environment:

 

c. line 288: ServerAdmin Roland.Schmalenberg@epost.de

c. line 307: ServerName 192.168.0.100:80

 

 

Option B: Apache/2 2.0.5x

Please copy file httpd-std.conf in folder \Apps\apache2\conf to httpd.conf and open it in your editor. If you only want to use Apache/2 with a certain IP address of your pc you should change »Listen 80« e.g. in »Listen 192.168.0.100:80«. But it is also possible to use your local loopback interface (127.0.0.1). With the last option your Apache/2 only allow connections from the same pc. This will be very helpful for testing purposes.

 

Please adjust the following parameters to your own environment:

 

c. line 312: ServerAdmin Roland.Schmalenberg@epost.de

c. line 327: ServerName 192.168.0.100:80

 

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:

You have installed Apache/2 without errors!

 

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!

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.

Now the real manual work begins:

- edit config.sys and add to LIBPATH

;c:\Apps\mysql41\dll

- 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:

program

path an filename: *

parameter: /c set TMP=c:/tmp & MYSQLD.EXE --console & if errorlevel 1 pause

working directory: c:\Apps\mysql41\bin

session

At start symbolsize

- 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.

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:

 

dll\libc05.dll to C:\Apps\mysql41\bin4-0-18\libc05.dll

bin\mysql.exe to C:\Apps\mysql41\bin4-0-18\mysql.exe

bin\mysql40.dll to C:\Apps\mysql41\bin4-0-18\mysql40.dll

 

Last but not least you should create a program object for this mysql.exe.

Please unpack the archive php4.3.10-os2.zip to the folder c:\Apps\php4

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,

 

Option A: Apache/2 1.3.33

- copy file c:\Apps\php4\apache13\modphp4.dll to C:\Apps\apache1\libexec,

- copy file c:\Apps\php4\cgi\php.exe to C:\Apps\apache1\cgi-bin

Option B: Apache/2 2.0.5x

- copy file c:\Apps\php4\apache20\modphp4.dll to C:\Apps\apache2\modules,

- copy file c:\Apps\php4\cgi\php.exe to C:\Apps\apache2\cgi-bin

 

Some further changes to C:\MPTN\ETC\php.ini have to be done for supporting MySQL/2- and TYPO3:

 

c. line 234: memory_limit = 16M ; changed_by_rosch_20051022

c. line 428: extension_dir="C:\Apps\php4\modules"

c. line 488: upload_max_filesize = 10M ; changed_by_rosch_20051015

c. line 585: extension=gd.dll ; changed_by_rosch_20051015

c. line 586: extension=mbstring.dll ; changed_by_rosch_20051015

c. line 587: extension=mcrypt.dll ; changed_by_rosch_20051015

c. line 588: extension=mysql.dll ; changed_by_rosch_20051015

 

If you want to use PHP/2 without Apache/2 you should add the LIBPATH-definition in file config.sys with:

;c:\Apps\php4\modules

 

Please remember your computer has to be restarted first before you are able to use the change of the LIBPATH-definition.

Apache/2 has to know the new features, please open file

 

Option A: Apache/2 1.3.33

\Apps\apache1\conf\httpd.conf and check or add the entries as follows:

 

ca. Zeile 33: LoadModule php4_module libexec/modphp4.dll

ca. Zeile 394: DirectoryIndex index.html index.html.var index.php

ca. Zeile 789: AddType application/x-httpd-php .php

 

Option B: Apache/2 2.0.5x

\Apps\apache2\conf\httpd.conf and check or add the entries as follows:

 

ca. Zeile 268: LoadModule php4_module modules/modphp4.dll

ca. Zeile 430: DirectoryIndex index.html index.html.var index.php

ca. Zeile 873: AddType application/x-httpd-php .php

 

You have to restart Apache/2 for using that new adjustments.

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:

 

<?php

phpinfo();

?>

 

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:

Apache/2, MySQL/2 and PHP/2 was installed without errors!

 

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:

 

near line 40: $cfg['PmaAbsoluteUri'] = 'http://127.0.0.1/phpmyadmin';

 

Calling the 127.0.0.1/phpmyadmin/index.php with your favorite browser will show up the welcome page of phpMyAdmin.

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.

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

the installation of quickstart-3.8.0 first,

testing the operation of the backend (BE) and

the correct delivery of websites at the frontend (FE).

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.

Get the quickstart-3.8.0.zip from the download-area of typo3.org and unzip this archive to the folder \htdocs\ of your ready installed Apache/2.

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:

 

\htdocs\quickstart-3.8.0\index.php

\htdocs\quickstart-3.8.0\showpic.php

\htdocs\quickstart-3.8.0\t3lib\thumbs.php

\htdocs\quickstart-3.8.0\tslib\index_ts.php

\htdocs\quickstart-3.8.0\tslib\showpic.php

\htdocs\quickstart-3.8.0\typo3\init.php

\htdocs\quickstart-3.8.0\typo3\thumbs.php

\htdocs\quickstart-3.8.0\typo3\sysext\cms\tslib\index_ts.php

\htdocs\quickstart-3.8.0\typo3\sysext\cms\tslib\showpic.php

\htdocs\quickstart-3.8.0\typo3\t3lib\thumbs.php

 

Change every occurence of the string:

define('TYPO3_OS', stristr(PHP_OS,'win')&&!stristr(PHP_OS,'darwin')?'WIN':'');

to

define('TYPO3_OS', (stristr(PHP_OS,'win')&&!stristr(PHP_OS,'darwin'))||stristr(PHP_OS,'os/2')?'WIN':'');

 

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

GetTypo3forOS2.cmd -h

Image 1: GetTypo3forOS2 in action - built-in help

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

GetTypo3forOS2.cmd -exec

Image 2: GetTypo3forOS2 in action - that screen appears only after successful downloading and changing the selected TYPO3-package

After that call the script has automatically changed the operating system related environment value TYPO3_OS in all of the following files:

 

\htdocs\quickstart-3.8.0\index.php

\htdocs\quickstart-3.8.0\showpic.php

\htdocs\quickstart-3.8.0\t3lib\thumbs.php

\htdocs\quickstart-3.8.0\tslib\index_ts.php

\htdocs\quickstart-3.8.0\tslib\showpic.php

\htdocs\quickstart-3.8.0\typo3\init.php

\htdocs\quickstart-3.8.0\typo3\thumbs.php

\htdocs\quickstart-3.8.0\typo3\sysext\cms\tslib\index_ts.php

\htdocs\quickstart-3.8.0\typo3\sysext\cms\tslib\showpic.php

\htdocs\quickstart-3.8.0\typo3\t3lib\thumbs.php

 

All occurrences of :

define('TYPO3_OS', stristr(PHP_OS,'win')&&!stristr(PHP_OS,'darwin')?'WIN':'');

was changed to

define('TYPO3_OS', (stristr(PHP_OS,'win')&&!stristr(PHP_OS,'darwin'))||stristr(PHP_OS,'os/2')?'WIN':'');

 

The script has also uncommented the line in file

 

\htdocs\quickstart-3.8.0\typo3\install\index.php

 

from:

die("In the source distribution of TYPO3, the install script is disabled by a die() function call.<br/>Fix: Open the file typo3/install/index.php and remove/out-comment the line that outputs this message!");

to:

// die("In the source distribution of TYPO3, the install script is disabled by a die() function call.<br/>Fix: Open the file typo3/install/index.php and remove/out-comment the line that outputs this message!");

 

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.

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:

Image 3: TYPO3 1-2-3-Install Tool - security note

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!

Image 4: TYPO3 1-2-3-Install Tool step 1 - defining user and password

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):

Image 5: TYPO3 1-2-3-Install Tool step 2 - defining the database

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":

Image 6: TYPO3 1-2-3-Install Tool step 3 - importing 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:

Image 7: Typo3 1-2-3 Install Tool was finished

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:

Image 8: Install Tool - first page

Click the link "All Configuration" for doing a change related to the used version of Freetype/2:

Image 9: Install Tool - All Configuration

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":

Image 10: Install Tool - All Configuration - TTFdpi

At the bottom of this page you will find the button "Write to localconf.php", please click it and you're ready:

Image 11: Storing your changes

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 ...

Image 12: puh, finished installation ...

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!

Image 13: The homepage of the big feet in the prettiest grass-green!

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:

 

Images

Parties

Lost and found

Club Member message board

 

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 ...

 

Let's quote Kasper: Hallelujah, it works!

 

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:

Quickstart-Getting Started (english, online),

Quickstart-Getting Started (english, OpenOfficeDocument, 3.2 MB),

Quickstart-Getting Started (english, PDF, 5.8 MB),

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:

"TYPO3 goes eComStation" is really working!

 

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)

 

Do we have forgot something?

Yes, to translate this documentation in other languages

- French,

- Dutch,

- Spanish,

- Italian and

- Russian,

but the question was:

Who will do that jobs?

 

After that piece of work it is time to thank those people who helped Michael and me to guide this project to success:

	to Michael's wife Petra and his family, to Anja and my family, without their support it would not have been possible to create "TYPO3 goes eComStation"
	to Ruben Schmalenberg for his graphical support around our logo,
	to Paul Smedley for his work not only related to ImageMagick/2,
	to Andreas Roederer for his proof-reading and proposals,
	to Bob St. John (Serenity Systems) and Kasper Skaarhoj (TYPO3 Association) for their moral support of our endeavourness,
	to the clubs TeamOS/2 Ruhr e.V. and Team Köln/Bonn e.V. for to have endured our testballoons and to keep us in work
	and to all those we forgot to mention individual ...

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

          Startseite  TYPO3 goes eComStation  + TYPO3 goes OS/2 (en)