Projet

Général

Profil

Utilisation de Drupal multi-site » Historique » Version 41

Julien Enselme, 12/09/2013 10:46
Création du site drupal 7 : Mise à jour sur les settings.local.php

1 1 Julien Enselme
h1. Création d'un sous site
2 34 Florent Torregrosa
3
{{>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
h2. Méthode Drupal 7
8
9 36 Julien Enselme
{{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.
10 25 Julien Enselme
Pensez également à tenir le script de création de site à jour.)}}
11 1 Julien Enselme
12 20 Julien Enselme
h3. Création du site drupal 7
13 1 Julien Enselme
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
# Créer ce qu’il faut pour les sauvegardes :
16 5 Julien Enselme
17 35 Julien Enselme
 # Créer deux dossiers pour les sauvegardes individiuelles (automatiques et manuelles)
18
 # 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.
19 41 Julien Enselme
 # Par exemple :
20
<pre><code class="php">for i in {1..4} ; do
21
  touch auto/d7/assos.centrale-marseille.fr.camara/`date "+%Y-%m-%d-%Hh%Mm%Ss"`.assos.centrale-marseille.fr.camara.sql$i
22
done</code></pre>
23 35 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).
24
# Créer une nouvelle base de donnée et un nouvel utilisateur nommés _nondusite_ via User > add user.
25 1 Julien Enselme
26 35 Julien Enselme
 # Renseigner son nom.
27
 # Générer un mot de passe aléatoire et le conserver (il est à renseigner dans le settings.php).
28
 # Dans _database for user_, cocher _Create database with same name and grant all privileges_.
29 1 Julien Enselme
 # Laisser toutes les autres options par défaut.
30
 # Valider
31
# On configure le settings.php qui contient toutes les variables indispensables au bon fonctionnement de drupal.
32
33 41 Julien Enselme
 # Copier-coller le fichier d7-settings.php (présent dans le dossier template) dans le dossier du site.
34
 # Renommer ce fichier en settings.php (il contient les variables communes à tous les sites qui ne doivent pas être modifiées pour des raisons de sécurité)
35
 # Copier-coller le fichier d7-settings-local-template.php
36
 # Renommer ce fichier en settings.local.php (il contient les infos sur la base de données)
37
 # Remplacer %%DBUSER%%, %%DBNAME%% et %%SITE_NAME%% par _nomdusite_
38 35 Julien Enselme
 # Remplacer %%DBPASS%% par le mot de passe généré ci-avant.
39
# Créer un lien symbolique via le terminal *dans le répertoire htmltest* @ln -s . nomdusite@
40
# 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
# 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
# Lancer le script _d7-reset-variables.sh_ dans le dossier du site.
43 36 Julien Enselme
# Mettre les bons droits sur les dossiers/fichiers entrer ces commandes dans le répertoire htmltest/sites
44 1 Julien Enselme
45 36 Julien Enselme
 # chmod -R 755 DOSSIER_DU_SITE
46
 # chmod 400 DOSSIER_DU_SITE/settings.php
