Projet

Général

Profil

Utilisation de Drupal multi-site » Historique » Version 32

Julien Enselme, 07/06/2013 17:06
Ancienne méthode (base de donnée unique): conf du proxy

1 1 Julien Enselme
{{toc}}
2
3
h1. Création d'un sous site
4
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
h2. Méthode drupal 6
8
9 24 Julien Enselme
{{warning(A priori on ne fait plus de sites drupal 6 actuellement)}}
10 1 Julien Enselme
11 20 Julien Enselme
h3. Création du site drupal 6
12 1 Julien Enselme
13 3 Julien Enselme
# Dans html/sites créer un nouveau dossier nommé "assos.centrale-marseille.fr.nomdusite". Ce sera ce qu'on appelle par la suite le dossier du site
14 1 Julien Enselme
# Copier-coller le fichier setting.php ( présent sur le bureau d'assos) dans le dossier précedemment créé
15
# Se donner des droits d'écriture sur le settings.php (<code>chmod +w settings.php</code> ou clic droit, propriétés, permissions, si vous utilisez l'interface Gnome)
16
# Modifier les lignes 93 et 125 du settings.php :
17
<pre><code class="php">
18
  $db_prefix = 'nomdusite_';
19
  $base_url = 'http://assos.centrale-marseille.fr/nomdusite';
20
</code></pre>
21
Le préfixe est utilisé pour différentier les tables d'un même site dans la base de données.
22
# Créer un lien symbolique via le terminal
23
 <pre>(dans le répertoire html)
24
 <code>ln -s . nomdusite</code>
25
 </pre>
