Installation
******************************

Installation process of the ARET application:
============================================================

* check the server configuration
    * apache - enable mod_rewrite, mod_headers, mod_proxy, mod_proxy_http
    * php - install extension Alternative PHP Cache (APC). This step is optional, but APC significantly improves the speed of the application.
    * mysql - enable InnoDB support

* configure Apache (see :ref:`prodconfig`)
* copy the source files into the desired directory
* create symlinks from *mcTinyMceDragMathPlugin* to *bsTinyMcePlugin* (see :ref:`mctinymce` for more details)
* import MySQL database from dump
* configure access to database:
    * in the root directory (where the file "symfony" is located), create a file named "secret_settings.php", and write the database access information into it.

    .. code-block:: xml

        <?php
            bsConfig::set('database_server_doctrine_password', 'password');
            bsConfig::set('database_server_doctrine_username', 'username');
            bsConfig::set('database_server_doctrine_dsn', 'mysql:dbname=database_name;host=localhost');

            # this is now not required:
            bsConfig::set('database_server_mailbot_password', 'not_used');
            bsConfig::set('database_server_mailbot_username', 'not_used');
            bsConfig::set('database_server_mailbot_dsn', 'mysql:dbname=not_used;host=localhost');

* run the update script:

    .. code-block:: php

        php update_project.php

Apache server configuration
==============================

The application is intended to be run on its own domain, both on a local server (development version) and production server (public version).

Configuration example for local development:
------------------------------------------------

.. code-block:: xml

    <VirtualHost 127.0.1.2:80>
	ServerName ucebnice.zcu.czlocal    
	ServerAlias www.ucebnice.zcu.czlocal

	DocumentRoot /var/www/project_aret/trunk/web
	AccessFileName local.htaccess
	
	ProxyRequests Off
	<Proxy *>
	    AllowOverride all
	    Require all granted
	</Proxy>
	ProxyPass /proxy/tts http://tts.zcu.cz
	ProxyPassReverse /proxy/tts http://tts.zcu.cz

	<Directory /var/www/project_aret/trunk>
            DirectoryIndex frontend_local_dev.php                
	    Options Indexes FollowSymLinks                
	    AllowOverride All                
	    Require host localhost        
	</Directory>

	Alias /sf /var/www/project_aret/trunk/lib/vendor/symfony/data/web/sf  
	<Directory "/var/www/project_aret/trunk/lib/vendor/symfony/data/web/sf">   
	    AllowOverride All    
	    Require host localhost  
	</Directory>
    </VirtualHost>

The server is running on a local IP address 127.0.0.2, which is defined in the "hosts" file:

* Windows - c:\Windows\System32\drivers\etc\
* Linux - /etc/hosts

.. code-block:: xml

    ...
    127.0.0.2      ucebnice.zcu.czlocal
    127.0.0.2      www.ucebnice.zcu.czlocal
    ...


.. _prodconfig:

Configuration example for production version:
------------------------------------------------

.. code-block:: xml

    <VirtualHost *:80>
            ServerName ucebnice.zcu.cz
            ServerAlias www.ucebnice.zcu.cz

            DocumentRoot /var/www/project_aret/trunk/web
            Options FollowSymLinks

            ErrorLog /var/log/apache2/error_ucebnice.log

            # Possible values include: debug, info, notice, warn, error, crit,
            # alert, emerg.
            LogLevel warn

            CustomLog /var/log/apache2/access_ucebnice.log combined

            # zapne APC cache, nutne mit toto php rozsireni nainstalovane
            php_admin_value apc.enabled 1
            # vypne testovani zmeny php souboru, zrychleni o min. 20%
            php_admin_value apc.stat 1

        ProxyRequests Off

        <Proxy *>
        Order deny,allow
        Allow from all
        </Proxy>

        ProxyPass /proxy/tts http://tts.zcu.cz
        ProxyPassReverse /proxy/tts http://tts.zcu.cz
    </VirtualHost>



Contents:

.. toctree::
    :maxdepth: 1

    apps/apps
    config/config
    plugins/plugins