47 35 Julien Enselme
48 1 Julien Enselme
{{tip(Des statistiques sont accessibles via https://piwik.centrale-marseille.fr/. Voir le clubdrupal pour les accès.)}}
49 20 Julien Enselme
50 1 Julien Enselme
h3. Trucs à faire sur le site juste après l’ouverture du site drupal 7
51
52 20 Julien Enselme
* Conseiller à l'administrateur de ne pas laisser les inscriptions ouvertes à son site
53 1 Julien Enselme
* Donner à l'administrateur le lien des tutoriels écrits par le club Drupal
54 5 Julien Enselme
* Créer un contenu de type "Site" sur la page du projet multiassos
55 36 Julien Enselme
* Inscrire à la liste de diffusion webmasters@listes.centrale-marseille.fr
56 1 Julien Enselme
57 20 Julien Enselme
h2. Script de création de site drupal 7
58 1 Julien Enselme
59
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.
60
61
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.
62
63 6 Julien Enselme
h2. Quelques informations sur le pourquoi du comment
64 1 Julien Enselme
65 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).
66 1 Julien Enselme
67
Lorsqu'un site est appelé avec l'url http://assos.centrale-marseille.fr/nomdusite, les actions suivantes sont effectuées :
68 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_.
69 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 !
70
* Une fois dans ce dossier (donc toujours dans html), chercher un fichier <code>index.php</code>
71
* 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
72 6 Julien Enselme
* Chercher dans l'installation drupal un dossier nommé assos.centrale-marseille.fr.nomdusite
73
* Si trouvé, rentrer dedans et lire le <code>settings.php</code>
74
* Si tout va bien, afficher le site :)
75 1 Julien Enselme
76
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).
77
78
Le reste est du domaine de drupal.
79
80
h1. Suppression d'un sous site
81
82 7 Julien Enselme
h2. Ancienne méthode (base de donnée unique)
83 1 Julien Enselme
84 26 Julien Enselme
{{warning(Cette méthode est en voie de disparition. À n’utiliser que pour les vieux sites)}}
85 1 Julien Enselme
86 7 Julien Enselme
# Aller sur phpmyadmin : https://outils.centrale-marseille.fr/phpmyadmin/
87 1 Julien Enselme
# Faire une sauvegarde de la base de données
88
# Supprimer toutes les tables associées dans la base de données ( /!\ Bien regarder les tables que l'on supprime !) 
89 7 Julien Enselme
# Supprimer le dossier créé dans html/sites (ou htmltest/sites) en se redonnant les droits (si nécessaire)
90 1 Julien Enselme
# Supprimer le lien symbolique dans html (ou htmltest).
91
# Retirer l'administrateur du sous-site de la liste Drupal
92 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)
93 1 Julien Enselme
# Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher _État du site_
94 32 Julien Enselme
# Si le site est un drupal 6, le dire à dgeo pour qu’il mette à jour la conf du proxy
95 1 Julien Enselme
96 37 Julien Enselme
h2. Méthode actuelle
97 1 Julien Enselme
98 37 Julien Enselme
{{important(Cette méthode n’est valable que pour les sites sous drupal 7)}}
99
100
# Supprimer la base de données du site et l’utilisateur dans phpmyadmin, via l’onglet _Users_ :
101
102
 # Trouver l’utilisateur
103
 # Dans _ Remove selected users_, cocher _Drop the databases that have the same names as the users._
104
 # Valider
105
# Supprimer le dossier créé dans htmltest/sites en se redonnant les droits (si nécessaire)
106 1 Julien Enselme
# Supprimer le lien symbolique dans html (ou htmltest).
107 37 Julien Enselme
# Supprimer les sauvegardes de base données
108
109
 * dans individual/auto/d7/NOM_DU_SITE
110
 * dans individual/manual/d7/NOM_DU_SITE
