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 Configuration example for production version:)

• copy the source files into the desired directory

• create symlinks from mcTinyMceDragMathPlugin to bsTinyMcePlugin (see mcTinyMceDragMathPlugin 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.

  <?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:

  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:

<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:WindowsSystem32driversetc
• Linux - /etc/hosts

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

Configuration example for production version:

<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:

• /apps
• /config
• /plugins