Installations from release package are intended to be used by users who don't want to experiment and just need stable "system". If you want to participate in Tangra Framework development or just want latest updates and bugfixes to reach you fast - please use the section called “Installation "from svn" export/checkout”.
PHP5 up and running (preferable 5.2+) with extensions (at least):
Tangra Framework all-in-one package tangra_framework_aio_buildYYYYMMDD.zip/tar.gz/bz2 (» download)
Unpack tangra_framework_aio_buildYYYYMMDD.zip/tar.gz/bz2 where your sites normally reside.
For sake of examples we will use /var/www/sites/.
$ cd /var/www/sites/ $ tar xzvf tangra_framework_aio_buildYYYYMMDD.tar.gz
Unpacking will create directory tangra2/. Full path to tangra2/ directory will be referred later as tangra-root-dir.
For creating virtual host please consult your Apache documentation. Here is an example how to create virtual host in Debian/GNU Linux:
In /etc/apache2/sites-available create file named tcc. Put the following in it:
<VirtualHost *:80> ServerAdmin user@somedomain.tld DocumentRoot tangra-root-dir/tcc/htdocs ServerName tcc.myhost ErrorDocument 404 /not_found.php </VirtualHost>
Replace user@somedomain.tld with your email.
Replace tangra-root-dir with your actual tangra root dir.
Replace myhost with hostname of your machine.
Scratch directory serves as a place where web server writes temporary files, logs, template engine precompiles, etc. In order to be able to do that it needs write privileges. Please note that all subdirectories in scratch have to be writable too (you will need recursive commands).
Scratch directory path is tangra-root-dir/tcc/scratch.
Simple and dirty way:
$ cd tangra-root-dir/tcc/ $ chmod -R 777 scratch/
Normal way (requires root privileges):
Let's suppose that your apache is running as www-data (which is standard for debian for example). Let's suppose that your user is myuser. After unpacking the tangra_framework_aio_buildYYYYMMDD.* package all files will be owned by you. Example:
$vdir /var/www/sites/tangra2 drwxr-xr-x 6 myuser myuser 4096 2007-03-08 00:14 tangra_lib drwxr-xr-x 6 myuser myuser 4096 2007-03-08 00:14 tangra_modules drwxr-xr-x 6 myuser myuser 4096 2007-03-08 00:14 tcc
Best solution is:
create new group called webdev
make your user and apache user members of webdev
# chgrp -R webdev tangra-root-dir/tcc/scratch
# chmod -R 775 tangra-root-dir/tcc/scratch
Alternative solution:
# chgrp -R www-data tangra-root-dir/tcc/scratch
# chmod -R 775 tangra-root-dir/tcc/scratch
Start a browser and point it to http://tcc.myhost/install/ where tcc.myhost
is the virtual host that you configured in the section called “Step 2: Create VirtualHost”
You should see installer page with the Tangra logo and title "Installing Tangra Control Center".
Follow the wizard.