wiki:DevelopersKarameloInstall

---------------------------------------------

KARAMELO e-LEARNING PLATFORM

by Chipotle Software

www.chipotle-software.com

-----------------------------------------------

In this instructions I suppose webserver home is in /var/www so Karamelo home will be "/var/www/karamelo/app" and CakePHP "/var/www/karamelo/cake". Karamelo only runs on PHP5, help us to give PHP4 a quick, painless death!! BTW, thx for download Karamelo!


INSTALLATION


1) You will need this packages:

Apache (You can use lighttpd, nginx or whatever you want but that options are not cover in this document) Rewrite module for Apache PHP version 5.2 or later Postgresql 8.3 or later MySQL 5.0 or later GD2 graphics libraries for PHP5

On Debian/Ubuntu?:

$sudo apt-get install apache2 libapache2-mod-php5 php5-mysql mysql-server php5-gd

On OpenSuSE:

$sudo yast2 -i apache2 php5 php5-mysql mysql php5-gd

On NetBSD use pkgsrc. OpenBSD users should use pkg_add.

On Windows: mmmmm, no Windows version yet :-)

In apache2 be sure "rewrite" and "php5" modules are enabled:

$sudo a2enmod rewrite
$sudo a2enmod php5

2) In /var/www/ get and uncompress Karamelo:

$wget ftp://chipotle-software.com/pub/karamelo/karamelo-0.x.x.tar.bz2

$tar -jxvf karamelo-0.x.x.tar.bz2

This package NOT include CakePHP 1.3. Please get CakePHP framework from  http://cakephp.org

4) Edit Apache to setup the DocumentRoot? on /var/www/karamelo/app/webroot. If you are using VirtualHost? you should have something like:

<virtualhost 49.12.19.27:80>
    ServerAdmin admin@mycollege.edu
    ServerName karamelo.mycollege.edu
    DocumentRoot /var/www/app/webroot
    ServerAlias karamelo.mycollege.edu

    <Directory /var/www/karamelo/app/webroot>
         Options Indexes FollowSymLinks MultiViews
         AllowOverride All
         Order allow,deny
         Allow from all
    </Directory>
    ###LOGS
    ErrorLog /var/log/apache2/error.log    
    LogLevel warn    
    CustomLog /var/log/apache2/access.log combined
</virtualhost>

Note: indication "AllowOverride?" should be "All"

5) Apache user ("nobody" on RedHat?/CentOS, "www-data" on Debian/Ubuntu?) must have permissions to write in some directories. If Apache user is actually installing Karamelo go to step six, but if user is different:

$chmod -R o+w karamelo/app/tmp
$chmod -R o+w karamelo/app/webroot/imgusers
$chmod -R o+w karamelo/app/webroot/files

6) Restart apache:

$sudo /etc/init.d/apache2 restart

7) Go to  http://your.ip.sever or maybe  http://localhost and fill the forms.

8) Login in

9) Go to ControlPanel?->Users->Groups and modify the groups secret codes.

Enjoy!

Karamelo Team

Note you should change values to:

  • file_uploads
  • upload_max_filesize
  • max_input_time
  • memory_limit
  • max_execution_time
  • post_max_size

in your php.ini file and set:

LimitRequestBody 0

in the apache2.conf config file in order to allow teachers upload podcasts and/or big movies or big presentations.


HELP & SUPPORT


Join Karamelo developers team:  http://trac.chipotle-software.com

Or ask for support:  http://www.chipotle-software.com