Utilisation de Drupal multi-site » Historique » Version 90
Julien Enselme, 28/03/2015 19:01
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 | 78 | Julien Enselme | NB : pour créer un site (entre autres), vous aurez besoin de vous connecter au compte assos en ssh. Voir la [[Acces_assos|page dédiée]]. |
6 | 1 | Julien Enselme | h2. Méthode Drupal 7 |
7 | 1 | Julien Enselme | |
8 | 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.)}} |
9 | 1 | Julien Enselme | |
10 | 20 | Julien Enselme | h3. Création du site drupal 7 |
11 | 1 | Julien Enselme | |
12 | 55 | Julien Enselme | # Vérifier qu'il n'y a pas de fichiers modifiés/ajoutés en attente avec @git status@ |
13 | 79 | Julien Enselme | # Dans drupal7/sites créer un nouveau dossier nommé _assos.centrale-marseille.fr.nomdusite_. Le _nomdusite_ doit faire moins de 16 caractères et ne pas contenir le caractère '-'. Ce sera ce qu'on appelle par la suite le dossier du site. |
14 | 84 | Julien Enselme | # Créer le lien symbolique à la racine du serveur pour qu'il ne cherche pas les sous-sites dans un sous dossier : @ln -s . nomdusite@ (à exécuter dans drupal7). |
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 | 1 | Julien Enselme | ## Par exemple : |
19 | 79 | Julien Enselme | <pre><code class="php"> |
20 | 79 | Julien Enselme | for i in {1..4} ; do |
21 | 82 | Julien Enselme | touch auto/d7/assos.centrale-marseille.fr.camara/$(date "+%Y-%m-%d-%Hh%Mm%Ss").assos.centrale-marseille.fr.camara.sql$i |
22 | 79 | Julien Enselme | done |
23 | 79 | Julien Enselme | </code></pre> |
24 | 79 | Julien Enselme | # Se connecter sur phpmyadmin sur le serveur myassos (dans la liste déroulante) avec le login assos (le mdp est accessible uniquement aux membres du club). |
25 | 79 | Julien Enselme | # Créer une nouvelle base de donnée et un nouvel utilisateur nommés _nomdusite_ via User > add user. |
26 | 53 | Julien Enselme | ## Renseigner son nom. |
27 | 1 | Julien Enselme | ## Générer un mot de passe aléatoire et le conserver (il est à renseigner dans le settings.php). |
28 | 53 | Julien Enselme | ## Dans _database for user_, cocher _Create database with same name and grant all privileges_. |
29 | 53 | Julien Enselme | ## Laisser toutes les autres options par défaut. |
30 | 1 | Julien Enselme | ## Valider |
31 | 1 | Julien Enselme | # On configure le settings.php qui contient toutes les variables indispensables au bon fonctionnement de drupal. |
32 | 79 | Julien Enselme | ## Se placer dans le dossier _nomdusite_ |
33 | 53 | Julien Enselme | ## Copier-coller le fichier d7-settings.php (présent dans le dossier template) dans le dossier du site. |
34 | 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) |
35 | 53 | Julien Enselme | ## Copier-coller le fichier d7-settings-local-template.php |
36 | 53 | Julien Enselme | ## Renommer ce fichier en settings.local.php (il contient les infos sur la base de données) |
37 | 1 | Julien Enselme | ## Remplacer %%DBUSER%%, %%DBNAME%% et %%SITE_NAME%% par _nomdusite_ |
38 | 79 | Julien Enselme | ## Remplacer %%DBPASS%% par le mot de passe généré précédemment. |
39 | 79 | Julien Enselme | # Ajouter à la fin du fichier @~/drupal7/sites/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. |
40 | 79 | Julien Enselme | # Ajouter dans le fichier @~/.drush/aliases.drushrc.php@ la ligne correspondant au site : |
41 | 53 | Julien Enselme | ## dans 'site-list' : @'assos.centrale-marseille.fr/$site_name',@ |
42 | 53 | Julien Enselme | ## à la fin du fichier : @$aliases['$site_name'] = array('uri' => 'assos.centrale-marseille.fr/SITE_NAME', 'root' => '/users/guest/assos/htmltest/', );@ |
43 | 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. |
44 | 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. |
45 | 36 | Julien Enselme | # Lancer le script _d7-reset-variables.sh_ dans le dossier du site. |
46 | 1 | Julien Enselme | # Mettre les bons droits sur les dossiers/fichiers entrer ces commandes dans le répertoire htmltest/sites |
47 | 79 | Julien Enselme | ## @chmod -R u=rwX,go=rX DOSSIER_DU_SITE@ |
48 | 79 | Julien Enselme | ## @chmod 400 DOSSIER_DU_SITE/settings.php@ |
49 | 80 | Julien Enselme | # Mettre à jour la map de nginx avec @d7-generate-nginx-map.sh@ ou à la main en : |
50 | 80 | Julien Enselme | ## ajoutant la ligne suivante dans le fichier @~/nginx_map@ |
51 | 80 | Julien Enselme | <pre>~*^assos.centrale-marseille.fr/nomdusite/.*$ /nomdusite;</pre> |
52 | 80 | Julien Enselme | ## **Entre $ et /nomdusite, il faut mettre une tabulation**. |
53 | 81 | Julien Enselme | ## **Cette URL doit être insérée dans le fichier de telle sorte que les URLs sont dans l'ordre anté-alphabétique.** |
54 | 80 | Julien Enselme | ## Si l'URL du site est un sous domaine (forum.centrale-marseille.fr) cette opération est inutile. Le but est en effet de transmettre à PHP-FPM le bon nom de site. Sans ceci, on tombe systématiquement sur default. |
55 | 80 | Julien Enselme | # Redémarrer nginx avec @sudo service nginx restart@ |
56 | 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"@ |
57 | 35 | Julien Enselme | |
58 | 55 | Julien Enselme | |
59 | 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.)}} |
60 | 20 | Julien Enselme | |
61 | 1 | Julien Enselme | h3. Trucs à faire sur le site juste après l’ouverture du site drupal 7 |
62 | 1 | Julien Enselme | |
63 | 20 | Julien Enselme | * Conseiller à l'administrateur de ne pas laisser les inscriptions ouvertes à son site |
64 | 1 | Julien Enselme | * Donner à l'administrateur le lien des tutoriels écrits par le club Drupal |
65 | 5 | Julien Enselme | * Créer un contenu de type "Site" sur la page du projet multiassos |
66 | 36 | Julien Enselme | * Inscrire à la liste de diffusion webmasters@listes.centrale-marseille.fr |
67 | 1 | Julien Enselme | |
68 | 20 | Julien Enselme | h2. Script de création de site drupal 7 |
69 | 1 | Julien Enselme | |
70 | 83 | Julien Enselme | Un script de création de site est également disponible source:bin/d7-create-site.sh. Pour obtenir de l'aide sur son utilisation : @d7-create-site.sh -h@ ou lire le début du script. |
71 | 1 | Julien Enselme | |
72 | 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. |
73 | 1 | Julien Enselme | |
74 | 6 | Julien Enselme | h2. Quelques informations sur le pourquoi du comment |
75 | 1 | Julien Enselme | |
76 | 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). |
77 | 1 | Julien Enselme | |
78 | 1 | Julien Enselme | Lorsqu'un site est appelé avec l'url http://assos.centrale-marseille.fr/nomdusite, les actions suivantes sont effectuées : |
79 | 85 | Julien Enselme | * Se rendre dans drupal7 et chercher un dossier nommé _nomdusite_. C'est la raison pour laquelle il faut avoir un lien symbolique dans html nommé _nomdusite_. |
80 | 85 | 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 ... drupal7 ! |
81 | 85 | Julien Enselme | * Une fois dans ce dossier (donc toujours dans drupal7), chercher un fichier <code>index.php</code> |
82 | 85 | Julien Enselme | * S'il n'est pas trouvé, c'est foutu, sinon le lire. En l'occurrence, ce fichier est présent dans drupal7 et créé par Drupal. On rentre donc dans le champ d'action de drupal. |
83 | 6 | Julien Enselme | * Chercher dans l'installation drupal un dossier nommé assos.centrale-marseille.fr.nomdusite |
84 | 85 | Julien Enselme | * Si trouvé, rentrer dedans et lire le <code>settings.php</code> et @settings.local.php@ |
85 | 6 | Julien Enselme | * Si tout va bien, afficher le site :) |
86 | 1 | Julien Enselme | |
87 | 85 | Julien Enselme | Les 4 premières sont dues à la structure du serveur fourni par le CRI (Le lien symbolique dans drupal7 n'est donc pas forcément nécessaire si on installe drupal sur un autre serveur par exemple). |
88 | 1 | Julien Enselme | |
89 | 1 | Julien Enselme | Le reste est du domaine de drupal. |
90 | 1 | Julien Enselme | |
91 | 1 | Julien Enselme | h1. Suppression d'un sous site |
92 | 1 | Julien Enselme | |
93 | 55 | Julien Enselme | # Vérifier qu'il n'y a pas de fichiers modifiés/ajoutés en attente avec @git status@ |
94 | 37 | Julien Enselme | # Supprimer la base de données du site et l’utilisateur dans phpmyadmin, via l’onglet _Users_ : |
95 | 53 | Julien Enselme | ## Trouver l’utilisateur |
96 | 53 | Julien Enselme | ## Dans _ Remove selected users_, cocher _Drop the databases that have the same names as the users._ |
97 | 53 | Julien Enselme | ## Valider |
98 | 1 | Julien Enselme | # Supprimer le dossier créé dans htmltest/sites en se redonnant les droits (si nécessaire) |
99 | 49 | Julien Enselme | # Supprimer la ligne du site dans le sites.php |
100 | 37 | Julien Enselme | # Supprimer les deux lignes du site dans .drush/aliases.drushrc.php |
101 | 37 | Julien Enselme | # Supprimer les sauvegardes de base données |
102 | 53 | Julien Enselme | ** dans individual/auto/d7/NOM_DU_SITE |
103 | 53 | Julien Enselme | ** dans individual/manual/d7/NOM_DU_SITE |
104 | 7 | Julien Enselme | # Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher _État du site_ |
105 | 86 | Julien Enselme | # Supprimer la ligne du site dans nginx_map (on peut utiliser source:bin/d7-generate-nginx-map.sh. |
106 | 86 | Julien Enselme | # Redémarrer nginx : @sudo nginx restart@. |
107 | 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"@ |
108 | 37 | Julien Enselme | |
109 | 37 | Julien Enselme | {{note(Les utilisateurs se retirent eux même de la liste webmaster)}} |
110 | 1 | Julien Enselme | |
111 | 68 | Benjamin Luce | h1. Changer l'adresse d'un site existant. |
112 | 68 | Benjamin Luce | |
113 | 69 | Benjamin Luce | {{note(On notera site1 le nom du site à changer et le nouveau nom site2)}} |
114 | 68 | Benjamin Luce | |
115 | 1 | Julien Enselme | h2. Renommer la base de données et le nom d'utilisateur de mysql |
116 | 1 | Julien Enselme | |
117 | 1 | Julien Enselme | # Se connecter sur phpMyAdmin via la page "Outils":https://outils.centrale-marseille.fr de l'école. |
118 | 1 | Julien Enselme | ## Rentrer l'identifiant et le mot de passe |
119 | 1 | Julien Enselme | ## Le serveur à choisir est myassos. |
120 | 87 | Julien Enselme | # Chercher le nom de site à changer dans le menu de gauche. |
121 | 75 | Julien Enselme | # Dans la liste des sites à gauche, chercher site1 et cliquer dessus. |
122 | 75 | Julien Enselme | # Dans l'onglet utilisateur de la barre de navigation, il faut supprimer l'ancien administrateur site1 puis en créer un nouveau site2. Ne pas oublier de générer un mot de passe. |
123 | 75 | Julien Enselme | # Aller ensuite dans le menu SQL de phpMyAdmin et exécuter : <code class="SQL">GRANT ALL PRIVILEGES ON Site2.* TO 'Site'@'%' IDENTIFIED BY 'Mot-de-passe-du-site'</code>. |
124 | 72 | Benjamin Luce | |
125 | 75 | Julien Enselme | {{important(Il faudra conserver ce mot de passe tout le long de la manipulation.)}} |
126 | 75 | Julien Enselme | |
127 | 73 | Benjamin Luce | h2. S'occuper de Drupal |
128 | 73 | Benjamin Luce | |
129 | 75 | Julien Enselme | Ouvrir un terminal et se connecter sur webassos si ce n'est déjà fait. |
130 | 75 | Julien Enselme | |
131 | 75 | Julien Enselme | {{note(Si vous n'avez pas @vim@ sur votre console, un @nano@ ou @emac@ feront très bien l'affaire :))}} |
132 | 75 | Julien Enselme | |
133 | 68 | Benjamin Luce | # Renommer le dossier du site : @mv drupal7/sites/assos.centrale-marseille.fr/Site1 drupal7/sites/assos.centrale-marseille.fr/Site2@ |
134 | 74 | Benjamin Luce | # Mettre à jour le sites.php (dans drupal7/sites/sites.php). |
135 | 64 | Benjamin Luce | ** Remplacer Site1 par Site2. |
136 | 75 | Julien Enselme | {{important(Ne pas oublier d'enregistrer. Néanmoins, il se peut que celui-ce ne se fasse pas : c'est un problème d'écriture. Un @chmod +w sites.php@ ou encore @:w!@ sur vim vous permettra de pallier cette difficulté. Il est cependant primordial de faire, si vous avez utilisé @chmod@, un @chmod 400 sites.php@ à la fin pour rétablir les droits.)}} |
137 | 75 | Julien Enselme | # Mettre à jour les aliases drush (dans @~/.drush/aliases.drushrc.php@). |
138 | 88 | Julien Enselme | ** Remplacer Site1 par Site2 (deux fois !) |
139 | 75 | Julien Enselme | # Et encore un coup sur la configuration local du site2 : @vim drupal7/sites/assos.centrale-marseille.site2/settings.local.php@ et on enregistre. Il ne faut pas oublier de remplacer le mot de passe à l'endroit qui convient. |
140 | 75 | Julien Enselme | # Allez courage c'est presque fini. Il faut ensuite regénérer la map Nginx des site avec @d7-generate-nginx-map.php@ puis relancer tout ce petit monde avec @sudo service nginx restart@ |
141 | 75 | Julien Enselme | # Modifier le lien symbolique à la racine de Drupal. |
142 | 75 | Julien Enselme | ## @cd ~/drupal7@ |
143 | 75 | Julien Enselme | ## @rm Site1@ |
144 | 75 | Julien Enselme | ## @ln -s . Site2@ |
145 | 75 | Julien Enselme | # Quelques petites commandes pour réparer les petits problèmes : |
146 | 75 | Julien Enselme | ** <code>drush @site2 cc all</code> pour vider les caches (cc pour cache-clear). |
147 | 1 | Julien Enselme | ** <code>drush @site2 vget temporary_path</code> pour vérifier les chemins d'accès si les problèmes persistent. |
148 | 88 | Julien Enselme | ** <code>drush @site2 vget public_path</code> pour vérifier les chemins d'accès si les problèmes persistent. |
149 | 88 | Julien Enselme | ** <code>drush @site2 vget private_path</code> pour vérifier les chemins d'accès si les problèmes persistent. |
150 | 88 | Julien Enselme | ** Ces chemins se modifient soit avec @drush vset@ soit via l'interface dans _Configuration > Media > Système de fichiers_ |
151 | 75 | Julien Enselme | # Commiter les changements : |
152 | 75 | Julien Enselme | ## @git status@ et @git diff@ pour voir ce qui a changé. |
153 | 75 | Julien Enselme | ## @git add -A ~@ pour ajouter les modifications. |
154 | 75 | Julien Enselme | ## @git commit@ pour prendre en compte. |
155 | 75 | Julien Enselme | |
156 | 77 | Benjamin Luce | h1. Transférer un site de test vers un site officiel déjà existant et vice-versa |
157 | 77 | Benjamin Luce | |
158 | 77 | Benjamin Luce | {{note(On notera site1 le nom du site à remplacer et le site à copier site2)}} |
159 | 77 | Benjamin Luce | {{important(site1 et site2 correspondent à un chemin complet par rapport à l'endroit où vous vous trouvez dans l'arborescence donc un <code> pwd </code> pourra être utile si vous êtes perdus :))}} |
160 | 77 | Benjamin Luce | |
161 | 89 | Julien Enselme | # On copie intelligemment le dossier /files de site2 à la place du /files du site1 : <code>rsync -avx --delete site2/files site1/files</code>. En cas de problème, récupérer les fichiers depuis une snapshot @/home/.zfs/snapshot@ |
162 | 77 | Benjamin Luce | # On sauvegarde la base de données de site1 (en lui donnant un nom) dans /tmp (ou ~/tmp) en cas d'erreur : <code>drush @site1 sql-dump > /tmp/site1.sql</code> |
163 | 77 | Benjamin Luce | # On détruit la base de données de site1 : <code>drush @site1 sql-drop</code> |
164 | 77 | Benjamin Luce | # On transfère la base de données de site2 vers site1 (avec un tuyau ou pipe en anglais !) : <code>drush @site2 sql-dump | drush @site1 sql-cli</code> |
165 | 77 | Benjamin Luce | # Il ne reste qu'à admirer le résultat. La dernière commande est un peu technique mais elle offre une puissance sans pareil, surtout quand on sait que pour faire la même opération cela nécessite parfois une heure de clics sur une interface... |
166 | 1 | Julien Enselme | |
167 | 8 | Julien Enselme | h1. Installation de module ou de thème |
168 | 1 | Julien Enselme | |
169 | 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. |
170 | 1 | Julien Enselme | |
171 | 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. |
172 | 1 | Julien Enselme | |
173 | 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 ! |
174 | 1 | Julien Enselme | |
175 | 1 | Julien Enselme | h2. Installation de module/thème à la main |
176 | 1 | Julien Enselme | |
177 | 1 | Julien Enselme | * Se rendre sur le site officiel de Drupal sur la page du projet |
178 | 1 | Julien Enselme | * Télécharger la source |
179 | 1 | Julien Enselme | * L'extraire |
180 | 1 | Julien Enselme | * Placer le dossier extrait dans le dossier sites/all/modules ou sites/all/themes en fonction du cas |
181 | 1 | Julien Enselme | * **Si** le dossier extrait comprend un fichier INSTALL.txt, le lire et suivre les éventuelles étapes complémentaires |
182 | 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é. |
183 | 1 | Julien Enselme | |
184 | 31 | Julien Enselme | h2. Installation de module/thème drush |
185 | 8 | Julien Enselme | |
186 | 1 | Julien Enselme | [[drush|Quelques explications sur Drush avant ?]] |
187 | 8 | Julien Enselme | |
188 | 76 | Julien Enselme | * Se rendre à la racine de l'installation via son terminal |
189 | 1 | Julien Enselme | * Taper la commande <code>drush dl projet</code> (où projet est le nom du thème ou module) |
190 | 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> |
191 | 1 | Julien Enselme | |
192 | 1 | Julien Enselme | h1. Suppression de module ou de thème |
193 | 45 | Julien Enselme | |
194 | 1 | Julien Enselme | Pour cela, le plus simple est d'utiliser le script d7-all-drush.sh. |
195 | 1 | Julien Enselme | |
196 | 45 | Julien Enselme | Il faut : |
197 | 45 | Julien Enselme | # désactiver le projet sur tous les sites : <code>d7-all-drush.sh dis projet</code> |
198 | 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> |
199 | 1 | Julien Enselme | # supprimer le dossier du projet dans le répertoire sites/all/modules ou sites/all/themes |
200 | 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. |
201 | 1 | Julien Enselme | |
202 | 27 | Julien Enselme | h1. Mises à jour |
203 | 9 | Julien Enselme | |
204 | 90 | Julien Enselme | {{warning(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.)}} |
205 | 1 | Julien Enselme | |
206 | 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 ! |
207 | 1 | Julien Enselme | |
208 | 1 | Julien Enselme | On distingue plusieurs types de mises à jour : |
209 | 1 | Julien Enselme | * les mises à jour de projet (projet = module ou thème) |
210 | 1 | Julien Enselme | * les mises à jour du noyau (core) de drupal |
211 | 1 | Julien Enselme | * les mises à jour majeures de drupal (migration) |
212 | 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 |
213 | 1 | Julien Enselme | |
214 | 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 ;) |
215 | 1 | Julien Enselme | |
216 | 9 | Julien Enselme | h2. Mise à jour d'un module ou d'un thème |
217 | 1 | Julien Enselme | |
218 | 1 | Julien Enselme | Pour notre installation drupal 7, il faudra effectuer quelque chose de similaire. |
219 | 1 | Julien Enselme | |
220 | 1 | Julien Enselme | Voici tout de même les méthodes pour effectuer ces mises à jour. |
221 | 20 | Julien Enselme | Toujours privilégier la méthode drush, les autres sont présentes uniquement pour info (ou si drush est planté :p) |
222 | 1 | Julien Enselme | |
223 | 1 | Julien Enselme | h3. Mise à jour d'un module ou d'un thème à la main |
224 | 1 | Julien Enselme | |
225 | 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. |
226 | 1 | Julien Enselme | # Supprimer l'ancienne version dans /users/guest/assos/html/sites/all/modules. |
227 | 1 | Julien Enselme | # Copier la nouvelle version dans /users/guest/assos/html/sites/all/modules. |
228 | 20 | Julien Enselme | # Faire la mise à jour de la base de données |
229 | 1 | Julien Enselme | |
230 | 31 | Julien Enselme | h3. Mise à jour d'un module ou d'un thème avec drush |
231 | 1 | Julien Enselme | |
232 | 1 | Julien Enselme | [[Drush|Quelques explications sur Drush avant ?]] |
233 | 1 | Julien Enselme | |
234 | 1 | Julien Enselme | Drush permet d'effectuer pour un site toutes les mises à jour des modules et des thèmes d'un seul coup. |
235 | 9 | Julien Enselme | |
236 | 9 | Julien Enselme | Rappel : |
237 | 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. |
238 | 1 | Julien Enselme | * Pour mettre un jour un site en particulier, se placer dans le dossier du site en question. |
239 | 1 | Julien Enselme | |
240 | 1 | Julien Enselme | Voici comment procéder : |
241 | 9 | Julien Enselme | # se placer (dans un terminal évidemment) dans le dossier du site |
242 | 9 | Julien Enselme | # lancer la commande <code>drush -y en update</code> pour activer la mise à jour |
243 | 9 | Julien Enselme | # lancer la commande <code>drush upc --no-core</code> |
244 | 9 | Julien Enselme | # si une mise à jour de la base de données est requise, lancer la commande <code>drush -y updb</code> |
245 | 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> |
246 | 1 | Julien Enselme | # lancer la commande <code>drush -y dis update</code> pour désactiver le module update |
247 | 9 | Julien Enselme | |
248 | 1 | Julien Enselme | NB : la commande <code>drush up</code> permet d'effectuer upc et updb en une seule fois ! |
249 | 1 | Julien Enselme | |
250 | 1 | Julien Enselme | h2. Mise à jour du noyau de Drupal |
251 | 59 | Julien Enselme | |
252 | 1 | Julien Enselme | Il s'agit par exemple de passer de drupal 7.X à drupal 7.Y |
253 | 20 | Julien Enselme | |
254 | 1 | Julien Enselme | h3. Mise à jour du noyau de Drupal à la main |
255 | 1 | Julien Enselme | |
256 | 1 | Julien Enselme | La méthode la plus complète est donnée dans le fichier UPGRADE.txt dans le dossier officiel de Drupal. |
257 | 1 | Julien Enselme | |
258 | 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 |
259 | 1 | Julien Enselme | # Faire une sauvegarde complète (base de données et dossiers) |
260 | 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. |
261 | 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. |
262 | 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" . |
263 | 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. |
264 | 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. |
265 | 1 | Julien Enselme | # Lancer le script de mise à jour de la base de données. |
266 | 1 | Julien Enselme | # Revenir au thème personnalisé du site (si ce n'est pas Garland). |
267 | 1 | Julien Enselme | # Supprimer CHANGELOG.TXT de l'installation |
268 | 62 | Julien Enselme | # Mettre à jour les settings.php |
269 | 1 | Julien Enselme | # Commiter les changements : @git add -A drupalX && git commit -m "Udpate to 7.xx"@ |
270 | 60 | Julien Enselme | |
271 | 60 | Julien Enselme | {{Important(Ne pas oublier de commiter les changements.)}} |
272 | 59 | Julien Enselme | |
273 | 20 | Julien Enselme | h3. Mise à jour du noyau de Drupal avec drush (recommandé) |
274 | 1 | Julien Enselme | |
275 | 1 | Julien Enselme | Drush permet aussi d'effectuer ce type de mise à jour. |
276 | 1 | Julien Enselme | |
277 | 54 | Julien Enselme | Rappel : |
278 | 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). |
279 | 1 | Julien Enselme | * Pour mettre un jour un site en particulier, se placer dans le dossier du site en question. |
280 | 1 | Julien Enselme | |
281 | 1 | Julien Enselme | Pour ceci : |
282 | 22 | Julien Enselme | # Faire une sauvegarde complète (base de données et dossiers) |
283 | 22 | Julien Enselme | # Effectuer la mise à jour des projets |
284 | 22 | Julien Enselme | # Lancer la commande <code>drush -y en update</code> pour activer l'update sur tous les sites. |
285 | 22 | Julien Enselme | # Lancer la commande <code>drush upc drupal</code> |
286 | 12 | Julien Enselme | # Lancer <code>drush updb</code> pour faire la mise à jour de la base de données. |
287 | 1 | Julien Enselme | # Lancer la commande <code>drush -y dis update</code> pour désactiver l'update sur tous les sites. |
288 | 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]]) |
289 | 62 | Julien Enselme | # Mettre à jour les settings.php |
290 | 60 | Julien Enselme | # Commiter les changements : @git add -A drupalX && git commit -m "Udpate to 7.xx"@ |
291 | 60 | Julien Enselme | |
292 | 39 | Julien Enselme | {{Important(Ne pas oublier de commiter les changements.)}} |
293 | 39 | Julien Enselme | |
294 | 39 | Julien Enselme | h3. Mise à jour des settings.php |
295 | 39 | Julien Enselme | |
296 | 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 : |
297 | 39 | Julien Enselme | |
298 | 39 | Julien Enselme | * settings.php : fichier qui contient toutes les variables communes à tous les sites, c’est lui que l’on va mettre à jour. |
299 | 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é. |
300 | 39 | Julien Enselme | |
301 | 39 | Julien Enselme | Pour mettre à jour un settings.php, il faut : |
302 | 39 | Julien Enselme | # Récupérer le nouveau settings.php |
303 | 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. |
304 | 53 | Julien Enselme | # Supprimer du nouveau les informations spécifiques à un site : |
305 | 53 | Julien Enselme | ** base_url |
306 | 39 | Julien Enselme | ** Information de base de données |
307 | 1 | Julien Enselme | # Remplacer tous les settings.php (à la main ou via le scripts @d7-all-update-settings.sh@. |
308 | 1 | Julien Enselme | |
309 | 1 | Julien Enselme | h2. Mise à jour Majeure |
310 | 9 | Julien Enselme | |
311 | 1 | Julien Enselme | Une mise à jour majeure consiste à passer par exemple de drupal 6 à drupal 7. On parle aussi d'ugrade ou de migration. |
312 | 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 !) |
313 | 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 ! |
314 | 1 | Julien Enselme | |
315 | 1 | Julien Enselme | Voici la page de préparation de migration [[De Drupal6 vers Drupal7]] |
316 | 1 | Julien Enselme | |
317 | 1 | Julien Enselme | |
318 | 1 | Julien Enselme | h2. Mise à jour de la base de données |
319 | 1 | Julien Enselme | |
320 | 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. |
321 | 1 | Julien Enselme | |
322 | 1 | Julien Enselme | h3. Mise à jour de la base de données avec drush |
323 | 1 | Julien Enselme | |
324 | 20 | Julien Enselme | Il suffit de lancer, dans le dossier du site, la commande <code>drush updb</code> |
325 | 1 | Julien Enselme | |
326 | 1 | Julien Enselme | h3. Mise à jour de la base de données à la main |
327 | 1 | Julien Enselme | |
328 | 1 | Julien Enselme | Cette méthode utilise directement l'interface de drupal. |
329 | 1 | Julien Enselme | |
330 | 1 | Julien Enselme | Il faut se rendre à l'adresse monsite/update.php et suivre les instructions. |
331 | 1 | Julien Enselme | |
332 | 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. |
333 | 1 | Julien Enselme | |
334 | 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. |
335 | 1 | Julien Enselme | |
336 | 1 | Julien Enselme | En cas de doute, utiliser plutôt drush :p |
337 | 1 | Julien Enselme | |
338 | 1 | Julien Enselme | h1. Gestion des traductions en français |
339 | 1 | Julien Enselme | |
340 | 1 | Julien Enselme | h2. Méthode adoptée depuis D7 |
341 | 13 | Julien Enselme | |
342 | 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 : |
343 | 1 | Julien Enselme | |
344 | 1 | Julien Enselme | # Aller à http://localize.drupal.org/translate/languages/fr et télécharger le fichier .po de la dernière version drupal. |
345 | 23 | Julien Enselme | # Copier ce fichier dans profiles/standard/translations |
346 | 1 | Julien Enselme | # Renommer le fichier en fr.po |
347 | 1 | Julien Enselme | # Recharger la page d'installation, la langue française doit maintenant être disponible. |
348 | 1 | Julien Enselme | |
349 | 1 | Julien Enselme | Exemple : |
350 | 1 | Julien Enselme | <pre> |
351 | 1 | Julien Enselme | <code class="bash"> |
352 | 1 | Julien Enselme | cd profiles/standard/translations |
353 | 1 | Julien Enselme | wget http://ftp.drupal.org/files/translations/7.x/drupal/drupal-7.13.fr.po |
354 | 1 | Julien Enselme | </code> |
355 | 1 | Julien Enselme | </pre> |
356 | 59 | Julien Enselme | |
357 | 13 | Julien Enselme | h2. Ancienne méthode manuelle |
358 | 1 | Julien Enselme | |
359 | 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 |
360 | 1 | Julien Enselme | |
361 | 13 | Julien Enselme | h2. Maintenir les mises à jour des traductions |
362 | 1 | Julien Enselme | |
363 | 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) |
364 | 19 | Julien Enselme | |
365 | 19 | Julien Enselme | h1. Changer le mot de passe de la base de données |
366 | 19 | Julien Enselme | |
367 | 19 | Julien Enselme | Pour les sites ayant une base de données séparée, il faut distinguer deux choses : |
368 | 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é. |
369 | 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é. |
370 | 19 | Julien Enselme | |
371 | 19 | Julien Enselme | h3. Mot de passe du compte assos |
372 | 19 | Julien Enselme | |
373 | 19 | Julien Enselme | Pour changer ce mot de passe, suivre les étapes : |
374 | 19 | Julien Enselme | # Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande). |
375 | 19 | Julien Enselme | # Changer le mot de passe (se renseigner sur la procédure/commande avant). |
376 | 19 | Julien Enselme | # Prévenir les membres du club que le mot de passe a changé. |
377 | 19 | Julien Enselme | # Mettre à jour le fichier phpmyadmin.txt |
378 | 19 | Julien Enselme | |
379 | 19 | Julien Enselme | h3. Mot de passe d’un site |
380 | 19 | Julien Enselme | |
381 | 19 | Julien Enselme | Pour changer ce mot de passe, suivre les étapes : |
382 | 19 | Julien Enselme | # Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande). |
383 | 1 | Julien Enselme | # Changer le mot de passe (se renseigner sur la procédure/commande avant). |
384 | 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é) |
385 | 1 | Julien Enselme | |
386 | 1 | Julien Enselme | h1. Les scripts et tâches automatiques |
387 | 1 | Julien Enselme | |
388 | 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. |
389 | 1 | Julien Enselme | |
390 | 1 | Julien Enselme | [[Scripts_et_taches_planifiees|La page suivante]] contient une documentation succinte du rôle de chacun. |
391 | 1 | Julien Enselme | |
392 | 1 | Julien Enselme | h1. Administration plus avancée |
393 | 1 | Julien Enselme | |
394 | 1 | Julien Enselme | h2. Récupérer le nom de domaine officiel d'une association/club/service |
395 | 1 | Julien Enselme | |
396 | 1 | Julien Enselme | h3. En quoi ça consiste ? |
397 | 1 | Julien Enselme | |
398 | 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. |
399 | 1 | Julien Enselme | |
400 | 1 | Julien Enselme | Le but est de faire pointer la première adresse vers la seconde. |
401 | 18 | Julien Enselme | |
402 | 1 | Julien Enselme | h3. Solution officielle |
403 | 1 | Julien Enselme | |
404 | 1 | Julien Enselme | Elle permet de changer complètement l'adresse du site. |
405 | 1 | Julien Enselme | |
406 | 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. |
407 | 1 | Julien Enselme | |
408 | 1 | Julien Enselme | h3. Solution rustine (à éviter) |
409 | 1 | Julien Enselme | |
410 | 1 | Julien Enselme | Elle consiste en une redirection php : |
411 | 1 | Julien Enselme | |
412 | 1 | Julien Enselme | On met le code suivant dans le index.php de monasso.centrale-marseille.fr |
413 | 1 | Julien Enselme | <pre> |
414 | 1 | Julien Enselme | <code class="php"> |
415 | 1 | Julien Enselme | <?php |
416 | 1 | Julien Enselme | header( "Status: 301 Moved Permanently", false, 301); |
417 | 1 | Julien Enselme | header("Location: http://assos.centrale-marseille.fr/monasso"); |
418 | 1 | Julien Enselme | exit(); |
419 | 1 | Julien Enselme | ?> |
420 | 1 | Julien Enselme | </code> |
421 | 1 | Julien Enselme | </pre> |
422 | 1 | Julien Enselme | |
423 | 1 | Julien Enselme | Quand on va alors sur : http://monasso.centrale-marseille.fr, l'url est réecrite http://assos.centrale-marseille.fr/monasso |
424 | 1 | Julien Enselme | |
425 | 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 |
426 | 1 | Julien Enselme | |
427 | 1 | Julien Enselme | h2. Personnalisation du settings.php |
428 | 1 | Julien Enselme | |
429 | 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. |
430 | 18 | Julien Enselme | |
431 | 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]] |
432 | 1 | Julien Enselme | |
433 | 1 | Julien Enselme | La suite est laissée pour info, mais n'est plus valable ! |
434 | 1 | Julien Enselme | |
435 | 1 | Julien Enselme | h3. Gestion du cache |
436 | 1 | Julien Enselme | |
437 | 1 | Julien Enselme | La team a remarqué que les webmaster ne réglent le cache de leur site que très rarement. |
438 | 1 | Julien Enselme | |
439 | 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. |
440 | 1 | Julien Enselme | |
441 | 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 : |
442 | 1 | Julien Enselme | <pre> |
443 | 1 | Julien Enselme | <code class="php"> |
444 | 1 | Julien Enselme | /* ajout pour les caches */ |
445 | 1 | Julien Enselme | //$conf['block_cache'] = 1; |
446 | 1 | Julien Enselme | $conf['cache'] = 1; // 1 is normal cache mode |
447 | 1 | Julien Enselme | $conf['cache_lifetime'] = 86400; // 0 is infinite |
448 | 1 | Julien Enselme | </code> |
449 | 1 | Julien Enselme | </pre> |
450 | 1 | Julien Enselme | Attention, les sites existant avant cette date n'ont pas ces lignes dans leur fichier setting.php |
451 | 59 | Julien Enselme | |
452 | 18 | Julien Enselme | h3. Ne pas autoriser la mise à jour des modules via l'interface web |
453 | 1 | Julien Enselme | |
454 | 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. |
455 | 1 | Julien Enselme | |
456 | 1 | Julien Enselme | Pour enlever ce droits aux administrateurs des sites, il suffit d'ajouter cette ligne au fichier settings.php |
457 | 1 | Julien Enselme | |
458 | 17 | Julien Enselme | <code class="php"> |
459 | 1 | Julien Enselme | $conf['allow_authorize_operations'] = FALSE; |
460 | 17 | Julien Enselme | </code> |
461 | 17 | Julien Enselme | |
462 | 17 | Julien Enselme | h1. Création de site : nom de dossier |
463 | 1 | Julien Enselme | |
464 | 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 |
465 | 17 | Julien Enselme | ** nom du dossier du site : assos.centrale-marseille.fr.monsite |
466 | 53 | Julien Enselme | * la personne ou asso qui demande un site veut une URL en monsite.centrale-marseille.fr : |
467 | 53 | Julien Enselme | ** nom du dossier du site : assos.centrale-marseille.fr.monsite |
468 | 1 | Julien Enselme | ** un lien : monsite.centrale-marseille.fr -> assos.centrale-marseille.fr.monsite |