Installing
From Tangra Framework Wiki
Contents
|
Installation using release package
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 Installation "from svn" export/checkout.
Prerequisites
- Web server up and running (preferable apache)
- PHP5 up and running (preferable 5.2+) with extensions (at least):
- mysql / mysqli
- session
- mbstring
- MySQL 5.x with INNODB
- Tangra Framework all-in-one package tangra_framework_aio_buildXXX.zip/tar.gz/bz2 (download)
Installation
Step 1: Unpacking
Unpack tangra_framework_aio_buildXXX.zip/tar.gz/bz2 where your sites normally reside.
For sake of examples we will use /var/www/sites/
Example:
Linux/*BSD/*nix*
~$cd /var/www/sites/ ~$tar xzvf tangra_framework_aio_buildXXX.tar.gz
Unpacking will create directory tangra2/.
Full path to tangra2/ directory will be referred later as tangra-root-dir.
Windows
Use WinZip or whatever archiver you use and extract the content of package in your directory for sites.
Step 2: Create VirtualHost
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:
Example:
<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.
Reload Apache
Linux/*BSD/*nix*
Please consult you distribution documentation how to reload Apache.
Here are 2 examples:
Debian:
#/etc/init.d/apache2 reload
other linux: apachectl restart
Windows
Start -> Programs -> Apache HTTP Server x.x.x -> Control Apache Server -> Restart
Step 3: Make scratch directory writable
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.
Linux/*BSD/*nix*
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_buildXXX.* 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
This configuration is recommended for multiuser environments (e.g. team working on same server/project). For more information see Typical user environment configurations.
Alternative solution:
- chgrp -R www-data tangra-root-dir/tcc/scratch
- chmod -R 775 tangra-root-dir/tcc/scratch
Where www-data is the apache user.
Windows
Navigate to tangra-root-dir/tcc/, open properties for scratch directory and uncheck read-only checkbox in Attributes section on "General" tab. Click OK and then when asked choose "Apply changes to this folder, subfolder and files" and click OK.
Step 4: Open and follow TCC installation wizard
Start a browser and point it to http://tcc.myhost/install/ where tcc.myhost is the virtual host that you configured in "Step 3: Create and test VirtualHost"
You should see installer page with the Tangra logo and title "Installing Tangra Control Center".
Follow the wizard.
OK, it is installed. Now what?
Information how to proceed after installation is found in Quick start.
Installation "from svn" export/checkout
TODO