26 3 Julien Enselme
# Lancer l'installation du site en allant sur l'url : http://assos.centrale-marseille.fr/nomdusite/install.php. On aura alors "la page suivante":https://forge.centrale-marseille.fr/attachments/download/9/install.jpg. Si ça ne marche pas, c'est qu'il y a une erreur dans les étapes précédentes : recommencer scrupuleusement.
27 1 Julien Enselme
# Choisir la langue (de préférence le français) et continuer l'installation en donnant un nom  pour le site (configurable après) et en créant un compte pour l'administrateur.
28
# Retirer les droits d'écriture sur le settings.php
29
30 20 Julien Enselme
h3. Trucs à faire sur le site juste après l’ouverture du site drupal 6
31 1 Julien Enselme
32
* Dans /admin/reports/updates/settings, ajouter l'adresse mail de assos ; ainsi seuls les responsables du projets recevront les notifications de mises à jour disponibles et feront le nécessaire. 
33
* Conseiller à l'administrateur de ne pas laisser les inscriptions ouvertes à son site (voir admin/user/settings) 
34 4 Julien Enselme
* Réfléchir à la [[Utilisation_de_Drupal_multi-site#Choisir-et-implémenter-la-bonne-méthode-de-téléchargement|Méthode de téléchargement]]
35 1 Julien Enselme
* Donner à l'administrateur le lien des tutoriels écrits par le club Drupal
36
37 20 Julien Enselme
h3. Référencement du site drupal 6
38 1 Julien Enselme
39
* ajouter le site à la page d'accueil du projet (site default d6)
40
* ajouter le site sur superadmin
41
* inscrire l'administrateur du site sur la liste de diffusion <code>drupal</code>
42
43
h2. Méthode Drupal 7
44
45 25 Julien Enselme
{{warning(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.
46
Pensez également à tenir le script de création de site à jour.)}}
47 1 Julien Enselme
48 20 Julien Enselme
h3. Création du site drupal 7
49 1 Julien Enselme
50 5 Julien Enselme
# Dans htmltest/sites créer un nouveau dossier nommé "assos.centrale-marseille.fr.nomdusite". Ce sera ce qu'on appelle par la suite le dossier du site.
51
# Copier-coller le fichier settings-D7-bddinde.php (présent sur le bureau d'assos) dans le dossier précédemment créé.
52 1 Julien Enselme
# Renommer ce fichier en settings.php 
53 5 Julien Enselme
# Se connecter sur phpmyadmin sur le serveur myassos (dans la liste déroulante) avec le login assos, le mdp est dans le fichier phpmyadmin.txt.
54 25 Julien Enselme
{{warning(
55 5 Julien Enselme
Attention | le point ci-dessous est valide mais en cours de révision pour la création d'un utilisateur par base de données (quels droits lui accorder), en effet dans phpmyadmin il peut être plus facile de créer l'utilisateur et la base de données en une seule fois avec des  droits par défaut sur cette base.
56
Merci de s'informer sur l'avancement de cette réflexion avant de créer un site.
57 25 Julien Enselme
)}}
58 5 Julien Enselme
# Créer une nouvelle base de donnée en cliquant sur l'onglet bases de données, en tapant le _nomdusite_ dans le champ prévu en laissant _Interclassement_ dans le menu déroulant puis cliquer sur créer.
59
# Modifier la ligne 185 de ce fichier settings.php en y ajoutant le _nomdusite_ en _database_.
60 1 Julien Enselme
# Créer un lien symbolique via le terminal 
61
 <pre>(dans le répertoire htmltest)
62
<code>
63
 ln -s . nomdusite
64
</code>
65
 </pre>
66 5 Julien Enselme
# Lancer l'installation du site en allant sur l'url : http://assos.centrale-marseille.fr/nomdusite/install.php
67
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.
68
# 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.
69 21 Julien Enselme
# Activer l’outil de statistiques piwik en lançant les commandes ci-dessous. Dans la ligne contenant _side_id_ remplacer _XXX_ par 101 pour les sites en assos ou atest. Pour ceux sous un autre sous domaine, le lire dans le site des statistiques ou se rapprocher de dgeo. **Ces commandes sont à lancer dans le dossier du site.**
70 1 Julien Enselme
<pre>
71
<code class="bash">
72
drush -y vset piwik_site_id "XXX"
73
drush -y vset piwik_url_http "http://piwik.centrale-marseille.fr/"
74
drush -y vset piwik_url_https "https://piwik.centrale-marseille.fr/"
75
</code>
76
</pre>
77
78
Active le cache local du javascript
79
<pre>
80
<code class="bash">
81
drush -y vset piwik_cache 1
82
drush -y vset piwik_visibility_roles "1"
83
</code>
84
</pre>
85
86
Active les stats pour anonymous et authentifié
87
<pre>
88
<code class="bash">
89
drush -y vset --format=json piwik_roles '{"1":0,"2":0}'
90
drush -y vset piwik_page_title_hierarchy 1
91
</code>
92
</pre>
93
94
Si la recherche locale est activée
95
<pre>
96
<code class="bash">
97
drush -y vset piwik_site_search 1
98
</code>
99
</pre>
100
101
On active le module
102
<pre>
103
<code class="bash">
104
drush -y en piwik
105
</code>
106
</pre>
107 5 Julien Enselme
Les statistiques sont disponibles sur https://piwik.centrale-marseille.fr/. Voir les archives de la liste assos ou dgeo pour les pass.
108 1 Julien Enselme
109 20 Julien Enselme
h3. Trucs à faire sur le site juste après l’ouverture du site drupal 7
110 1 Julien Enselme
111 5 Julien Enselme
* Lancer, dans le dossier du site, le script <code>init_var.sh</code> afin d'initialiser quelques variables et configurations. Pour plus d'info, consulter [[Scripts_et_taches_planifiees#init_var.sh|ce paragraphe]]
112 1 Julien Enselme
* Conseiller à l'administrateur de ne pas laisser les inscriptions ouvertes à son site
113
* Donner à l'administrateur le lien des tutoriels écrits par le club Drupal
114
115 20 Julien Enselme
h3. Référencement du site drupal 7
116 1 Julien Enselme
117 5 Julien Enselme
* Créer un contenu de type "Site" sur la page du projet multiassos
118
* Demander à l’administrateur de s’inscrire à la liste de diffusion webmasters@listes.centrale-marseille.fr
119 1 Julien Enselme
120 20 Julien Enselme
h2. Script de création de site drupal 7
121 1 Julien Enselme
122
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.
123
124
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.
125
126 6 Julien Enselme
h2. Quelques informations sur le pourquoi du comment
127 1 Julien Enselme
128 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).
129 1 Julien Enselme
130
Lorsqu'un site est appelé avec l'url http://assos.centrale-marseille.fr/nomdusite, les actions suivantes sont effectuées :
131 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_.
132 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 !
133
* Une fois dans ce dossier (donc toujours dans html), chercher un fichier <code>index.php</code>
134
* 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
135 6 Julien Enselme
* Chercher dans l'installation drupal un dossier nommé assos.centrale-marseille.fr.nomdusite
136
* Si trouvé, rentrer dedans et lire le <code>settings.php</code>
137
* Si tout va bien, afficher le site :)
138 1 Julien Enselme
139
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).
140
141
Le reste est du domaine de drupal.
142
143
h1. Suppression d'un sous site
144
145 7 Julien Enselme
h2. Ancienne méthode (base de donnée unique)
146 1 Julien Enselme
147 26 Julien Enselme
{{warning(Cette méthode est en voie de disparition. À n’utiliser que pour les vieux sites)}}
148 1 Julien Enselme
149 7 Julien Enselme
# Aller sur phpmyadmin : https://outils.centrale-marseille.fr/phpmyadmin/
150 1 Julien Enselme
# Faire une sauvegarde de la base de données
151
# Supprimer toutes les tables associées dans la base de données ( /!\ Bien regarder les tables que l'on supprime !) 
152 7 Julien Enselme
# Supprimer le dossier créé dans html/sites (ou htmltest/sites) en se redonnant les droits (si nécessaire)
153 1 Julien Enselme
# Supprimer le lien symbolique dans html (ou htmltest).
154
# Retirer l'administrateur du sous-site de la liste Drupal
155 7 Julien Enselme
# Supprimer ce site du crontab s'il y est (<code>crontab -l</code> pour le voir, <code>crontab -e</code> pour l'éditer. Voir http://fr.wikipedia.org/wiki/Crontab pour plus de détails)
156 1 Julien Enselme
# Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher _État du site_
157 32 Julien Enselme
# Si le site est un drupal 6, le dire à dgeo pour qu’il mette à jour la conf du proxy
158 1 Julien Enselme
159 7 Julien Enselme
h2. Nouvelle méthode
160 1 Julien Enselme
161 7 Julien Enselme
# Aller sur phpmyadmin : https://outils.centrale-marseille.fr/phpmyadmin/
162 1 Julien Enselme
# Faire une sauvegarde de la base de données
163
# Supprimer la base de données du site
164 7 Julien Enselme
# Supprimer le dossier créé dans html/sites (ou htmltest/sites) en se redonnant les droits (si nécessaire)
165 1 Julien Enselme
# Supprimer le lien symbolique dans html (ou htmltest).
166
# Retirer l'administrateur du sous-site de la liste Drupal
167 7 Julien Enselme
# Supprimer ce site du crontab s'il y est (<code>crontab -l</code> pour le voir, <code>crontab -e</code> pour l'éditer. Voir http://fr.wikipedia.org/wiki/Crontab pour plus de détails)
168
# Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher _État du site_
169 1 Julien Enselme
170
h1. Installation de module ou de thème
171
172 8 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.
173 1 Julien Enselme
174
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.
175
176
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 !
177
178 20 Julien Enselme
h2. Installation de module/thème à la main
179 1 Julien Enselme
180
* Se rendre sur le site officiel de Drupal sur la page du projet
181
* Télécharger la source
182
* L'extraire
183
* Placer le dossier extrait dans le dossier sites/all/modules ou sites/all/themes en fonction du cas
184
* **Si** le dossier extrait comprend un fichier INSTALL.txt, le lire et suivre les éventuelles étapes complémentaires
185
* 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é.
186
187 20 Julien Enselme
h2. Installation de module/thème drush
188 1 Julien Enselme
189 31 Julien Enselme
[[drush|Quelques explications sur Drush avant ?]]
190 8 Julien Enselme
191 1 Julien Enselme
* Se rendre dans le dossier d'un site de l'installation via son terminal
192 8 Julien Enselme
* Taper la commande <code>drush dl projet</code> (où projet est le nom du thème ou module)
193
* Activer sur un site le nouveau module ou thème pour vérifier que ça marche bien <code>drush en projet</code>
194 1 Julien Enselme
195
h1. Suppression de module ou de thème
196
197
Pour cela, le plus simple est d'utiliser le script drushall.
198
199
Il faut :
200
# désactiver le projet sur tous les sites : <code>drushall dis projet</code>
201
# 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>drushall pm-uninstall projet</code>
202
# supprimer le dossier du projet dans le répertoire sites/all/modules ou sites/all/themes
203
204
h1. Mises à jour
205
206 27 Julien Enselme
{{warning(
207 9 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.
208 27 Julien Enselme
)}}
209 1 Julien Enselme
210
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 !
211
212
On distingue plusieurs types de mises à jour :
213
* les mises à jour de projet (projet = module ou thème)
214
* les mises à jour du noyau (core) de drupal
215
* les mises à jour majeures de drupal (migration)
216
* 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
217
218 9 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 ;)
219 1 Julien Enselme
220
h2. Mise à jour d'un module ou d'un thème
221
222 9 Julien Enselme
Pour notre installation drupal 6, depuis fin 2010, les mises à jour sont effectuées automatiquement toutes les semaines grâce à un [[Scripts_et_taches_planifiees#maj.sh|script]] et au crontab.
223 1 Julien Enselme
224
Pour notre installation drupal 7, il faudra effectuer quelque chose de similaire.
225
226
Voici tout de même les méthodes pour effectuer ces mises à jour.
227
Toujours privilégier la méthode drush, les autres sont présentes uniquement pour info (ou si drush est planté :p)
228
229 20 Julien Enselme
h3. Mise à jour d'un module ou d'un thème à la main
230 1 Julien Enselme
231
# 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.
232
# Supprimer l'ancienne version dans /users/guest/assos/html/sites/all/modules.
233
# Copier la nouvelle version dans /users/guest/assos/html/sites/all/modules.
234
# Faire la mise à jour de la base de données
235
236 20 Julien Enselme
h3. Mise à jour d'un module ou d'un thème avec drush
237 1 Julien Enselme
238 31 Julien Enselme
[[Drush|Quelques explications sur Drush avant ?]]
239 1 Julien Enselme
240
Drush permet d'effectuer pour un site toutes les mises à jour des modules et des thèmes d'un seul coup.
241
242 9 Julien Enselme
Rappel :
243
* Pour effectuer cette opération sur tous les sites, remplacer drush par drushall. Pour les sites drupal 7, remplacer drushall par drushall_atest.
244
* Pour mettre un jour un site en particulier, se placer dans le dossier du site en question.
245 1 Julien Enselme
246
Voici comment procéder :
247
# se placer (dans un terminal évidemment) dans le dossier du site
248 9 Julien Enselme
# lancer la commande <code>drush -y en update</code> pour activer la mise à jour
249
# lancer la commande <code>drush upc --no-core</code>
250
# si une mise à jour de la base de données est requise, lancer la commande <code>drush -y updb</code>
251
# 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>
252 29 Julien Enselme
# lancer la commande <code>drush -y dis update</code> pour désactiver le module update
253 1 Julien Enselme
254 9 Julien Enselme
NB : la commande <code>drush up</code> permet d'effectuer upc et updb en une seule fois !
255 1 Julien Enselme
256
h2. Mise à jour du noyau de Drupal
257
258
Il s'agit par exemple de passer de drupal 6.X à drupal 6.Y
259
260 20 Julien Enselme
h3. Mise à jour du noyau de Drupal à la main
261 1 Julien Enselme
262
La méthode la plus complète est donnée dans le fichier UPGRADE.txt dans le dossier officiel de Drupal.
263
264
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
265
# Faire une sauvegarde complète (base de données et dossiers)
266
# Revenir au thème de base Garland (si ce n'est déjà pas le cas) le temps de transférer les mises à jours.
267
# 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.
268
# 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" .
269 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.
270
# 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.
271
# Lancer le script de mise à jour de la base de données.
272 1 Julien Enselme
# Revenir au thème personnalisé du site (si ce n'est pas Garland).
273
# Supprimer CHANGELOG.TXT de l'installation
274
275 20 Julien Enselme
h3. Mise à jour du noyau de Drupal avec drush
276 1 Julien Enselme
277
Drush permet aussi d'effectuer ce type de mise à jour.
278
279 9 Julien Enselme
Rappel :
280
* Pour effectuer cette opération sur tous les sites, remplacer drush par drushall. Pour les sites drupal 7, remplacer drushall par drushall_atest.
281
* Pour mettre un jour un site en particulier, se placer dans le dossier du site en question.
282 1 Julien Enselme
283
Pour ceci :
284
# Faire une sauvegarde complète (base de données et dossiers)
285
# Effectuer la mise à jour des projets
286 22 Julien Enselme
# Lancer la commande <code>drush -y en update</code> pour activer l'update sur tous les sites.
287
# Lancer la commande <code>drush upc drupal</code>
288
# Lancer <code>drush updb</code> pour faire la mise à jour de la base de données.
289
# Lancer la commande <code>drush -y dis update</code> pour désactiver l'update sur tous les sites.
290 12 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]])
291 1 Julien Enselme
292
h2. Mise à jour Majeure
293
294
Une mise à jour majeure consiste à passer par exemple de drupal 6 à drupal 7. On parle aussi d'ugrade ou de migration.
295 9 Julien Enselme
Attention, c'est une tâche lourde qui nécessite de la préparation ! **beaucoup** de préparation (au moins 6 mois !)
296 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 !
297
298
Voici la page de préparation de migration [[De Drupal6 vers Drupal7]]
299
300
301
h2. Mise à jour de la base de données
302
303
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.
304
305 20 Julien Enselme
h3. Mise à jour de la base de données avec drush
306 1 Julien Enselme
307
Il suffit de lancer, dans le dossier du site, la commande <code>drush updb</code>
308
309 20 Julien Enselme
h3. Mise à jour de la base de données à la main
310 1 Julien Enselme
311
Cette méthode utilise directement l'interface de drupal.
312
313
Il faut se rendre à l'adresse monsite/update.php et suivre les instructions.
314
315
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.
316
317
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.
318
319
En cas de doute, utiliser plutôt drush :p
320
321
h1. Gestion des traductions en français
322
323
h2. Méthode adoptée depuis D7
324
325 13 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 :
326 1 Julien Enselme
327
# Aller à http://localize.drupal.org/translate/languages/fr et télécharger le fichier .po de la dernière version drupal.
328
# Copier ce fichier dans profiles/standard/translations
329 23 Julien Enselme
# Renommer le fichier en fr.po
330 1 Julien Enselme
# Recharger la page d'installation, la langue française doit maintenant être disponible.
331
332
Exemple : 
333
<pre>
334
<code class="bash">
335
cd profiles/standard/translations
336
wget http://ftp.drupal.org/files/translations/7.x/drupal/drupal-7.13.fr.po
337
</code>
338
</pre>
339
340
h2. Ancienne méthode manuelle valable pour D6 et D7
341
342 13 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
343 1 Julien Enselme
344
h2. Maintenir les mises à jour des traductions
345
346 13 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)
347 1 Julien Enselme
348 19 Julien Enselme
h1. Changer le mot de passe de la base de données
349 1 Julien Enselme
350 19 Julien Enselme
h2. Sites dans la base de données unique
351 14 Julien Enselme
352 19 Julien Enselme
Il s’agit de l’ancienne méthode, à utiliser pour les sites en webassos entre autre. Les nouveaux sites doivent être créés avec une base de données séparée.
353
354 1 Julien Enselme
Il est bon, de temps en temps ou lorsqu'il est tombé, de modifier le mot de passe de la base de données hébergeant les sites.
355
Voici le processus :
356 14 Julien Enselme
# modifier le mot de passe (il y a une commande sql toute faite pour ça, ou aller sur phpmyadmin)
357
# modifier la valeur du mot de passe dans les settings.php (utiliser le script [[Scripts_et_taches_planifiees#ch_mdp|ch_mdp]])
358 1 Julien Enselme
# vérifier que les sites fonctionnent !
359
# modifier la valeur du mot de passe dans les settings.php de référence (présents sur le bureau du compte assos)
360
# modifier la valeur du mot de passe dans les scripts qui l'utilisent ([[Scripts_et_taches_planifiees#dumpsh-and-co|jeter un coup d'oeil ici]])
361
# vérifier que les sus-dits scripts fonctionnent
362 19 Julien Enselme
363
h2. Sites ayant une base de données séparées
364
365
Pour les sites ayant une base de données séparée, il faut distinguer deux choses :
366
* 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é.
367
* 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é.
368
369
h3. Mot de passe du compte assos
370
371
Pour changer ce mot de passe, suivre les étapes :
372
# Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande).
373
# Changer le mot de passe (se renseigner sur la procédure/commande avant).
374
# Prévenir les membres du club que le mot de passe a changé.
375
# Mettre à jour le fichier phpmyadmin.txt
376
377
h3. Mot de passe d’un site
378
379
Pour changer ce mot de passe, suivre les étapes :
380
# Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande).
381
# Changer le mot de passe (se renseigner sur la procédure/commande avant).
382
# 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é)
383 1 Julien Enselme
384
h1. Les scripts et tâches automatiques
385
386
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.
387
388 15 Julien Enselme
[[Scripts_et_taches_planifiees|La page suivante]] contient une documentation succinte du rôle de chacun.
389 1 Julien Enselme
390
h1. Administration plus avancée
391
392 18 Julien Enselme
h2. Choisir et implémenter la bonne méthode de téléchargement (drupal 6)
393 1 Julien Enselme
394 18 Julien Enselme
À l'ouverture d'un site (en particulier pour des sites sans durée limitée, typiquement pour les associations), il faut se poser la question de la méthode de téléchargement. C'est en effet cela qui définit comment les fichiers ajoutés sur le site sont protégés (ou pas).
395 1 Julien Enselme
396
Cela peut-être particulièrement important si les associatifs utilisent ce site pour partager des documents confidentiels (CR, etc).
397
398 18 Julien Enselme
Par ailleurs, il est capital de mettre en place la méthode de téléchargement avant de commencer à remplir le site de fichiers (car sinon, il faudra recommencer…). Donc c'est aux gens qui ouvrent le site d'en parler avec le webmaster du site en question !
399 1 Julien Enselme
400
Pour drupal 7, ceci est géré en natif et ne demande donc pas autant d'attention.
401
402
h2. Récupérer le nom de domaine officiel d'une association/club/service
403
404
h3. En quoi ça consiste ?
405
406
Une association possède un site en assos.centrale-marseille.fr/monasso et veut récupérer l'adresse monasso.centrale-marseille.fr.
407
408
Le but est de faire pointer la première adresse vers la seconde.
409
410
h3. Solution officielle
411 18 Julien Enselme
412 1 Julien Enselme
Elle permet de changer complètement l'adresse du site.
413
414
Pour drupal 6, il s'agit d'une solution en trois étapes, la deuxième à effectuer par le CRI.
415
416
Pour des raisons de sécurité, la procédure ne sera pas écrite ici : se reporter au mail reçu par assos dont l'expéditeur est dgeo le 04/11/2009 à 16:23
417
418
Pour drupal7, se reporter au mail reçu par assos dont l'expéditeur est [[Noémie Lehuby]] le 28/02/2012.
419
420
h3. Solution rustine (à éviter)
421
422
Elle consiste en une redirection php :
423
424
On met le code suivant dans le index.php de monasso.centrale-marseille.fr
425
<pre>
426
<code class="php">
427
<?php		
428
		header( "Status: 301 Moved Permanently", false, 301);