111 7 Julien Enselme
# Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher _État du site_
112 37 Julien Enselme
113
{{note(Les utilisateurs se retirent eux même de la liste webmaster)}}
114 1 Julien Enselme
115
h1. Installation de module ou de thème
116 8 Julien Enselme
117 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.
118
119
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.
120
121
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 !
122 20 Julien Enselme
123 1 Julien Enselme
h2. Installation de module/thème à la main
124
125
* Se rendre sur le site officiel de Drupal sur la page du projet
126
* Télécharger la source
127
* L'extraire
128
* Placer le dossier extrait dans le dossier sites/all/modules ou sites/all/themes en fonction du cas
129
* **Si** le dossier extrait comprend un fichier INSTALL.txt, le lire et suivre les éventuelles étapes complémentaires
130
* 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é.
131 20 Julien Enselme
132 1 Julien Enselme
h2. Installation de module/thème drush
133 31 Julien Enselme
134 8 Julien Enselme
[[drush|Quelques explications sur Drush avant ?]]
135 1 Julien Enselme
136 8 Julien Enselme
* Se rendre dans le dossier d'un site de l'installation via son terminal
137
* Taper la commande <code>drush dl projet</code> (où projet est le nom du thème ou module)
138 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>
139
140
h1. Suppression de module ou de thème
141
142
Pour cela, le plus simple est d'utiliser le script drushall.
143
144
Il faut :
145
# désactiver le projet sur tous les sites : <code>drushall dis projet</code>
146
# 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>
147 33 Florent Torregrosa
# supprimer le dossier du projet dans le répertoire sites/all/modules ou sites/all/themes
148 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.
149
150
h1. Mises à jour
151 27 Julien Enselme
152 9 Julien Enselme
{{warning(
153 27 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.
154 1 Julien Enselme
)}}
155
156
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 !
157
158
On distingue plusieurs types de mises à jour :
159
* les mises à jour de projet (projet = module ou thème)
160
* les mises à jour du noyau (core) de drupal
161
* les mises à jour majeures de drupal (migration)
162
* 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
163 9 Julien Enselme
164 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 ;)
165
166
h2. Mise à jour d'un module ou d'un thème
167 9 Julien Enselme
168 1 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.
169
170
Pour notre installation drupal 7, il faudra effectuer quelque chose de similaire.
171
172
Voici tout de même les méthodes pour effectuer ces mises à jour.
173
Toujours privilégier la méthode drush, les autres sont présentes uniquement pour info (ou si drush est planté :p)
174 20 Julien Enselme
175 1 Julien Enselme
h3. Mise à jour d'un module ou d'un thème à la main
176
177
# 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.
178
# Supprimer l'ancienne version dans /users/guest/assos/html/sites/all/modules.
179
# Copier la nouvelle version dans /users/guest/assos/html/sites/all/modules.
180
# Faire la mise à jour de la base de données
181 20 Julien Enselme
182 1 Julien Enselme
h3. Mise à jour d'un module ou d'un thème avec drush
183 31 Julien Enselme
184 1 Julien Enselme
[[Drush|Quelques explications sur Drush avant ?]]
185
186
Drush permet d'effectuer pour un site toutes les mises à jour des modules et des thèmes d'un seul coup.
187 9 Julien Enselme
188
Rappel :
189
* Pour effectuer cette opération sur tous les sites, remplacer drush par drushall. Pour les sites drupal 7, remplacer drushall par drushall_atest.
190 1 Julien Enselme
* Pour mettre un jour un site en particulier, se placer dans le dossier du site en question.
191
192
Voici comment procéder :
193 9 Julien Enselme
# se placer (dans un terminal évidemment) dans le dossier du site
194
# lancer la commande <code>drush -y en update</code> pour activer la mise à jour
195
# lancer la commande <code>drush upc --no-core</code>
196
# si une mise à jour de la base de données est requise, lancer la commande <code>drush -y updb</code>
197 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>
198 1 Julien Enselme
# lancer la commande <code>drush -y dis update</code> pour désactiver le module update
199 9 Julien Enselme
200 1 Julien Enselme
NB : la commande <code>drush up</code> permet d'effectuer upc et updb en une seule fois !
201
202
h2. Mise à jour du noyau de Drupal
203
204
Il s'agit par exemple de passer de drupal 6.X à drupal 6.Y
205 20 Julien Enselme
206 1 Julien Enselme
h3. Mise à jour du noyau de Drupal à la main
207
208
La méthode la plus complète est donnée dans le fichier UPGRADE.txt dans le dossier officiel de Drupal.
209
210
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
211
# Faire une sauvegarde complète (base de données et dossiers)
212
# Revenir au thème de base Garland (si ce n'est déjà pas le cas) le temps de transférer les mises à jours.
213
# 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.
214 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" .
215
# 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.
216
# 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.
217 1 Julien Enselme
# Lancer le script de mise à jour de la base de données.
218
# Revenir au thème personnalisé du site (si ce n'est pas Garland).
219
# Supprimer CHANGELOG.TXT de l'installation
220 39 Julien Enselme
# Mettre à jour les settings.php
221 20 Julien Enselme
222 1 Julien Enselme
h3. Mise à jour du noyau de Drupal avec drush
223
224
Drush permet aussi d'effectuer ce type de mise à jour.
225 9 Julien Enselme
226
Rappel :
227
* Pour effectuer cette opération sur tous les sites, remplacer drush par drushall. Pour les sites drupal 7, remplacer drushall par drushall_atest.
228 1 Julien Enselme
* Pour mettre un jour un site en particulier, se placer dans le dossier du site en question.
229
230
Pour ceci :
231
# Faire une sauvegarde complète (base de données et dossiers)
232 22 Julien Enselme
# Effectuer la mise à jour des projets
233
# Lancer la commande <code>drush -y en update</code> pour activer l'update sur tous les sites.
234
# Lancer la commande <code>drush upc drupal</code>
235
# Lancer <code>drush updb</code> pour faire la mise à jour de la base de données.
236 12 Julien Enselme
# Lancer la commande <code>drush -y dis update</code> pour désactiver l'update sur tous les sites.
237 1 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]])
238 39 Julien Enselme
# Mettre à jour les settings.php
239
240
h3. Mise à jour des settings.php
241
242
À 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 :
243
244
* settings.php : fichier qui contient toutes les variables communes à tous les sites, c’est lui que l’on va mettre à jour.
245
* 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é.
246
247
Pour mettre à jour un settings.php, il faut :
248
# Récupérer le nouveau settings.php
249
# 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.
250
# Supprimer du nouveau les informations spécifiques à un site :
251
 * base_url
