NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================
A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package
The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.
In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:
/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.1/ # the untared 4.1 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.1
/typo3_src --> ../typo3_src-4.1/ # a symlink to the 4.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.
STEP BY STEP
============
1 Get the TYPO3 source package and the TYPO3 dummy package.
2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)
3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz
4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms
5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/
5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads
... where <wwwserver> is the name of the group your webserver
is running as
5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!
Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads
6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")
7 In your browser, visit
http://[your.site.name]/cms/
8 Follow the instructions in the 1-2-3 install tool
9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".
That's it :-)
INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================
1 Follow the steps 1-6 above.
2 Move the files in the cms/ folder up one level.
$ cd cms
$ mv * ../
$ cd ../
3 Update the symlink
$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src
4 Now TYPO3 runs in http://[your.site.name]/
That's it :-)