429
		header("Location: http://assos.centrale-marseille.fr/monasso");
430
		exit();  
431
?>
432
</code>
433
</pre>
434
435
Quand on va alors sur : http://monasso.centrale-marseille.fr, l'url est réecrite  http://assos.centrale-marseille.fr/monasso
436
437
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
438
439
h2. Création d'un thème
440
441
Dans le cadre du projet multi-assos et surtout de sa problématique de sécurité, la création de thème doit être extrèmement cadrée !
442
La page suivante indique quelques possibilités (pour drupal 6) : [[Création de thème Drupal]]
443
444
h2. Personnalisation du settings.php
445
446
Il est possible de forcer la valeur de certaines variables drupal via le settings.php pour acter des configurations particulières.
447
448 18 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]]
449 1 Julien Enselme
450
La suite est laissée pour info, mais n'est plus valable !
451
452
h3. Gestion du cache
453
454
La team a remarqué que les webmaster ne réglent le cache de leur site que très rarement.
455
456
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.
457
458 18 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 :
459 1 Julien Enselme
<pre>
460
<code class="php">
461
/* ajout pour les caches */
462
//$conf['block_cache'] = 1;
463
$conf['cache'] = 1; // 1 is normal cache mode
464
$conf['cache_lifetime'] = 86400; // 0 is infinite
465
</code>
466
</pre>
467
Attention, les sites existant avant cette date n'ont pas ces lignes dans leur fichier setting.php
468
469
h3. Ne pas autoriser la mise à jour des modules via l'interface web (pour d7 uniquement)
470
471
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.
472
473 18 Julien Enselme
Pour enlever ce droits aux administrateurs des sites, il suffit d'ajouter cette ligne au fichier settings.php
474 1 Julien Enselme
475
<code class="php">
476
$conf['allow_authorize_operations'] = FALSE;
477
</code>
478
479 17 Julien Enselme
h1. Création de site : nom de dossier
480 1 Julien Enselme
481 17 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
482
483
 * nom du dossier du site : assos.centrale-marseille.fr.monsite
484 1 Julien Enselme
* la personne ou asso qui demande un site veut une URL en monsite.centrale-marseille.fr :
485 17 Julien Enselme
486
 * nom du dossier du site : assos.centrale-marseille.fr.monsite
487
 * un lien : monsite.centrale-marseille.fr -> assos.centrale-marseille.fr.monsite