252
 * Information de base de données
253
# Remplacer tous les settings.php (à la main ou via le scripts @d7-all-update-settings.sh@.
254 1 Julien Enselme
255
h2. Mise à jour Majeure
256
257 9 Julien Enselme
Une mise à jour majeure consiste à passer par exemple de drupal 6 à drupal 7. On parle aussi d'ugrade ou de migration.
258 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 !)
259
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 !
260
261
Voici la page de préparation de migration [[De Drupal6 vers Drupal7]]
262
263
264
h2. Mise à jour de la base de données
265
266
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.
267 20 Julien Enselme
268 1 Julien Enselme
h3. Mise à jour de la base de données avec drush
269
270
Il suffit de lancer, dans le dossier du site, la commande <code>drush updb</code>
271 20 Julien Enselme
272 1 Julien Enselme
h3. Mise à jour de la base de données à la main
273
274
Cette méthode utilise directement l'interface de drupal.
275
276
Il faut se rendre à l'adresse monsite/update.php et suivre les instructions.
277
278
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.
279
280
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.
281
282
En cas de doute, utiliser plutôt drush :p
283
284
h1. Gestion des traductions en français
285
286
h2. Méthode adoptée depuis D7
287 13 Julien Enselme
288 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 :
289
290
# Aller à http://localize.drupal.org/translate/languages/fr et télécharger le fichier .po de la dernière version drupal.
291 23 Julien Enselme
# Copier ce fichier dans profiles/standard/translations
292 1 Julien Enselme
# Renommer le fichier en fr.po
293
# Recharger la page d'installation, la langue française doit maintenant être disponible.
294
295
Exemple : 
296
<pre>
297
<code class="bash">
298
cd profiles/standard/translations
299
wget http://ftp.drupal.org/files/translations/7.x/drupal/drupal-7.13.fr.po
300
</code>
301
</pre>
302
303
h2. Ancienne méthode manuelle valable pour D6 et D7
304 13 Julien Enselme
305 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
306
307
h2. Maintenir les mises à jour des traductions
308 13 Julien Enselme
309 1 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)
310 19 Julien Enselme
311 1 Julien Enselme
h1. Changer le mot de passe de la base de données
312 19 Julien Enselme
313 14 Julien Enselme
h2. Sites dans la base de données unique
314 19 Julien Enselme
315
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.
316 1 Julien Enselme
317
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.
318 14 Julien Enselme
Voici le processus :
319
# modifier le mot de passe (il y a une commande sql toute faite pour ça, ou aller sur phpmyadmin)
320 38 Julien Enselme
# modifier la valeur du mot de passe dans les settings.php (utiliser les commandes détaillées dans le script [[Scripts_archives#ch_mdp|ch_mdp]])
321 1 Julien Enselme
# vérifier que les sites fonctionnent !
322
# modifier la valeur du mot de passe dans les settings.php de référence (présents sur le bureau du compte assos)
323
# 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]])
324 19 Julien Enselme
# vérifier que les sus-dits scripts fonctionnent
325
326
h2. Sites ayant une base de données séparées
327
328
Pour les sites ayant une base de données séparée, il faut distinguer deux choses :
329
* 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é.
330
* 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é.
331
332
h3. Mot de passe du compte assos
333
334
Pour changer ce mot de passe, suivre les étapes :
335
# Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande).
336
# Changer le mot de passe (se renseigner sur la procédure/commande avant).
337
# Prévenir les membres du club que le mot de passe a changé.
338
# Mettre à jour le fichier phpmyadmin.txt
339
340
h3. Mot de passe d’un site
341
342
Pour changer ce mot de passe, suivre les étapes :
343
# Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande).
344
# Changer le mot de passe (se renseigner sur la procédure/commande avant).
345 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é)
346
347
h1. Les scripts et tâches automatiques
348
349
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.
350 15 Julien Enselme
351 1 Julien Enselme
[[Scripts_et_taches_planifiees|La page suivante]] contient une documentation succinte du rôle de chacun.
352
353
h1. Administration plus avancée
354 18 Julien Enselme
355 1 Julien Enselme
h2. Choisir et implémenter la bonne méthode de téléchargement (drupal 6)
356 18 Julien Enselme
357 1 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).
358
359
Cela peut-être particulièrement important si les associatifs utilisent ce site pour partager des documents confidentiels (CR, etc).
360 18 Julien Enselme
361 1 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 !
362
363
Pour drupal 7, ceci est géré en natif et ne demande donc pas autant d'attention.
364
365
h2. Récupérer le nom de domaine officiel d'une association/club/service
366
367
h3. En quoi ça consiste ?
368
369
Une association possède un site en assos.centrale-marseille.fr/monasso et veut récupérer l'adresse monasso.centrale-marseille.fr.
370
371
Le but est de faire pointer la première adresse vers la seconde.
372
373 18 Julien Enselme
h3. Solution officielle
374 1 Julien Enselme
375
Elle permet de changer complètement l'adresse du site.
376
377
Pour drupal 6, il s'agit d'une solution en trois étapes, la deuxième à effectuer par le CRI.
378
379
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
380
381
Pour drupal7, se reporter au mail reçu par assos dont l'expéditeur est [[Noémie Lehuby]] le 28/02/2012.
382
383
h3. Solution rustine (à éviter)
384
385
Elle consiste en une redirection php :
386
387
On met le code suivant dans le index.php de monasso.centrale-marseille.fr
388
<pre>
389
<code class="php">
390
<?php		
391
		header( "Status: 301 Moved Permanently", false, 301);
