Howto to install TYPO3 4.2.0 on SUSE Linux 10.2 32bit for multiple domains

The goal of this howto is to set up a single TYPO3 source installation where multiple domains can refer to. Means if there are more than one domain or subdomain hosted on the server using TYPO3 they can easily access the source installation by symlink. So in case of updates or new TYPO3 releases it is much more comfortable to administrate the whole TYPO3 stuff. In Addtion to the sources we will also install some serverside programs which are used by TYPO3.

This howto is based on:
• STRATO HighQ-Server running SUSE Linux 10.2 32bit
• Plesk 8.3.0
• TYPO3 4.2.0
• ImageMagick 6.2.3.0
• htmldoc 1.8.27
• Xpdf 3.02
• Catdoc 0.93.4

Howto index:
1. Install TYPO3 sources
2. Install TYPO3 on a domain
3. TYPO3 Install Tool
4. Configure TYPO3
5. Postinstallation steps

Ok. Lets start with TYPO3 source and additional software installation.

1. Install TYPO3 sources

• Prepare source directory

  Login to your server as root and change to directory /srv/www. Here we want to install the souces.

• Get TYPO3 Source

  You can download the source from http://typo3.org/download/packages/.

  $ wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.2.0.tar.gz?download

• Unpack the source

  A source directory will be created. » ‘typo3_src-4.2.0′ « This is what we now call the TYPO3 sources in this howto.

  $ tar -xzvf typo3_src-4.2.0.tar.gz

• Grant access to the sources

  The apache user ‘wwwrun’ must have full access to the TYPO3 installation. For the webserver administration plesk is used. Per default umask the sources are untared with the group ‘psacln’ which is the group containing all plesk client. Now it’s better to add the group ‘psacln’ to user ‘wwwrun’ so we’re save that everything works fine with plesk at the end. We do the user/group administration by calling yast:

  $ yast2

  (The following screenshots will show up with german language settings. Sorry for that. But I don’t want to switch it to english only for this howto.)
  Well. When the yast frontend comes up go to “Security and Users > add or manage users”.
  

  Change the Filter (ALT+F) to show up all ‘System users’.
  Scroll down to user ‘wwwrun’.
  Go to ‘Details’ of user ‘wwwrun’.
  Now switch to ‘Groups’ with ALT+G.
  Add group ‘psacln’.

  

  

  Save and Exit yast.

  Now change owner and group to TYPO3 source folder:

  $ chown -R wwwrun:psacln ./typo3_src-4.2.0

• Permission for extension directory

  The directory ‘/typo3_src-4.2.0/typo3/ext’ needs to be full accessible by the webserver.

  $ chmod -R 775 ./typo3_src-4.2.0/typo3/ext

• Install ImageMagick

  On Suse 10.2 we can do this using yast. In yast go to ‘Software > install or delete software’.
  Then type ALT+F and search for ‘imagemagick’.
  Request install for ‘ImageMagick’.
  
  Install and exit.
  The executables can be found under /usr/bin/. TYPO3 will need them for image creation and rendering.

• Prepare directory for additional software

  Create another director located at the same root as the sources for the additional software needed. Let’s call it ‘typo3_progs’:
  $ mkdir typo3_progs
$ cd typo3_progs

• Install HTMLDOC

  HTMLDOC is used for character encoding in combination with the TYPO3 PDF Generator Plugin. We need that to get proper german special characters. Get the latest version from http://www.htmldoc.org/software.php.
  $ wget http://ftp.rz.tu-bs.de/pub/mirror/ftp.easysw.com/ftp/pub/htmldoc/1.8.27/htmldoc-1.8.27-source.tar.gz
$ tar -xzvf htmldoc-1.8.27-source.tar.gz
$ cd htmldoc-1.8.27
$ ./configure --prefix=/srv/www/typo3_progs/htmldoc-1.8.27
$ make
$ make install
$ cd ..
$ chown -R wwwrun:psacln ./htmldoc-1.8.27
$ chmod -R 775 ./htmldoc-1.8.2Done.
  When you install the TYPO3 PDF Generator Plugin you have to reference the installation path of htmldoc: ‘/srv/www/typo3_progs/htmldoc-1.8.27′

• Install Xpdf

  To get pdf-files indexed by the Indexed Search Engine Plugin you need to install Xpdf which contains the neccessary tools pdftotext and pdfinfo. You can get the sources from http://www.foolabs.com/xpdf/download.html.
  Go to the ‘typo3_progs’ directory and:

  $ wget ftp://ftp.foolabs.com/pub/xpdf/xpdf-3.02.tar.gz
$ tar -xzvf xpdf-3.02.tar.gz
$ cd xpdf-3.02
$ ./configure --prefix=/srv/www/typo3_progs/xpdf-3.02 --enable-a4-paper --with-appdef-dir=/srv/www/typo3_progs/xpdf-3.02
$ make
$ make install
$ cd ..
$ chown -R wwwrun:psacln ./htmldoc-1.8.27
$ chmod -R 775 ./htmldoc-1.8.27Done.
  The excutables pdftotext and pdfinfo are located in /srv/www/typo3_progs/xpdf-3.02/bin. This should be the path you have to point to in the Indexed Search Engine Configuration.

• Install Catdoc

  Catdoc is also needed for Indexed Search Engine. Get the sources from http://site.n.ml.org/info/catdoc/.
  Go to the ‘typo3_progs’ directory and:
  $ wget http://site.n.ml.org/download/20050502044842/catdoc/catdoc-0.93.4.tar.gz
$ tar -xzvf catdoc-0.93.4.tar.gz
$ cd catdoc-0.93.4
$ ./configure --prefix=/srv/www/typo3_progs/catdoc-0.93.4 --disable-wordview --disable-langinfo --with-input-charset=8859-15 --with-output-charset=8859-15
  To get Catdoc working with german special characters you have to modify config.h in directory ‘/src/’ using vi editor.
  Change the values for SOURCE_CHARSET und TARGET_CHARSET. Replace them with: ‘8859-15′.
  $ make
$ make install
$ cd ..
$ chown -R wwwrun:psacln ./catdoc-0.93.4
$ chmod -R 775 ./catdoc-0.93.4
  Done.
  The excutables pdftotext and pdfinfo are located in /srv/www/typo3_progs/catdoc-0.93.4/bin. This should be the path you have to point to in the Indexed Search Engine Configuration.

The TYPO3 sources and additional software is now installed. The TYPO3 sources now can be used by multiple TYPO3 domains!

Next chapter: Install TYPO3 on a domain