====== Installing and Configuring Typo3 ======




====Installing Typo3====


Typo3 is a cms based on LAMP. I may at some point explain how to install Typo3 itself, but it is also documented on the Typo3 website ([[http://typo3.org/|http://typo3.org]]) and in various documents which you can also find on this and other websites).

Here's some info about installing the prerequisite software on a Debian box: [[http://wiki.typo3.org/index.php/Running_GIF_enabled_packages_on_Debian_Woody#Optional_tuning:_Installing_.22turck-mmcache.22.|Running GIF enabled packages on Debian Woody]]. Be warned though that turck-mmcache does not seem to work under Debian Sarge.

====Configuring for a Typo3 website====
  -From the directory holding the root-directory of you site, create a symlink to the source folder. This source folder is here:
<code c>
[root@1038 solin]# cd /usr/var/shared/typo3_src-3.7.0
[root@1038 typo3_src-3.7.0]# pwd
/usr/var/shared/typo3_src-3.7.0
</code>


Call the symlink 'typo3_src':

<code c>
[root@1038 solin]# ln -s /usr/var/shared/typo3_src-3.7.0 typo3_src
</code>


This should be the result:

<code c>
lrwxrwxrwx  1 root  root    31 Feb 22 10:40 typo3_src -> /usr/var/shared/typo3_src-3.7.0
</code>


  -In the root of your site, create symlinks for t3lib/, tslib/ and typo3/ main-folders to the main-folders in the newly created 'typo3_src' symlink in the parent folder:
<code c>
[root@1038 public_html]# ln -s ../typo3_src/t3lib/
[root@1038 public_html]# ln -s ../typo3_src/tslib/
[root@1038 public_html]# ln -s ../typo3_src/typo3/
</code>

NOTE: at looks as though tslib is no longer present in typo3 4.0.2

(If the symlink name is the same as the target directory name, you can omit this argument) 

This should result in something like the following directory listing:

<code c>
lrwxrwxrwx  1 root  root    19 Feb 22 10:47 t3lib -> ../typo3_src/t3lib/
lrwxrwxrwx  1 root  root    19 Feb 22 10:48 tslib -> ../typo3_src/tslib/
lrwxrwxrwx  1 root  root    19 Feb 22 10:48 typo3 -> ../typo3_src/typo3/
</code>


  -Now, once more in the root of your site, create symlinks to tslib/media/, tslib/showpic.php and tslib/index_ts.php (call this one 'index.php'):
<code c>
[root@1038 public_html]# ln -s tslib/index_ts.php index.php
[root@1038 public_html]# ln -s tslib/media/
[root@1038 public_html]# ln -s tslib/showpic.php showpic.php
</code>

NOTE: in Typo3 4.0.2 this is no longer possible, because there is no tslib directory!

Which should result in this directory listing:

<code c>
lrwxrwxrwx  1 root  root    18 Feb 22 10:53 index.php -> tslib/index_ts.php
lrwxrwxrwx  1 root  root    12 Feb 22 10:54 media -> tslib/media/
lrwxrwxrwx  1 root  root    17 Feb 22 10:55 showpic.php -> tslib/showpic.php
drwxr-xr-x  2 solin solin 4096 Jan 13 11:24 stats
lrwxrwxrwx  1 root  root    19 Feb 22 10:47 t3lib -> ../typo3_src/t3lib/
lrwxrwxrwx  1 root  root    19 Feb 22 10:48 tslib -> ../typo3_src/tslib/
lrwxrwxrwx  1 root  root    19 Feb 22 10:48 typo3 -> ../typo3_src/typo3/
</code>


4. Prepare the local directories and files. In your webroot, make the fileadmin, typo3temp, uploads and typo3conf directories:

<code c>
[root@1038 public_html]# mkdir fileadmin
[root@1038 public_html]# mkdir typo3temp
[root@1038 public_html]# mkdir uploads
[root@1038 public_html]# mkdir typo3conf
</code>


These directories must be writeable, so do (for instance):



<code c>
[root@1038 public_html]# chmod 775 typo3temp
</code>




  -Finally, make a localconf.php file in the typo3conf directory. Typically a localconf.php file could look like this:


<code oobas>

<?php

    // Setting the Install Tool password to the default 'joh316'
$TYPO3_CONF_VARS['BE']['installToolPassword'] = 'bacb98acf97e0b6112b1d1b650b84971';
    // Setting the list of extensions to BLANK (by default there is a long list set)
$TYPO3_CONF_VARS['EXT']['extList'] = 'install';
$TYPO3_CONF_VARS['EXT']['requiredExt'] = 'lang';

    // Setting up the database username, password and host
$typo_db_username = 'root';
$typo_db_password = 'nuwr875';
$typo_db_host = 'localhost';

## INSTALL SCRIPT EDIT POINT TOKEN - all lines after this points may be changed by the install script!

$typo_db = 't3_coreinstall';    //  Modified or inserted by Typo3 Install Tool.
$TYPO3_CONF_VARS['SYS']['sitename'] = 'Core Install';    //  Modified or inserted by Typo3 Install Tool.
// Updated by Typo3 Install Tool 14-02-2003 15:20:04
$TYPO3_CONF_VARS['EXT']['extList'] = 'install,phpmyadmin,setup,info_pagetsconfig';       // Modified or inserted by Typo3 Extension Manager. 
// Updated by Typo3 Extension Manager 19-02-2003 12:47:26
?>
</code>


But if you already have a localconf.php file for another website on the same server, copy that one, as it will contain the correct database settings!



This is strictly speaking not a configuration issue, but if you copy any (typoscript based) templates from other website, **please make sure that the **//**automaketemplate**//** extension is loaded!**