392
		header("Location: http://assos.centrale-marseille.fr/monasso");
393
		exit();  
394
?>
395
</code>
396
</pre>
397
398
Quand on va alors sur : http://monasso.centrale-marseille.fr, l'url est réecrite  http://assos.centrale-marseille.fr/monasso
399
400
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
401
402
h2. Création d'un thème
403
404
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 !
405
La page suivante indique quelques possibilités (pour drupal 6) : [[Création de thème Drupal]]
406
407
h2. Personnalisation du settings.php
408
409
Il est possible de forcer la valeur de certaines variables drupal via le settings.php pour acter des configurations particulières.
410 18 Julien Enselme
411 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]]
412
413
La suite est laissée pour info, mais n'est plus valable !
414
415
h3. Gestion du cache
416
417
La team a remarqué que les webmaster ne réglent le cache de leur site que très rarement.
418
419
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.
420 18 Julien Enselme
421 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 :
422
<pre>
423
<code class="php">
424
/* ajout pour les caches */
425
//$conf['block_cache'] = 1;
426
$conf['cache'] = 1; // 1 is normal cache mode
427
$conf['cache_lifetime'] = 86400; // 0 is infinite
428
</code>
429
</pre>
430
Attention, les sites existant avant cette date n'ont pas ces lignes dans leur fichier setting.php
431
432
h3. Ne pas autoriser la mise à jour des modules via l'interface web (pour d7 uniquement)
433
434
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.
435 18 Julien Enselme
436 1 Julien Enselme
Pour enlever ce droits aux administrateurs des sites, il suffit d'ajouter cette ligne au fichier settings.php
437
438
<code class="php">
439
$conf['allow_authorize_operations'] = FALSE;
440
</code>
441 17 Julien Enselme
442 1 Julien Enselme
h1. Création de site : nom de dossier
443 17 Julien Enselme
444
* 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
445
446 1 Julien Enselme
 * nom du dossier du site : assos.centrale-marseille.fr.monsite
447 17 Julien Enselme
* la personne ou asso qui demande un site veut une URL en monsite.centrale-marseille.fr :
448
449
 * nom du dossier du site : assos.centrale-marseille.fr.monsite
450 1 Julien Enselme
 * un lien : monsite.centrale-marseille.fr -> assos.centrale-marseille.fr.monsite