====== Gandi AI Tutorials ======












===== CMS ======

  * [[en:hosting:using-linux:tutorials:gandiai:ezpublish|Installing eZ Publish on Gandi AI]]
  * [[en:hosting:using-linux:tutorials:gandiai:joomla|Installing Joomla! on Gandi AI]]
  * [[en:hosting:using-linux:tutorials:gandiai:spip]]


===== E-Commerce =====
  * [[en:hosting:using-linux:tutorials:gandiai:oscommerce|Installing osCommerce on Gandi AI]]

===== Groupware =====
  * [[en:hosting:using-linux:tutorials:gandiai:ovidentia|Installing Ovidentia on Gandi AI]]










===== Subversion =====
  * [[en:hosting:using-linux:tutorials:gandiai:subversion|Use Subversion with Gandi AI]]

===== Programming =====

  * [[en:hosting:using-linux:tutorials:gandiai:deploying-rails-applications|Deploying a Ruby on Rails application with Gandi AI]]

===== Quit Gandi AI to install a SSL virtualhost on Apache2 =====

You will have to use another MPM (Apache connections manager) than PerUser which is used by default in Gandi AI, PerUser can not yet support SSL.

I suggest you to use the Prefork MPM which is the one by default in Apache2, type the following command in order to do this : aptitude (or apt-get) install apache2-mpm-prefork.

You will have to adapt the rights/permissions of the documentroot of your virtualhost regarding the Apache configuration.

===== Create a virtualhost and an FTP user after quitting Gandi AI (if you always use PerUser) =====

Log in on your VPS using SSH and the 'admin' system user, then type the "su -" command ("-" allows to use the root environnement variables for information).

Go in the virtualhosts configuration folder :
<code>cd /etc/apache2/sites-available/</code>

Copy a virtualhost :

<code>cp 000-www.example.net 001-www.domain.tld</code>

Modif it using your prefered editor:
<code>nano/emacs/vim/... 001-www.domain.tld</code>

Configure the necessary options:
<code>
<VirtualHost *:80>
	ServerName 	www.domain.tld
	ServerAlias     domain.tld
	ServerAdmin	webmaster@domain.tld

	DocumentRoot "/srv/d_data/www/www.domain.tld/htdocs"
    <Directory "/srv/d_data/www/www.domain.tld/htdocs">
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>

    ScriptAlias /cgi-bin/ /srv/d_data/www/www.domain.tld/cgi-bin/
    <Directory "/srv/d_data/www/www.domain.tld/cgi-bin/">
        AllowOverride None
        Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
        Order allow,deny
        Allow from all
    </Directory>

    ErrorLog /srv/d_data/www/www.domain.tld/logs/www.domain.tld-error.log
    LogLevel error
    SetEnvIf Remote_Addr "127\.0\.0\.1" loopback
    CustomLog /srv/d_data/www/www.domain.tld/logs/www.domain.tld-access.log combined env=!loopback
    ServerSignature On

    <IfModule mod_dav.c>
        DAVLockDB /srv/d_data/www/www.domain.tld/db/DAVLock
    </IfModule>

    <IfModule mpm_peruser_module>
        ServerEnvironment userftp_www-userftp
        MaxProcessors 20
    </IfModule>

    Include /etc/apache2/sites-includes/www.domain.tld/
</VirtualHost>
</code>


Create folders & files needed for this vhost :
<code>
mkdir /etc/apache2/sites-includes/www.domain.tld/

mkdir /srv/d_data/www/www.domain.tld/
mkdir /srv/d_data/www/www.domain.tld/htdocs/
mkdir /srv/d_data/www/www.domain.tld/logs/
mkdir /srv/d_data/www/www.domain.tld/db/
mkdir /srv/d_data/www/www.domain.tld/cgi-bin/

touch /srv/d_data/www/www.domain.tld/logs/www.domain.tld-access.log
touch /srv/d_data/www/www.domain.tld/logs/www.domain.tld-error.log

</code>

Then the FTP user and its group :
<code>
adduser userftp
addgroup www-userftp
adduser admin www-userftp
adduser userftp www-userftp
adduser www-data www-userftp
</code>

Give rights on folders & files to the FTP user :
<code>
chown -R userftp:www-userftp /srv/d_data/www/www.domain.tld/
</code>

Modify the root folder for the FTP user and its default shell :
<code>
userftp:x:1002:1002::/srv/d_data/www/www.domain.tld/:/bin/false
</code>

Activate the vhost & restart Apache :

<code>
a2ensite 001-www.domain.tld
/etc/init.d/apache2 restart
</code>