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

2. Install TYPO3 on a domain

We’ll now install TYPO3 on a domain or subdomain. For this howto I use a subdomain. But everything is the same as installing TYPO3 on a normal domain, except of symlinking to the sources. I’ll point this out when we do the symlinking.

• Requirements

  For the installation you need:

  1. a domain
  2. a clean mysql database
  3. TYPO3 dummy package

• Install the TYPO3 dummy package

  Go to the ‘/httpdocs’ directory of your domain and wget the dummy package.
  $ wget http://prdownloads.sourceforge.net/typo3/dummy-4.2.0.tar.gz?download
$ tar -xzvf dummy-4.2.0.tar.gz
$ mv ./dummy-4.2.0/* ./
  Now the dummy package is installed on your domain. You can remove the directory ‘/dummy-4.2.0′ and the dummy package from ‘/httpdocs’.

• Point symlink to TYPO3 sources

  Ok, thats the interesting part now. Now point the symlink ‘typo_src’ to the centralized sources we installed before using absolute paths. You need to rename or delete the original ‘typo3_src’ symlink first.
  $ rm -rf ./typo3_src
$ ln -s /srv/www/typo3_src-4.2.0 typo3_src

  Be sure you got the correct location for you sources referenced by the symlink. It depends on your TYPO3 source installation directory!!!

• Change Permission on TYPO3 domain directories

  The following directories have to be fully accessible by the webserver:

  • fileadmin
  • typo3conf
  • typo3temp
  • uploads

  Go to ‘/httpdocs’:
  $ chown -R wwwrun:psacln fileadmin typo3conf typo3temp uploads
$ chmod -R 775 fileadmin typo3conf typo3temp uploads

• Enable TYPO3 Install Tool

  To enable the Install tool, just create a file called ‘ENABLE_INSTALL_TOOL’.
  $ cd typo3conf
$ touch ENABLE_INSTALL_TOOL
$ chown wwwrun:psacln ENABLE_INSTALL_TOOL
$ chmod 775 ENABLE_INSTALL_TOOL

  When your installation is done, it’s highly recommended to disable the install tool again. This can be done by simple renaming ENABLE_INSTALL_TOOL to DISABLE_INSTALL_TOOL or deleting the file!

• Create vhost.conf

  Because of open_basedir restrictions the sources aren’t accessible from within the domain. A Plesk configuration file need to be created. I must contain the following options:

  <Directory /srv/www/vhosts/your_domain/httpdocs>
  Options +FollowSymlinks +Indexes +Includes
  php_admin_flag safe_mode Off
  php_admin_flag safe_mode_gid On
  php_admin_value open_basedir "/srv/www/vhosts/your_domain/httpdocs:/tmp:/srv/www/typo3_src-4.2.0:/srv/www/typo3_progs"
  </Directory>
  

  It’s better to copy paste this code template into your local texteditor and upload it via ftp into the ‘httpdocs/conf/’ of your domain.
  !Attention!
  Filename hast to be: ‘vhost.conf’
  Location: ‘/httpdocs/conf/’. For this changes taking place you have to reconfigure the domain and restart the apache webserver!

  $ /usr/local/psa/admin/sbin/websrvmng --reconfigure-vhost --vhost-name=your_domain
$ rcapache2 restart

Now TYPO3 is set up on your domain and you can continue configure it using the TYPO3 Install Tool.

Next chapter: TYPO3 Install Tool