Club Drupal

Ce tutoriel à été écrit par [[François Martignon]] comme première ébauche pour un tutoriel complet et a permis à [[ismaeil Abouljamal]] de ne pas se lancer dans le projet multi-assos sans aucune aide initiale par celui qui a étudié les CMS existant et en a conclu que Drupal était le CMS adapté pour les besoin de Centrale marseille et le projet multiassos.

**Ce tutoriel n'est pas à jour et ne le sera pas**

''

Le tutoriel actualisé, complet et maintenu à jour par la team multi-assos est [[Utilisation de Drupal multi-site]]

''

----

Installation de Drupal sur le serveur de l'école

h2. Téléchargement

{{>toc}}

Il faut tout d'abord télécharger le fichier et le placer dans le dossier html :

Voici une manière pour les initier à UNIX

On télécharge le drupal sur le serveur :

* ssh login@sas1.ec-marseille.fr

* cd ~/html/

* wget http://ftp.drupal.org/files/projects/drupal-6.9.tar.gz

* tar -zxf drupal-6.9.tar.gz 

Eventuellement, 

* mv drupal-6.9 drupal pour renommer le dossier

On peut également télécharger le fichier et le dézipper dans le dossier html soit directement d'un PC de l'école ou avec Winscp.

h1. Installation

On lance l'installation en affichant la page 

http://perso.ec-m.fr/~fmartignon/drupal sous Firefox (ec-m.fr pour être sur le nouveau serveur, qui supporte mieux Drupal)

dans votre navigateur préféré. L'installation se lance.

On entre un nom pour le site...

Quand il est demandé de faire la copie de settings.php, on peut le réaliser en ligne de commande comme ceci :

cd ./drupal

cp ./sites/default/default.settings.php file ./sites/default/settings.php

h2. Paramétrage de la base de données :

Je donne l'exemple avec ma base de données nommée fmartignon

* Database name : multiassos

* Database user name : multiassos

* Database password : ..

* Advanced options:

* Database host : myweb.serv.int

* Table prefix : un prefixe parlant pour pas qu'on mélange les tables

* Le reste laissé vide

h2. Ajout du module LDAP

On installe le module LDAP ''(voici les paramètres que j'ai mis lors de la première installation. J'en modifierai sans doute ! )''

;Installation du module

Il faut télécharger le module et le dézipper dans le dossier module. Dans la console, en ligne de commande, ça donne :

* cd ./modules

* wget http://ftp.drupal.org/files/projects/ldap_integration-6.x-1.0-alpha2.tar.gz

* tar -zxf ldap_integration-6.x-1.0-alpha2.tar.gz 

;Activation du module LDAP

* On s'identifie comme admin

* "Site building" - "Modules" et on active "Authentification" dans "LDAP integration"

* Sauvegarder les modifications

;Paramètrage sur le compte admin

Dans "Site configuration", "LDAP authentication"

* LDAP Authentication

* Choose authentification mode : LDAP directory only

* LDAP UI Options : cocher Remove password

* Alter email field : remove email field

* Sauvegarder les modifications

;Ajouter un serveur ("Add Server")

* Name : annuaire_ECM

* LDAP server : ldaps://ldapr.egim-mrs.fr

* port : 389

* Login procedure : Base DNs: ou=People,dc=egim-mrs,dc=fr

* UserName attribute uid

* Email attribute : maillocaladdress

* DN for non-anonymous search: 

* uid=ginfo,ou=people,dc=egim-mrs,dc=fr

* Mot de passe du ginfo

;Paramétrer "User Management"

* Dans "User Settings", décocher : Require e-mail verification when a visitor creates an account

* Sauvegarder les modifications

On peut alors tester une authentification avec son compte de l'école.

h2. Ajout du module CAS

;Installation du module

* wget http://ftp.drupal.org/files/projects/cas-6.x-1.0.tar.gz

* tar -zxf cas-6.x-1.0.tar.gz 

;Activation du module CAS

* On s'identifie comme admin

* "Site building" - "Modules" et on active "cas" dans "Others"

* Sauvegarder les modifications

;Paramètrage sur le compte admin

Dans "Users management" - "Cas settings"

* CAS server : auth.ec-marseille.fr

* CAS port : 443

* CAS url : /cas

* CAS PEM certificate verification:

* Don't verify the certificat

* Cocher : Users canot change email address

* Cocher : Users canot change password

* Cocher : Should we extract the user email from an LDAP directory?

* Email attribute: maillocaladdress

* Sauvegarder les modifications

;Ajouter le bloc d'authentification cas sur le site

* Dans "Sites building" - "Blocks", chercher dans "Disable" "CAS User login" et le mettre par exemple en "left sidebar"

* Save blocks

On peut alors tester l'authentification CAS.

h2. Créer un sous-site

Voici un exemple pour comprendre la doc drupal, ''(à détailler)''

;Pour créer un sous site de http://perso.ec-m.fr/~fmartignon/drupal, appelé http://perso.ec-m.fr/~fmartignon/drupal/ssite1, faire :

* cd ~/html/drupal/

* ln -s . ./ssite1 (ça c'est pour créer un lien symbolique du sous-site1 vers le site principal)

* Ensuite on crée le dossier du sous-site. On le nomme fr.~fmartignon.drupal.ssite1 et on copie le fichier settings.php du dossier sites/defaults dedans.

* On modifie settings.php du dossier fr.~fmartignon.drupal.ssite1 comme ceci : 

* On change le préfixe pour utiliser d'autres tables dans la base : $db_prefix = 'db_ssite1_';

* On enlève le # devant $base_url et on complète $base_url = 'http://perso.ec-m.fr/~fmartignon/drupal/ssite1/';

* On sauvegarde le nouveau settings.php

* On va à l'adresse http://perso.ec-m.fr/~fmartignon/drupal/ssite1/install.php et l'installation se lance...

;Pour créer un sous site de http://ginfo.ec-marseille.fr/drupal/, appelé http://ginfo.ec-marseille.fr/drupal/bde, faire pareil. Le dossier à créer sera par exemple fr.drupal.bde et le prefixe $db_prefix = 'bde_';