Projet

Général

Profil

Utilisation de Drupal multi-site » Historique » Version 66

Julien Enselme, 05/12/2014 23:30
Correction complément (work in progress)

1 1 Julien Enselme
h1. Création d'un sous site
2 58 Julien Enselme
3 58 Julien Enselme
{{>toc}}
4 1 Julien Enselme
5 2 Julien Enselme
NB : pour créer un site (entre autres), vous aurez besoin de vous connecter au compte assos en ssh. Pour cela utilisez soit le terminal (<code> ssh assos@sas1.centrale-marseille.fr</code>) soit une interface graphique (cf "les tuto sur le site du Ginfo":http://assos.centrale-marseille.fr/ginfo/content/linux-avoir-acc%C3%A8s-%C3%A0-mon-r%C3%A9pertoire-depuis-chez-moi).
6 1 Julien Enselme
7 1 Julien Enselme
h2. Méthode Drupal 7
8 1 Julien Enselme
9 63 Florent Torregrosa
{{important(La méthode est susceptible de changer régulièrement à cause des redirections variées. Lire le paragraphe suivant et voir avec le CRI (dgeo) si la méthode est périmée. Pensez également à tenir le script de création de site à jour.)}}
10 1 Julien Enselme
11 20 Julien Enselme
h3. Création du site drupal 7
12 1 Julien Enselme
13 55 Julien Enselme
# Vérifier qu'il n'y a pas de fichiers modifiés/ajoutés en attente avec @git status@
14 35 Julien Enselme
# Dans htmltest/sites créer un nouveau dossier nommé _assos.centrale-marseille.fr.nomdusite_. Le _nomdusite_ doit faire moins de 16 caractères et en pas contenir le caractère '-'. Ce sera ce qu'on appelle par la suite le dossier du site.
15 35 Julien Enselme
# Créer ce qu’il faut pour les sauvegardes :
16 53 Julien Enselme
## Créer deux dossiers pour les sauvegardes individiuelles (automatiques et manuelles)
17 53 Julien Enselme
## Créer trois fichiers de la forme @$d7_dir_individual_auto_backup/$dir_site_name/$current_date.$dir_site_name.sqlx@ pour que le script de purge des sauvegardes ne gueule pas.
18 53 Julien Enselme
## Par exemple :
19 41 Julien Enselme
<pre><code class="php">for i in {1..4} ; do
20 1 Julien Enselme
  touch auto/d7/assos.centrale-marseille.fr.camara/`date "+%Y-%m-%d-%Hh%Mm%Ss"`.assos.centrale-marseille.fr.camara.sql$i
21 1 Julien Enselme
done</code></pre>
22 1 Julien Enselme
# Se connecter sur phpmyadmin sur le serveur myassos (dans la liste déroulante) avec le login assos (le mdp est dans accessible via la forge).
23 35 Julien Enselme
# Créer une nouvelle base de donnée et un nouvel utilisateur nommés _nondusite_ via User > add user.
24 53 Julien Enselme
## Renseigner son nom.
25 53 Julien Enselme
## Générer un mot de passe aléatoire et le conserver (il est à renseigner dans le settings.php).
26 53 Julien Enselme
## Dans _database for user_, cocher _Create database with same name and grant all privileges_.
27 53 Julien Enselme
## Laisser toutes les autres options par défaut.
28 53 Julien Enselme
## Valider
29 43 Julien Enselme
# On configure le settings.php qui contient toutes les variables indispensables au bon fonctionnement de drupal.
30 53 Julien Enselme
## Copier-coller le fichier d7-settings.php (présent dans le dossier template) dans le dossier du site.
31 53 Julien Enselme
## Renommer ce fichier en settings.php (il contient seulement deux lignes de code. Elles importent le settings.global.php qui contient les infos communes à tous les sites et settings.local.php qui contient les infos spécifiques à chaque sites)
32 53 Julien Enselme
## Copier-coller le fichier d7-settings-local-template.php
33 53 Julien Enselme
## Renommer ce fichier en settings.local.php (il contient les infos sur la base de données)
34 53 Julien Enselme
## Remplacer %%DBUSER%%, %%DBNAME%% et %%SITE_NAME%% par _nomdusite_
35 53 Julien Enselme
## Remplacer %%DBPASS%% par le mot de passe généré ci-avant.
36 48 Julien Enselme
# Ajouter à la fin du fichier sites.php la ligne : @$sites['assos.centrale-marseille.fr.NOMDUSITE'] = 'assos.centrale-marseille.fr.NOMDUSITE@ ou si l’url est différente, remplacer le @'assos.centrale-marseille.fr.NOMDUSITE'@ de gauche par celle-ci.
37 48 Julien Enselme
# Ajouter dans le fichier ~/.drush/aliases.drushrc.php la ligne correspondant au site :
38 53 Julien Enselme
## dans 'site-list' : @'assos.centrale-marseille.fr/$site_name',@
39 53 Julien Enselme
## à la fin du fichier : @$aliases['$site_name'] = array('uri' => 'assos.centrale-marseille.fr/SITE_NAME', 'root' => '/users/guest/assos/htmltest/', );@
40 35 Julien Enselme
# Lancer l'installation du site en allant sur l'url : http://assos.centrale-marseille.fr/nomdusite/install.php Si la page obtenue affirme que le site est déjà installé, c'est qu'il y a une erreur dans les étapes précédentes : recommencer scrupuleusement.
41 35 Julien Enselme
# Choisir la langue (de préférence le français) et continuer l'installation en donnant un nom  pour le site (également configurable après) et en créant un compte pour l'administrateur.
42 36 Julien Enselme
# Lancer le script _d7-reset-variables.sh_ dans le dossier du site.
43 1 Julien Enselme
# Mettre les bons droits sur les dossiers/fichiers entrer ces commandes dans le répertoire htmltest/sites
44 53 Julien Enselme
## chmod -R 755 DOSSIER_DU_SITE
45 53 Julien Enselme
## chmod 400 DOSSIER_DU_SITE/settings.php
46 55 Julien Enselme
# Commiter les changements pour qu'ils soient pris en compte dans git : @git commit -a -m "Creation of site: $d7_site_name"@
47 35 Julien Enselme
48 55 Julien Enselme
49 52 Florent Torregrosa
{{tip(Des statistiques sont accessibles via https://piwik.centrale-marseille.fr/. Voir le club Drupal pour les accès. Si c'est un site d'association, voir avec dgeo pour créer un piwik id. Sinon, seuls les blogs avec du contenu et certains sites particuliers peuvent avoir droit à cet id.)}}
50 20 Julien Enselme
51 1 Julien Enselme
h3. Trucs à faire sur le site juste après l’ouverture du site drupal 7
52 1 Julien Enselme
53 20 Julien Enselme
* Conseiller à l'administrateur de ne pas laisser les inscriptions ouvertes à son site
54 1 Julien Enselme
* Donner à l'administrateur le lien des tutoriels écrits par le club Drupal
55 5 Julien Enselme
* Créer un contenu de type "Site" sur la page du projet multiassos
56 36 Julien Enselme
* Inscrire à la liste de diffusion webmasters@listes.centrale-marseille.fr
57 1 Julien Enselme
58 20 Julien Enselme
h2. Script de création de site drupal 7
59 1 Julien Enselme
60 1 Julien Enselme
Un script de création de site est également disponible sur le bureau de assos. Il prend le nom du site à créer en paramètre. Ensuite, suivez les instructions.
61 1 Julien Enselme
62 1 Julien Enselme
Concernant le fonctionnement du script, il doit respecter à la lettre la méthode précédente. Si ce n’est pas le cas, se renseigner sur la méthode à suivre et mettre à jour en conséquence. Voir les commentaires dans le script pour de plus amples informations.
63 1 Julien Enselme
64 6 Julien Enselme
h2. Quelques informations sur le pourquoi du comment
65 1 Julien Enselme
66 6 Julien Enselme
Si la méthode est périmée, voici quelques informations pour la réparer (se rapprocher de dgeo en cas de souci).
67 1 Julien Enselme
68 1 Julien Enselme
Lorsqu'un site est appelé avec l'url http://assos.centrale-marseille.fr/nomdusite, les actions suivantes sont effectuées :
69 6 Julien Enselme
* Se rendre dans html (ou htmltest) et chercher un dossier nommé _nomdusite_. C'est la raison pour laquelle il faut avoir un lien symbolique dans html nommé _nomdusite_.
70 1 Julien Enselme
* Si le dossier n'est pas trouvé, c'est foutu, sinon, rentrer dedans ; en l'occurrence, suivre le lien symbolique qui ramène vers ... html !
71 1 Julien Enselme
* Une fois dans ce dossier (donc toujours dans html), chercher un fichier <code>index.php</code>
72 1 Julien Enselme
* S'il n'est pas trouvé, c'est foutu, sinon le lire. En l'occurrence, ce fichier est présent dans html et créé par Drupal. On rentre donc dans le champ d'action de drupal
73 6 Julien Enselme
* Chercher dans l'installation drupal un dossier nommé assos.centrale-marseille.fr.nomdusite
74 6 Julien Enselme
* Si trouvé, rentrer dedans et lire le <code>settings.php</code>
75 6 Julien Enselme
* Si tout va bien, afficher le site :)
76 1 Julien Enselme
77 1 Julien Enselme
Les 4 premières sont dues à la structure du serveur fourni par le CRI (Le lien symbolique dans html n'est donc pas forcément nécessaire si on installe drupal sur un autre serveur par exemple).
78 1 Julien Enselme
79 1 Julien Enselme
Le reste est du domaine de drupal.
80 1 Julien Enselme
81 1 Julien Enselme
h1. Suppression d'un sous site
82 1 Julien Enselme
83 55 Julien Enselme
# Vérifier qu'il n'y a pas de fichiers modifiés/ajoutés en attente avec @git status@
84 37 Julien Enselme
# Supprimer la base de données du site et l’utilisateur dans phpmyadmin, via l’onglet _Users_ :
85 53 Julien Enselme
## Trouver l’utilisateur
86 53 Julien Enselme
## Dans _ Remove selected users_, cocher _Drop the databases that have the same names as the users._
87 53 Julien Enselme
## Valider
88 1 Julien Enselme
# Supprimer le dossier créé dans htmltest/sites en se redonnant les droits (si nécessaire)
89 49 Julien Enselme
# Supprimer la ligne du site dans le sites.php
90 37 Julien Enselme
# Supprimer les deux lignes du site dans .drush/aliases.drushrc.php
91 37 Julien Enselme
# Supprimer les sauvegardes de base données
92 53 Julien Enselme
** dans individual/auto/d7/NOM_DU_SITE
93 53 Julien Enselme
** dans individual/manual/d7/NOM_DU_SITE
94 7 Julien Enselme
# Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher _État du site_
95 55 Julien Enselme
# Commiter les changements pour qu'ils soient pris en compte dans git : @git commit -a -m "Deletion of site: $d7_site_name"@
96 37 Julien Enselme
97 37 Julien Enselme
{{note(Les utilisateurs se retirent eux même de la liste webmaster)}}
98 1 Julien Enselme
99 65 Julien Enselme
h1. Changer l'adresse d'un site existant
100 64 Benjamin Luce
101 66 Julien Enselme
h2. Renommer la base de données et le nom d'utilisateur de mysql
102 66 Julien Enselme
103 1 Julien Enselme
# Se connecter  sur phpMyAdmin via la page "Outils":https://outils.centrale-marseille.fr de l'école.
104 66 Julien Enselme
## Rentrer l'identifiant et le mot de passe
105 1 Julien Enselme
## Le serveur à choisir est myassos.
106 1 Julien Enselme
# Chercher le nom de site à changer dans le menu de gauche. On l'appellera Site1 pour plus de commodité. Site2 sera le futur nom du site.
107 66 Julien Enselme
# Aller dans privilège et supprimer l'utilisateur Site1 puis ajouter l'utilisateur Site2. Il faut générer un mot de passe et le copier précieusement le temps de toute de la manipulation.
108 66 Julien Enselme
# Il faut exécuter ensuite une requête SQL dans le menu du même nom : <code class="SQL">GRANT ALL PRIVILEGES ON Site2.* TO 'Site'@'%' IDENTIFIED BY 'Mot-de-passe-du-site'</code>.
109 66 Julien Enselme
110 66 Julien Enselme
h2. S'occuper de Drupal
111 66 Julien Enselme
112 1 Julien Enselme
# Ouvrir un terminal et se connecter sur webassos si ce n'est déjà fait.
113 66 Julien Enselme
# Renommer le dossier du site : @mv drupal7/sites/assos.centrale-marseille.fr/Site1 drupal7/sites/assos.centrale-marseille.fr/Site2@
114 66 Julien Enselme
# Mettre à jour le sites.php (dans drupal7/sites/sites.php).
115 66 Julien Enselme
** Remplacer Site1 par Site2.
116 66 Julien Enselme
# Mettre à jour les aliases drush (dans ~/.drush/aliases.drushrc.php).
117 66 Julien Enselme
** Remplacer Site1 par Site2
118 1 Julien Enselme
119 8 Julien Enselme
h1. Installation de module ou de thème
120 1 Julien Enselme
121 1 Julien Enselme
NB : du fait de l'installation en multi-site, un projet (module ou thème) installé est un projet installé pour **tous** les sites de l'installation.
122 1 Julien Enselme
123 1 Julien Enselme
Pour installer un projet uniquement pour un sous-site, il faut créer un dossier themes ou modules (selon le cas) dans le dossier du site, et effectuer l'installation dans celui-ci à la place du dossier all/modules.
124 1 Julien Enselme
125 20 Julien Enselme
Mais attention, cela rend le multi-site compliqué à maintenir, c'est donc à éviter à tout prix. Seuls certains cas très particuliers (et qui doivent être documentés pour qu'on en garde la trace) bénéficieront de ce traitement !
126 1 Julien Enselme
127 1 Julien Enselme
h2. Installation de module/thème à la main
128 1 Julien Enselme
129 1 Julien Enselme
* Se rendre sur le site officiel de Drupal sur la page du projet
130 1 Julien Enselme
* Télécharger la source
131 1 Julien Enselme
* L'extraire
132 1 Julien Enselme
* Placer le dossier extrait dans le dossier sites/all/modules ou sites/all/themes en fonction du cas
133 1 Julien Enselme
* **Si** le dossier extrait comprend un fichier INSTALL.txt, le lire et suivre les éventuelles étapes complémentaires
134 20 Julien Enselme
* Se connecter en tant qu'admin sur n'importe quel site du projet et vérifier que le nouveau module ou thème est installé.
135 1 Julien Enselme
136 31 Julien Enselme
h2. Installation de module/thème drush
137 8 Julien Enselme
138 1 Julien Enselme
[[drush|Quelques explications sur Drush avant ?]]
139 8 Julien Enselme
140 8 Julien Enselme
* Se rendre dans le dossier d'un site de l'installation via son terminal
141 1 Julien Enselme
* Taper la commande <code>drush dl projet</code> (où projet est le nom du thème ou module)
142 1 Julien Enselme
* Activer sur un site le nouveau module ou thème pour vérifier que ça marche bien <code>drush en projet</code>
143 1 Julien Enselme
144 1 Julien Enselme
h1. Suppression de module ou de thème
145 45 Julien Enselme
146 1 Julien Enselme
Pour cela, le plus simple est d'utiliser le script d7-all-drush.sh.
147 1 Julien Enselme
148 45 Julien Enselme
Il faut :
149 45 Julien Enselme
# désactiver le projet sur tous les sites : <code>d7-all-drush.sh dis projet</code>
150 33 Florent Torregrosa
# désinstaller le projet sur tous les sites (c'est-à-dire supprimer toutes les tables dans la base de données qui ont été créées par le projet) : <code>d7-all-drush.sh pm-uninstall projet</code>
151 1 Julien Enselme
# supprimer le dossier du projet dans le répertoire sites/all/modules ou sites/all/themes
152 1 Julien Enselme
# vérifier que le module n'avait pas besoin d'une librairie dans le répertoire sites/all/libraries, la supprimer si besoin.
153 1 Julien Enselme
154 27 Julien Enselme
h1. Mises à jour
155 9 Julien Enselme
156 27 Julien Enselme
{{warning(
157 1 Julien Enselme
Attention | Il ne faut jamais renommer les modules et thèmes en vue de les sauvegarder ! Les sauvegardes doivent toujours se faire à l'extérieur du répertoire accessible par web ! Il en est de même pour les sauvegardes des bases de données.
158 1 Julien Enselme
)}}
159 1 Julien Enselme
160 1 Julien Enselme
Les mises à jour permettent de conserver une version récente et maintenue du code utilisé. Elles doivent donc être faites aussi régulièrement que possible, surtout si elles corrigent des failles de sécurité. Un site qui n'est pas à jour est potentiellement un site vulnérable !
161 1 Julien Enselme
162 1 Julien Enselme
On distingue plusieurs types de mises à jour :
163 1 Julien Enselme
* les mises à jour de projet (projet = module ou thème)
164 1 Julien Enselme
* les mises à jour du noyau (core) de drupal
165 1 Julien Enselme
* les mises à jour majeures de drupal (migration)
166 9 Julien Enselme
* les mises à jour de la base de données : il s'agit en fait d'une étape dans les précédents types de mises à jour
167 1 Julien Enselme
168 1 Julien Enselme
NB : à l'exception des mises à jour de la base de données (qui sont faites uniquement dans les tables des sites concernés), les mises à jour faites pour un site sont valables pour tous les sites de l'installation : c'est le principe du multi-site ;)
169 1 Julien Enselme
170 9 Julien Enselme
h2. Mise à jour d'un module ou d'un thème
171 1 Julien Enselme
172 1 Julien Enselme
Pour notre installation drupal 7, il faudra effectuer quelque chose de similaire.
173 1 Julien Enselme
174 1 Julien Enselme
Voici tout de même les méthodes pour effectuer ces mises à jour.
175 20 Julien Enselme
Toujours privilégier la méthode drush, les autres sont présentes uniquement pour info (ou si drush est planté :p)
176 1 Julien Enselme
177 1 Julien Enselme
h3. Mise à jour d'un module ou d'un thème à la main
178 1 Julien Enselme
179 1 Julien Enselme
# Télécharger la nouvelle version du module ou du thème sur le site officiel et extraire le fichier sur le bureau du compte assos.
180 1 Julien Enselme
# Supprimer l'ancienne version dans /users/guest/assos/html/sites/all/modules.
181 1 Julien Enselme
# Copier la nouvelle version dans /users/guest/assos/html/sites/all/modules.
182 20 Julien Enselme
# Faire la mise à jour de la base de données
183 1 Julien Enselme
184 31 Julien Enselme
h3. Mise à jour d'un module ou d'un thème avec drush
185 1 Julien Enselme
186 1 Julien Enselme
[[Drush|Quelques explications sur Drush avant ?]]
187 1 Julien Enselme
188 1 Julien Enselme
Drush permet d'effectuer pour un site toutes les mises à jour des modules et des thèmes d'un seul coup.
189 9 Julien Enselme
190 9 Julien Enselme
Rappel :
191 50 Julien Enselme
* Pour effectuer cette opération sur tous les sites, remplacer drush par d7-all-drush.sh. Pour les sites drupal 7, remplacer d7-all-drush.sh par d7-all-drush.sh.
192 1 Julien Enselme
* Pour mettre un jour un site en particulier, se placer dans le dossier du site en question.
193 1 Julien Enselme
194 1 Julien Enselme
Voici comment procéder :
195 9 Julien Enselme
# se placer (dans un terminal évidemment) dans le dossier du site
196 9 Julien Enselme
# lancer la commande <code>drush -y en update</code> pour activer la mise à jour
197 9 Julien Enselme
# lancer la commande <code>drush upc --no-core</code>
198 9 Julien Enselme
# si une mise à jour de la base de données est requise, lancer la commande <code>drush -y updb</code>
199 29 Julien Enselme
# s'il y avait des mises à jour de thème, nettoyer le cache pour que les modifications soient prises en compte. Lancer la commande <code>drush cc all</code>
200 1 Julien Enselme
# lancer la commande <code>drush -y dis update</code> pour désactiver le module update
201 9 Julien Enselme
202 1 Julien Enselme
NB : la commande <code>drush up</code> permet d'effectuer upc et updb en une seule fois !
203 1 Julien Enselme
204 1 Julien Enselme
h2. Mise à jour du noyau de Drupal
205 59 Julien Enselme
206 1 Julien Enselme
Il s'agit par exemple de passer de drupal 7.X à drupal 7.Y
207 20 Julien Enselme
208 1 Julien Enselme
h3. Mise à jour du noyau de Drupal à la main
209 1 Julien Enselme
210 1 Julien Enselme
La méthode la plus complète est donnée dans le fichier UPGRADE.txt dans le dossier officiel de Drupal.
211 1 Julien Enselme
212 1 Julien Enselme
Voici tout de même une méthode un peu plus simple et qui a bien marché pour toutes les mises à jour depuis Drupal-6,9 jusqu'à Drupal-6,13
213 1 Julien Enselme
# Faire une sauvegarde complète (base de données et dossiers)
214 1 Julien Enselme
# Revenir au thème de base Garland (si ce n'est déjà pas le cas) le temps de transférer les mises à jours.
215 1 Julien Enselme
# On télécharge Drupal-6,13 à partir du site officiel http://drupalfr.org/ ou à partir du tableau de bord http://assos.centrale-marseille.fr/?q=admin/reports/status puis on décompresse le fichier.
216 9 Julien Enselme
# On copie tout le contenu du dossier "Sites" de Drupal-6,12, à savoir les dossiers "all" et "default" dans le dossier "Sites" de drupal-6,13, on écrasera donc les anciens dossiers "all" et "default" .
217 9 Julien Enselme
# Changer tout de suite les droits d'accès au fichier settings.php qui est dans sites/default en enlevant tout les droits d'accès à ce fichier (les droits maximum : 700 les droits minimun : 000). En fait le fichier sites/default/settings.php contient le mot de passe de la base de donnée il faut donc particulièrement faire attention aux droits d'accès de ce fichier.
218 9 Julien Enselme
# Copier le contenu du dossier _modules_ de Drupal-6,13 dans le dossier _modules_ de Drupal-6,12. De cette façon les modules de base de l'ancien drupal seront écrasés (et donc mis à jour) et on garde les modules complémentaires.
219 1 Julien Enselme
# Lancer le script de mise à jour de la base de données.
220 1 Julien Enselme
# Revenir au thème personnalisé du site (si ce n'est pas Garland).
221 1 Julien Enselme
# Supprimer CHANGELOG.TXT de l'installation
222 62 Julien Enselme
# Mettre à jour les settings.php
223 1 Julien Enselme
# Commiter les changements : @git add -A drupalX && git commit -m "Udpate to 7.xx"@
224 60 Julien Enselme
225 60 Julien Enselme
{{Important(Ne pas oublier de commiter les changements.)}}
226 59 Julien Enselme
227 20 Julien Enselme
h3. Mise à jour du noyau de Drupal avec drush (recommandé)
228 1 Julien Enselme
229 1 Julien Enselme
Drush permet aussi d'effectuer ce type de mise à jour.
230 1 Julien Enselme
231 54 Julien Enselme
Rappel :
232 1 Julien Enselme
* Pour effectuer cette opération sur tous les sites, remplacer drush par d7-all-drush.sh (d6-all-drush.sh pour drupal 6).
233 1 Julien Enselme
* Pour mettre un jour un site en particulier, se placer dans le dossier du site en question.
234 1 Julien Enselme
235 1 Julien Enselme
Pour ceci :
236 22 Julien Enselme
# Faire une sauvegarde complète (base de données et dossiers)
237 22 Julien Enselme
# Effectuer la mise à jour des projets
238 22 Julien Enselme
# Lancer la commande <code>drush -y en update</code> pour activer l'update sur tous les sites.
239 22 Julien Enselme
# Lancer la commande <code>drush upc drupal</code>
240 12 Julien Enselme
# Lancer <code>drush updb</code> pour faire la mise à jour de la base de données.
241 1 Julien Enselme
# Lancer la commande <code>drush -y dis update</code> pour désactiver l'update sur tous les sites.
242 39 Julien Enselme
# Penser à remettre la traduction en Français ! (Voir paragraphe ci-dessous [[Utilisation_de_Drupal_multi-site#Gestion-des-traductions-en-français|Gestion des traductions en français]])
243 62 Julien Enselme
# Mettre à jour les settings.php
244 60 Julien Enselme
# Commiter les changements : @git add -A drupalX && git commit -m "Udpate to 7.xx"@
245 60 Julien Enselme
246 39 Julien Enselme
{{Important(Ne pas oublier de commiter les changements.)}}
247 39 Julien Enselme
248 39 Julien Enselme
h3. Mise à jour des settings.php
249 39 Julien Enselme
250 39 Julien Enselme
À presque chaque version mineur de drupal, de nouvelles variables de configuration sont ajoutées au settings.php de drupal. Il faut se tenir à jour, dès lors que certaines de ces variables concernent la sécurité. Le dossiers de chaque site contient :
251 39 Julien Enselme
252 39 Julien Enselme
* settings.php : fichier qui contient toutes les variables communes à tous les sites, c’est lui que l’on va mettre à jour.
253 39 Julien Enselme
* settings.local.php : fichier qui contient les variables spécifiques à un site en particulier (information sur la base de données et base url). Hors cas particulier, il n’est jamais modifié.
254 39 Julien Enselme
255 39 Julien Enselme
Pour mettre à jour un settings.php, il faut :
256 39 Julien Enselme
# Récupérer le nouveau settings.php
257 39 Julien Enselme
# Comparer le nouveau et l’ancien (via diff, meld,…) : il faut en effet conserver les variables personnalisées de l’ancien et regarder ce qui change afin qu’on le prenne en compte.
258 53 Julien Enselme
# Supprimer du nouveau les informations spécifiques à un site :
259 53 Julien Enselme
** base_url
260 39 Julien Enselme
** Information de base de données
261 1 Julien Enselme
# Remplacer tous les settings.php (à la main ou via le scripts @d7-all-update-settings.sh@.
262 1 Julien Enselme
263 1 Julien Enselme
h2. Mise à jour Majeure
264 9 Julien Enselme
265 1 Julien Enselme
Une mise à jour majeure consiste à passer par exemple de drupal 6 à drupal 7. On parle aussi d'ugrade ou de migration.
266 1 Julien Enselme
Attention, c'est une tâche lourde qui nécessite de la préparation ! **beaucoup** de préparation (au moins 6 mois !)
267 1 Julien Enselme
Elle peut être particulièrement difficile si on possède beaucoup de projets, car s'ils existent pour drupal 6, ils ne sont pas forcément maintenus également en drupal 7 !
268 1 Julien Enselme
269 1 Julien Enselme
Voici la page de préparation de migration [[De Drupal6 vers Drupal7]]
270 1 Julien Enselme
271 1 Julien Enselme
272 1 Julien Enselme
h2. Mise à jour de la base de données
273 1 Julien Enselme
274 20 Julien Enselme
Lorsque la mise à jour d'un projet ou du noyau modifie la structure de la base de données, il faut en effectuer une mise à jour également.
275 1 Julien Enselme
276 1 Julien Enselme
h3. Mise à jour de la base de données avec drush
277 1 Julien Enselme
278 20 Julien Enselme
Il suffit de lancer, dans le dossier du site, la commande <code>drush updb</code>
279 1 Julien Enselme
280 1 Julien Enselme
h3. Mise à jour de la base de données à la main
281 1 Julien Enselme
282 1 Julien Enselme
Cette méthode utilise directement l'interface de drupal.
283 1 Julien Enselme
284 1 Julien Enselme
Il faut se rendre à l'adresse monsite/update.php et suivre les instructions.
285 1 Julien Enselme
286 1 Julien Enselme
Attention, par défaut seul le tout premier administrateur du site (c'est-à-dire le premier utilisateur, avec un uid 1 dans la base de données) peut effectuer cette opération.
287 1 Julien Enselme
288 1 Julien Enselme
S'il a été supprimé, il faut modifier le settings.php pour permettre à n'importe qui de lancer le script d'upgrade de la base de données. Attention à remettre les paramètres par défaut après.
289 1 Julien Enselme
290 1 Julien Enselme
En cas de doute, utiliser plutôt drush :p
291 1 Julien Enselme
292 1 Julien Enselme
h1. Gestion des traductions en français
293 1 Julien Enselme
294 1 Julien Enselme
h2. Méthode adoptée depuis D7
295 13 Julien Enselme
296 1 Julien Enselme
À l'installation d'un site D7, (c'est à dire pendant le install.php) la langue française doit pouvoir être proposée par défaut, si ce n'est pas le cas, c'est qu'il manque le fichier de traduction supprimé probablement lors des mises à jour du core D7. Dans ce cas :
297 1 Julien Enselme
298 1 Julien Enselme
# Aller à http://localize.drupal.org/translate/languages/fr et télécharger le fichier .po de la dernière version drupal.
299 23 Julien Enselme
# Copier ce fichier dans profiles/standard/translations
300 1 Julien Enselme
# Renommer le fichier en fr.po
301 1 Julien Enselme
# Recharger la page d'installation, la langue française doit maintenant être disponible.
302 1 Julien Enselme
303 1 Julien Enselme
Exemple : 
304 1 Julien Enselme
<pre>
305 1 Julien Enselme
<code class="bash">
306 1 Julien Enselme
cd profiles/standard/translations
307 1 Julien Enselme
wget http://ftp.drupal.org/files/translations/7.x/drupal/drupal-7.13.fr.po
308 1 Julien Enselme
</code>
309 1 Julien Enselme
</pre>
310 59 Julien Enselme
311 13 Julien Enselme
h2. Ancienne méthode manuelle
312 1 Julien Enselme
313 1 Julien Enselme
Pour traduire un site, l'administrateur devra suivre le tutoriel : http://assos.centrale-marseille.fr/content/tutoriel/traduire-linterface-de-mon-site-en-fran%C3%A7ais
314 1 Julien Enselme
315 13 Julien Enselme
h2. Maintenir les mises à jour des traductions
316 1 Julien Enselme
317 19 Julien Enselme
Du coté assos, un tâche planifiée cherche régulièrement si les traductions des sites sont à jour et sinon les met effectivement à jour (cf le crontab de assos)
318 19 Julien Enselme
319 19 Julien Enselme
h1. Changer le mot de passe de la base de données
320 19 Julien Enselme
321 19 Julien Enselme
Pour les sites ayant une base de données séparée, il faut distinguer deux choses :
322 19 Julien Enselme
* Le mot de passe du assos. Ce compte sert à l’administration. Il a les droits pour créer, supprimer une base de données, gérer les utilisateurs… Le mot de passe associé n’est connu que par les membres du club drupal. Il peut être changé de temps en temps, mais doit être changé s’il a fuité.
323 19 Julien Enselme
* Le mot de passe du site. Chaque site a en effet un utilisateur et un mot de passe pour accéder à sa base de données. Le mot de passe est inscrit dans le settings.php mais n’est vraisemblablement connu par personne. Ne doit être changé que s’il a fuité.
324 19 Julien Enselme
325 19 Julien Enselme
h3. Mot de passe du compte assos
326 19 Julien Enselme
327 19 Julien Enselme
Pour changer ce mot de passe, suivre les étapes :
328 19 Julien Enselme
# Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande).
329 19 Julien Enselme
# Changer le mot de passe (se renseigner sur la procédure/commande avant).
330 19 Julien Enselme
# Prévenir les membres du club que le mot de passe a changé.
331 19 Julien Enselme
# Mettre à jour le fichier phpmyadmin.txt
332 19 Julien Enselme
333 19 Julien Enselme
h3. Mot de passe d’un site
334 19 Julien Enselme
335 19 Julien Enselme
Pour changer ce mot de passe, suivre les étapes :
336 19 Julien Enselme
# Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande).
337 1 Julien Enselme
# Changer le mot de passe (se renseigner sur la procédure/commande avant).
338 1 Julien Enselme
# Modifier le settings.php (la partie de connexion à la base de données. Le script [[Scripts_et_taches_planifiees#dumpsh-and-co|chmdp.sh]] ne devrait pas être utilisé)
339 1 Julien Enselme
340 1 Julien Enselme
h1. Les scripts et tâches automatiques
341 1 Julien Enselme
342 15 Julien Enselme
Afin de gagner du temps et d'éviter les erreurs humaines, des scripts ont été écrits tout au long du projet. Certains sont même exécutés automatiquement toutes les semaines.
343 1 Julien Enselme
344 1 Julien Enselme
[[Scripts_et_taches_planifiees|La page suivante]] contient une documentation succinte du rôle de chacun.
345 1 Julien Enselme
346 1 Julien Enselme
h1. Administration plus avancée
347 1 Julien Enselme
348 1 Julien Enselme
h2. Récupérer le nom de domaine officiel d'une association/club/service
349 1 Julien Enselme
350 1 Julien Enselme
h3. En quoi ça consiste ?
351 1 Julien Enselme
352 1 Julien Enselme
Une association possède un site en assos.centrale-marseille.fr/monasso et veut récupérer l'adresse monasso.centrale-marseille.fr.
353 1 Julien Enselme
354 1 Julien Enselme
Le but est de faire pointer la première adresse vers la seconde.
355 18 Julien Enselme
356 1 Julien Enselme
h3. Solution officielle
357 1 Julien Enselme
358 1 Julien Enselme
Elle permet de changer complètement l'adresse du site.
359 1 Julien Enselme
360 1 Julien Enselme
Pour drupal7, se reporter au mail reçu par assos dont l'expéditeur est [[Noémie Lehuby]] le 28/02/2012.
361 1 Julien Enselme
362 1 Julien Enselme
h3. Solution rustine (à éviter)
363 1 Julien Enselme
364 1 Julien Enselme
Elle consiste en une redirection php :
365 1 Julien Enselme
366 1 Julien Enselme
On met le code suivant dans le index.php de monasso.centrale-marseille.fr
367 1 Julien Enselme
<pre>
368 1 Julien Enselme
<code class="php">
369 1 Julien Enselme
<?php		
370 1 Julien Enselme
		header( "Status: 301 Moved Permanently", false, 301);
371 1 Julien Enselme
		header("Location: http://assos.centrale-marseille.fr/monasso");
372 1 Julien Enselme
		exit();  
373 1 Julien Enselme
?>
374 1 Julien Enselme
</code>
375 1 Julien Enselme
</pre>
376 1 Julien Enselme
377 1 Julien Enselme
Quand on va alors sur : http://monasso.centrale-marseille.fr, l'url est réecrite  http://assos.centrale-marseille.fr/monasso
378 1 Julien Enselme
379 1 Julien Enselme
Inconvénient: en naviguant sur le site c'est l'url http://assos.centrale-marseille.fr/monasso que les internautes voient et non http://monasso.centrale-marseille.fr
380 1 Julien Enselme
381 1 Julien Enselme
h2. Personnalisation du settings.php
382 1 Julien Enselme
383 44 Julien Enselme
Il est possible de forcer la valeur de certaines variables drupal via le settings.php pour acter des configurations particulières. Pour ce qui touche à tous les sites, utiliser le fichier settings.global.php du dossier site. Pour les infos spécifiques, éditer le settings.local.php du dossier du site en question.
384 18 Julien Enselme
385 1 Julien Enselme
Cependant, pour des soucis de performances et de maintenabilité, depuis début 2012, on évite de le faire, on conserve un settings.php aussi proche que possible de sa structure officielle et on modifie les variables en utilisant drush. [[Scripts_et_taches_planifiees#la-réinitialisation-des-variables-dangeureuses|Plus d'info ici]]
386 1 Julien Enselme
387 1 Julien Enselme
La suite est laissée pour info, mais n'est plus valable !
388 1 Julien Enselme
389 1 Julien Enselme
h3. Gestion du cache
390 1 Julien Enselme
391 1 Julien Enselme
La team a remarqué que les webmaster ne réglent le cache de leur site que très rarement.
392 1 Julien Enselme
393 1 Julien Enselme
Lors du Drupal&Drink du 17/03/2011, la décision a été prise d'imposer le cache de base de Drupal dans le fichier setting.php des sites.
394 1 Julien Enselme
395 1 Julien Enselme
Désormais le fichier setting.php du Desktop dont on part toujours pour la création rapide d'un site contient les lignes suivantes :
396 1 Julien Enselme
<pre>
397 1 Julien Enselme
<code class="php">
398 1 Julien Enselme
/* ajout pour les caches */
399 1 Julien Enselme
//$conf['block_cache'] = 1;
400 1 Julien Enselme
$conf['cache'] = 1; // 1 is normal cache mode
401 1 Julien Enselme
$conf['cache_lifetime'] = 86400; // 0 is infinite
402 1 Julien Enselme
</code>
403 1 Julien Enselme
</pre>
404 1 Julien Enselme
Attention, les sites existant avant cette date n'ont pas ces lignes dans leur fichier setting.php
405 59 Julien Enselme
406 18 Julien Enselme
h3. Ne pas autoriser la mise à jour des modules via l'interface web
407 1 Julien Enselme
408 1 Julien Enselme
D7 autorise la mise à jour de modules, installation de nouveaux modules depuis l'interface d'administration pour un profil qui en a le droit et pour une configuration serveur particulière.
409 1 Julien Enselme
410 1 Julien Enselme
Pour enlever ce droits aux administrateurs des sites, il suffit d'ajouter cette ligne au fichier settings.php
411 1 Julien Enselme
412 17 Julien Enselme
<code class="php">
413 1 Julien Enselme
$conf['allow_authorize_operations'] = FALSE;
414 17 Julien Enselme
</code>
415 17 Julien Enselme
416 17 Julien Enselme
h1. Création de site : nom de dossier
417 1 Julien Enselme
418 53 Julien Enselme
* la personne ou asso qui demande un site veut une URL en assos.centrale-marseille.fr/monsite ou n'a pas d'URL en tête
419 17 Julien Enselme
** nom du dossier du site : assos.centrale-marseille.fr.monsite
420 53 Julien Enselme
* la personne ou asso qui demande un site veut une URL en monsite.centrale-marseille.fr :
421 53 Julien Enselme
** nom du dossier du site : assos.centrale-marseille.fr.monsite
422 1 Julien Enselme
** un lien : monsite.centrale-marseille.fr -> assos.centrale-marseille.fr.monsite