Utilisation de Drupal multi-site » Historique » Version 1
Version 1/107
-
Suivant » -
Version actuelle
Julien Enselme, 04/04/2013 17:16
import et adaptation de la syntaxe
- Contenu
- 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
- Copier-coller le fichier setting.php ( présent sur le bureau d'assos) dans le dossier précedemment créé
- Se donner des droits d'écriture sur le settings.php (chmod +w settings.php ou clic droit, propriétés, permissions, si vous utilisez l'interface Gnome)
- Modifier les lignes 93 et 125 du settings.php :
- Créer un lien symbolique via le terminal
- Lancer l'installation du site en allant sur l'url : http://assos.centrale-marseille.fr/nomdusite/install.php On aura alors [http://ginfo.centrale-marseille.fr/wiki/install.jpg la page suivante]. Si ça ne marche pas, c'est qu'il y a une erreur dans les étapes précédentes : recommencer scrupuleusement.
- 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.
- Retirer les droits d'écriture sur le settings.php
- 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.
- Copier-coller le fichier settings-D7-bddinde.php ( présent sur le bureau d'assos) dans le dossier précedemment créé.
- Renommer ce fichier en settings.php
- Se connecter sur phpmyadmin sur le serveur myassos (dans la liste déroulante) avec le login assos, le mdp.
- 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.
- Modifier la ligne 185 de ce fichier settings.php en y ajoutant le nomdusite en database.
- Créer un lien symbolique via le terminal
- Lancer l'installation du site en allant sur l'url :http://assos.centrale-marseille.fr/nomdusite/install.php
- 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.
- Activer piwik l’outil de statistiques 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.
- aller sur phpmyadmin : https://cri.ec-m.fr/phpmyadmin/?server%3d1
- Faire une sauvegarde de la base de données
- Supprimer toutes les tables associées dans la base de données ( /!\ Bien regarder les tables que l'on supprime !)
- Supprimer le dossier créé dans html/sites en se redonnant les droits (si nécessaire)
- Supprimer le lien symbolique dans html (ou htmltest).
- Retirer l'administrateur du sous-site de la liste Drupal
- Supprimer ce site du crontab s'il y est (commande = crontab -l pour le voir / crontab -e pour l'éditer => [[http://fr.wikipedia.org/wiki/Crontab]])
- Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher État du site
- aller sur phpmyadmin : https://cri.ec-m.fr/phpmyadmin/?server%3d1
- Faire une sauvegarde de la base de données
- Supprimer la base de données du site
- Supprimer le dossier créé dans html/sites en se redonnant les droits (si nécessaire)
- Supprimer le lien symbolique dans html (ou htmltest).
- Mettre à jour le site default.
- Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher ''État du site''
- Retirer l'administrateur du sous-site de la liste Drupal
- Supprimer ce site du crontab s'il y est (commande = crontab -l pour le voir / crontab -e pour l'éditer => [[http://fr.wikipedia.org/wiki/Crontab]])
- désactiver le projet sur tous les sites : drushall dis projet
- 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) : drushall pm-uninstall projet
- supprimer le dossier du projet dans le répertoire sites/all/modules ou sites/all/themes
- 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.
- Supprimer l'ancienne version dans /users/guest/assos/html/sites/all/modules.
- Copier la nouvelle version dans /users/guest/assos/html/sites/all/modules.
- Faire la mise à jour de la base de données
- se placer (dans un terminal évidemment) dans le dossier du site
- lancer la commande "drushall en update" pour activer la mise à jour
- lancer la commande "drushall upc --no-core"
- si une mise à jour de la base de données est requise, lancer la commande "drushall updb"
- s'il y avait des mises à jour de thème, nettoyer le cache pour que les modifications soient prises en compte ; lancer la commande drushall cc all
- lancer la commande "drushall dis update" pour désactiver le module update
- Faire une sauvegarde complète (base de données et dossiers)
- Revenir au thème de base Garland (si ce n'est déjà pas le cas) le temps de transférer les mises à jours.
- 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.
- 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" .
- 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.
- 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.
- Lancer le script de mise à jour de la base de données
- Revenir au thème personnalisé du site (si ce n'est pas Garland).
- Supprimer CHANGELOG.TXT de l'installation
- Faire une sauvegarde complète (base de données et dossiers)
- Effectuer la mise à jour des projets
- Lancer la commande "drushall_atest en update -y" pour activer l'update sur tous les sites.
- Lancer la commande "drushall upc drupal"
- Faire la mise à jour de la base de données (lancer "drushall updb")
- Lancer la commande "drushall_atest dis update -y" pour désactiver l'update sur tous les sites.
- Penser à remettre la traduction en Français ! (Voir paragraphe ci-dessous Gestion des traductions en français)
- Aller à http://localize.drupal.org/translate/languages/fr et télécharger le fichier .po de la dernière version drupal.
- Copier ce fichier dans profiles/standard/translations
- Recharger la page d'installation, la langue française doit maintenant être disponible.
- modifier le mot de passe (il y a une commande sql toute faite pour ça )
- modifier la valeur du mot de passe dans les settings.php (utiliser le script ch_mdp)
- vérifier que les sites fonctionnent !
- modifier la valeur du mot de passe dans les settings.php de référence (présents sur le bureau du compte assos)
- modifier la valeur du mot de passe dans les scripts qui l'utilisent ( jeter un coup d'oeil ici)
- vérifier que les sus-dits scripts fonctionnent
h1. Création d'un sous site
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 ( ssh assos@sas1.centrale-marseille.fr) soit une interface graphique (cf [http://assos.centrale-marseille.fr/ginfo/content/linux-avoir-acc%C3%A8s-%C3%A0-mon-r%C3%A9pertoire-depuis-chez-moi les tuto sur le site du Ginfo]).
h2. Méthode drupal 6
Attention | A priori on ne fait plus de sites drupal 6 actuellement
h3. Création du site
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¶
Copier-coller le fichier setting.php ( présent sur le bureau d'assos) dans le dossier précedemment créé¶
Se donner des droits d'écriture sur le settings.php (chmod +w settings.php ou clic droit, propriétés, permissions, si vous utilisez l'interface Gnome)¶
Modifier les lignes 93 et 125 du settings.php :¶
$db_prefix = 'nomdusite_';
$base_url = 'http://assos.centrale-marseille.fr/nomdusite';
Le préfixe est utilisé pour différentier les tables d'un même site dans la base de données.
Créer un lien symbolique via le terminal¶
(dans le répertoire html)
ln -s . nomdusite
Lancer l'installation du site en allant sur l'url : http://assos.centrale-marseille.fr/nomdusite/install.php On aura alors [http://ginfo.centrale-marseille.fr/wiki/install.jpg la page suivante]. Si ça ne marche pas, c'est qu'il y a une erreur dans les étapes précédentes : recommencer scrupuleusement.¶
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.¶
Retirer les droits d'écriture sur le settings.php¶
h3. Trucs à faire sur le site juste après son ouverture
- 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.
- Conseiller à l'administrateur de ne pas laisser les inscriptions ouvertes à son site (voir admin/user/settings)
- Réfléchir à la méthode de téléchargement à utiliser
- Donner à l'administrateur le lien des tutoriels écrits par le club Drupal
h3. Référencement du site
- ajouter le site à la page d'accueil du projet (site default d6)
- ajouter le site sur superadmin
- inscrire l'administrateur du site sur la liste de diffusion drupal
h2. Méthode Drupal 7
Attention | 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.
h3. Création du site
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.¶
Copier-coller le fichier settings-D7-bddinde.php ( présent sur le bureau d'assos) dans le dossier précedemment créé.¶
Renommer ce fichier en settings.php¶
Se connecter sur phpmyadmin sur le serveur myassos (dans la liste déroulante) avec le login assos, le mdp.¶
Attention | le point 5 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.
Merci de s'informer sur l'avancement de cette réflexion avant de créer un site.
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.¶
Modifier la ligne 185 de ce fichier settings.php en y ajoutant le nomdusite en database.¶
Créer un lien symbolique via le terminal¶
(dans le répertoire htmltest)
ln -s . nomdusite
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.
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.¶
Activer piwik l’outil de statistiques 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.¶
drush dl piwik # une fois seulement hein
drush -y vset piwik_site_id "XXX"
drush -y vset piwik_url_http "http://piwik.centrale-marseille.fr/"
drush -y vset piwik_url_https "https://piwik.centrale-marseille.fr/"
Active le cache local du javascript
drush -y vset piwik_cache 1
drush -y vset piwik_visibility_roles "1"
Active les stats pour anonymous et authentifié
drush -y vset --format=json piwik_roles '{"1":0,"2":0}'
drush -y vset piwik_page_title_hierarchy 1
Si la recherche locale est activée
drush -y vset piwik_site_search 1
On active le module
drush -y en piwik
Les statistiques sont disponibles sur https://piwik.centrale-marseille.fr/ Voir les archives de la liste assos ou dgeo pour les pass.
h3. Trucs à faire sur le site juste après son ouverture
- Lancer, dans le dossier du site, le script init_var.sh afin d'initialiser quelques variables et configurations. Pour plus d'info, consulter ce paragraphe
- Conseiller à l'administrateur de ne pas laisser les inscriptions ouvertes à son site
- Donner à l'administrateur le lien des tutoriels écrits par le club Drupal
h3. Référencement du site
- créer un contenu de type "Site" sur la page du projet multiassos
- inscrire l'administrateur du site sur la liste de diffusion drupal
h2. Script de création de site
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.
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.
h2. Quelques info sur le pourquoi du comment
Si la méthode est périmée, voici quelques info pour la réparer (se rapprocher de dgeo en cas de souci).
Lorsqu'un site est appelé avec l'url http://assos.centrale-marseille.fr/nomdusite, les actions suivantes sont effectuées :
- 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.
- 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 !
- Une fois dans ce dossier (donc toujours dans html), chercher un fichier index.php
- 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
- chercher dans l'installation drupal un dossier nommé assos.centrale-marseille.fr.nomdusite
- si trouvé, rentrer dedans et lire le settings.php
- si tout va bien, afficher le site :)
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).
Le reste est du domaine de drupal.
h1. Suppression d'un sous site
h3. Ancienne méthode (base de donnée unique)
Attention | ne doit plus être utilisé
aller sur phpmyadmin : https://cri.ec-m.fr/phpmyadmin/?server%3d1¶
Faire une sauvegarde de la base de données¶
Supprimer toutes les tables associées dans la base de données ( /!\ Bien regarder les tables que l'on supprime !)¶
Supprimer le dossier créé dans html/sites en se redonnant les droits (si nécessaire)¶
Supprimer le lien symbolique dans html (ou htmltest).¶
Retirer l'administrateur du sous-site de la liste Drupal¶
Supprimer ce site du crontab s'il y est (commande = crontab -l pour le voir / crontab -e pour l'éditer => [[http://fr.wikipedia.org/wiki/Crontab]])¶
Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher État du site¶
h3. Nouvelle méthode
aller sur phpmyadmin : https://cri.ec-m.fr/phpmyadmin/?server%3d1¶
Faire une sauvegarde de la base de données¶
Supprimer la base de données du site¶
Supprimer le dossier créé dans html/sites en se redonnant les droits (si nécessaire)¶
Supprimer le lien symbolique dans html (ou htmltest).¶
Mettre à jour le site default.¶
Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher ''État du site''¶
Retirer l'administrateur du sous-site de la liste Drupal¶
Supprimer ce site du crontab s'il y est (commande = crontab -l pour le voir / crontab -e pour l'éditer => [[http://fr.wikipedia.org/wiki/Crontab]])¶
h1. Installation de module ou de thème
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.
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.
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 !
h2. Méthode à la main
- Se rendre sur le site officiel de Drupal sur la page du projet
- Télécharger la source
- L'extraire
- Placer le dossier extrait dans le dossier sites/all/modules ou sites/all/themes en fonction du cas
- Si le dossier extrait comprend un fichier INSTALL.txt, le lire et suivre les éventuelles étapes complémentaires
- 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é.
h2. Méthode avec drush
[[Utilisation_de_Drupal_multi-site#Appendice_:_Quelques_techniques_Drush | Quelques explication sur Drush avant ?]]
- Se rendre dans le dossier d'un site de l'installation via son terminal
- Taper la commande "drush dl projet" (où projet est le nom du thème ou module)
- Activer sur un site le nouveau module ou thème pour vérifier que ça marche bien (drush en projet)
h1. Suppression de module ou de thème
Pour cela, le plus simple est d'utiliser le script drushall.
Il faut :
désactiver le projet sur tous les sites : drushall dis projet¶
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) : drushall pm-uninstall projet¶
supprimer le dossier du projet dans le répertoire sites/all/modules ou sites/all/themes¶
h1. Mises à jour
Attention | il ne faut jamais renommer les modules et thèmes en vue de les sauvegarder ! les sauvegardes doivent se faire à l'extérieur du répertoire accessible par web toujours ! il en est de même pour les sauvegardes des bases de données
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 !
On distingue plusieurs types de mises à jour :
- les mises à jour de projet (projet = module ou thème)
- les mises à jour du noyau (core) de drupal
- les mises à jour majeures de drupal (migration)
- 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
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 ;)
h2. Mise à jour d'un module ou d'un thème
Pour notre installation drupal 6, depuis fin 2010, les mises à jour sont effectuées automatiquement toutes les semaines grâce à un script et au crontab.
Pour notre installation drupal 7, il faudra effectuer quelque chose de similaire.
Voici tout de même les méthodes pour effectuer ces mises à jour.
Toujours privilégier la méthode drush, les autres sont présentes uniquement pour info (ou si drush est planté :p)
h3. Méthode à la main
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.¶
Supprimer l'ancienne version dans /users/guest/assos/html/sites/all/modules.¶
Copier la nouvelle version dans /users/guest/assos/html/sites/all/modules.¶
Faire la mise à jour de la base de données¶
h3. Méthode avec drush
[[Utilisation_de_Drupal_multi-site#Appendice_:_Quelques_techniques_Drush | Quelques explication sur Drush avant ?]]
Drush permet d'effectuer pour un site toutes les mises à jour des modules et des thèmes d'un seul coup.
Pour mettre un jour un site en particulier, se placer dans le dossier du site en question et remplacer drushall par drush. Pour les sites sous Drupal 7, remplacer drushall par drushall_atest.
Voici comment procéder :
se placer (dans un terminal évidemment) dans le dossier du site¶
lancer la commande "drushall en update" pour activer la mise à jour¶
lancer la commande "drushall upc --no-core"¶
si une mise à jour de la base de données est requise, lancer la commande "drushall updb"¶
s'il y avait des mises à jour de thème, nettoyer le cache pour que les modifications soient prises en compte ; lancer la commande drushall cc all¶
lancer la commande "drushall dis update" pour désactiver le module update¶
NB : la commande drushall up permet d'effectuer upc et updb en une seule fois !
Rappel : Pour effectuer cette opération sur tous les sites, remplacer drush par drushall.
h2. Mise à jour du noyau de Drupal
Il s'agit par exemple de passer de drupal 6.X à drupal 6.Y
h3. Méthode à la main
La méthode la plus complète est donnée dans le fichier UPGRADE.txt dans le dossier officiel de Drupal.
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
Faire une sauvegarde complète (base de données et dossiers)¶
Revenir au thème de base Garland (si ce n'est déjà pas le cas) le temps de transférer les mises à jours.¶
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.¶
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" .¶
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.¶
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.¶
Lancer le script de mise à jour de la base de données¶
Revenir au thème personnalisé du site (si ce n'est pas Garland).¶
Supprimer CHANGELOG.TXT de l'installation¶
h3. Méthode avec drush
Drush permet aussi d'effectuer ce type de mise à jour.
Pour mettre un jour un site en particulier, se placer dans le dossier du site en question et remplacer drushall par drush. Pour les sites sous Drupal 7, remplacer drushall par drushall_atest.
Pour ceci :
Faire une sauvegarde complète (base de données et dossiers)¶
Effectuer la mise à jour des projets¶
Lancer la commande "drushall_atest en update -y" pour activer l'update sur tous les sites.¶
Lancer la commande "drushall upc drupal"¶
Faire la mise à jour de la base de données (lancer "drushall updb")¶
Lancer la commande "drushall_atest dis update -y" pour désactiver l'update sur tous les sites.¶
Penser à remettre la traduction en Français ! (Voir paragraphe ci-dessous Gestion des traductions en français)¶
h2. Mise à jour Majeure
Une mise à jour majeure consiste à passer par exemple de drupal 6 à drupal 7. On parle aussi d'ugrade ou de migration.
Attention, c'est une tâche lourde qui nécessite de la préparation ... beaucoup de préparation (au moins 6 mois !)
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 !
Voici la page de préparation de migration De Drupal6 vers Drupal7
h2. Mise à jour de la base de données
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.
h3. Méthode avec drush
Il suffit de lancer, dans le dossier du site, la commande drush updb
h3. Méthode à la main
Cette méthode utilise directement l'interface de drupal.
Il faut se rendre à l'adresse monsite/update.php et suivre les instructions.
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.
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.
En cas de doute, utiliser plutôt drush :p
h1. Gestion des traductions en français
h2. Méthode adoptée depuis D7
À 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 :
Aller à http://localize.drupal.org/translate/languages/fr et télécharger le fichier .po de la dernière version drupal.¶
Copier ce fichier dans profiles/standard/translations¶
Recharger la page d'installation, la langue française doit maintenant être disponible.¶
Exemple :
cd profiles/standard/translations
wget http://ftp.drupal.org/files/translations/7.x/drupal/drupal-7.13.fr.po
h2. Ancienne méthode manuelle valable pour D6 et D7
Pour traduire un site, l'administrateur devra suivre le tutoriel : http://assos.centrale-marseille.fr/content/traduire-mon-site-en-fran%C3%A7ais
h2. Maintenir les mises à jour des traductions
Du coté assos, un tâche planifiée cherche régulièrement si les traductions des sites est à jour et sinon les met effectivement à jour (Cf le crontab de assos)
h1. Changer le mot de passe de la base de données
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.
Voici le processus :
modifier le mot de passe (il y a une commande sql toute faite pour ça )¶
modifier la valeur du mot de passe dans les settings.php (utiliser le script ch_mdp)¶
vérifier que les sites fonctionnent !¶
modifier la valeur du mot de passe dans les settings.php de référence (présents sur le bureau du compte assos)¶
modifier la valeur du mot de passe dans les scripts qui l'utilisent ( jeter un coup d'oeil ici)¶
vérifier que les sus-dits scripts fonctionnent¶
h1. Les scripts et tâches automatiques
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.
La page suivante contient une documentation succinte du rôle de chacun.
h1. Quelques techniques Drush
Attention | drush n'est pas installé sur le compte assos mais seulement sur le sas
h2. C'est quoi ?
Drush signifie "drupal shell". C'est un utilitaire installé sur nos installations afin d'administrer nos sites en ligne de commande.
Pour avoir la liste des commandes les plus simples, taper drush dans un terminal, ou consulter cette [http://drupal.org/node/477684 page].
Pour effectuer une action, il faut au préalable se placer dans le dossier du site concerné, puis taper la commande drush.
h2. Quelques exemples simples
- drush en projet : permet d'activer le module ou le thème nommé projet
- drush dis projet : permet de désactiver le module ou le thème nommé projet
- drush pml : permet de lister les modules et les thèmes, leurs statuts (activé, désactivé, pas installé), et leurs versions
- drush pm-uninstall projet : permet de désinstaller le module ou le thème nommé projet
Rappel : désinstaller un projet = le désactiver + supprimer les tables de ce projet dans la base de données
- drush vget ma_variable : permet de récupérer la valeur actuelle de la variable nommée ma_variable
- drush vset ma_variable nvelle_valeur : permet de modifier la valeur de "ma_variable" en "nvelle_valeur'
NB : une variable est un champ de la table monsite_variables (dans la base de données).
On peut citer par exemple "theme_default" le thème par défaut du site ou "admin_theme" le thème de l'administration.
- drush cc all : permet de vider tous les caches
h2. Quelques commandes plus compliquées
h3. Gérer les utilisateurs
h4. Savoir qui administre un site
À partir de drupal 7 :
Cette commande permet de chercher dans la base de données les utilisateurs qui ont le "rid" numéro 3 (qui correspond au rôle d'administrateur (toujours) dans D7 à moins d'aller exprès dans la bdd le changer !)
drush sqlq "SELECT name, mail FROM nomdusite_users WHERE uid IN (SELECT uid FROM nomdusite_users_roles WHERE rid=3);"
h4. Obtenir des informations sur un utilisateur
Retourne, pour un login donné, l'uid, l'adresse mail, les rôles et le statut.
drush uinf mon_utilisateur
h4. Changer le mot de passe d'un utilisateur
Uniquement si problème de passation au niveau de l'administration d'un site, et sur demande explicite de celui-ci.
drush upwd mon_utilisateur --password="mon_nvo_mot-de-passe"
h4. Changer les rôles d'un utilisateur
Idem, uniquement sur demande explicite de celui-ci !
drush urol "administrator" mon_utilisateur : donne le rôle "administrator" à l'utilisateur mon_utilisateur
drush urrol "administrator" mon_utilisateur : retire le rôle "administrator" à l'utilisateur mon_utilisateur
h3. Revenir sur une mise à jour qui a échoué
Pour revenir sur une mise à jour, il faut rétablir la base de données telle qu'elle était avant la mise à jour.
Cela suppose évidemment d'avoir fait une sauvegarde de la base de donnée avant :p
Dans le cas d'une grosse base de données comme la notre, phpmyadmin n'est pas une solution viable, il faut donc utiliser directement le sql en ligne de commande ou drush, bien entendu ^
drush sqlq < ~/sauvegardes/12345.sql
C'est l'équivalent sql de :
mysql -h localhost -u root -p mabase < ~/sauvegardes/12345.sql
Explications : je me connecte au serveur "localhost" avec le nom d'utilisateur 'root' et je veux écraser la base de donnée 'mabase' en y injectant le code sql généré par ma sauvegarde dans le fichier ~/sauvegardes/12345.sql
NB : Pour écraser une base, assurez-vous d'avoir des "CREATE TABLE IF NOT EXISTS" dans le fichier de sauvegardes et non seulement "CREATE TABLE". Dans ce dernier cas, il faut supprimer les tables de la bdd avant d'injecter les fichiers sql.
h2. Les alias drush
h3. Les alias de sites
Les alias de sites permettent de lancer une commande drush sans être dans le dossier du site, en précisant le nom du site via un alias de la manière suivante :
drush @monsite status
Pour connaitre la liste de tous les alias et leur syntaxe exacte, lancer drush sa dans le dossier des sites.
NB : l'alias drush @sites permet de lancer la commande drush sur chacun des sites, et effectue une action similaire à notre script drushall sans pour autant le remplacer ...
h3. Les alias de scripts
Il est également possible de créer des commandes drush personnalisées en utilisant les alias. On peut alors regrouper plusieurs actions souvent effectuées à la suite, voire même des scripts entiers, dans une commande drush.
Voici la liste des alias drush créés par et pour le club drupal.
h2. Agir sur tous les sites d'un coup
Pour administrer tous les sites du multi-site en une seule fois, nous avons créé le script drushall. L'alias drush @sites peut également être utilisés dans certains cas.
h1. Administration plus avancée
h2. Choisir et implémenter la bonne méthode de téléchargement
À l'ouverture d'un site (en particulier pour des sites sans durée limitée, donc pour les associations, typiquement), 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 (oupa).
Cela peut-être particulièrement important si les associatifs utilisent ce site pour partager des documents confidentiels (CR, etc).
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 !
Pour en savoir plus sur ce problème en drupal 6, rdv à la page suivante !
Pour drupal 7, ceci est géré en natif et ne demande donc pas autant d'attention.
h2. Récupérer le nom de domaine officiel d'une association/club/service
h3. En quoi ça consiste ?
Une association possède un site en assos.centrale-marseille.fr/monasso et veut récupérer l'adresse monasso.centrale-marseille.fr.
Le but est de faire pointer la première adresse vers la seconde.
h3. Solution officielle
Elle permet de changer complètement l'adresse du site.
Pour drupal 6, il s'agit d'une solution en trois étapes, la deuxième à effectuer par le CRI.
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
Pour drupal7, se reporter au mail reçu par assos dont l'expéditeur est Noémie Lehuby le 28/02/2012.
h3. Solution rustine (à éviter)
Elle consiste en une redirection php :
On met le code suivant dans le index.php de monasso.centrale-marseille.fr
<?php
header( "Status: 301 Moved Permanently", false, 301);
header("Location: http://assos.centrale-marseille.fr/monasso");
exit();
?>
Quand on va alors sur : http://monasso.centrale-marseille.fr, l'url est réecrite http://assos.centrale-marseille.fr/monasso
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
h2. Création d'un thème
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 !
La page suivante indique quelques possibilités (pour drupal 6) : Création de thème Drupal
h2. Personnalisation du settings.php
Il est possible de forcer la valeur de certaines variables drupal via le settings.php pour acter des configurations particulières.
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. Plus d'info ici
La suite est laissée pour info, mais n'est plus valable !
h3. Gestion du cache
La team a remarqué que les webmaster ne réglent le cache de leur site que très rarement.
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.
Désormais le fichier setting.php du Desktop dont on part toujours pour la création rapide s'un site contient les lignes suivantes :
/* ajout pour les caches */
//$conf['block_cache'] = 1;
$conf['cache'] = 1; // 1 is normal cache mode
$conf['cache_lifetime'] = 86400; // 0 is infinite
Attention, les sites existant avant cette date n'ont pas ces lignes dans leur fichier setting.php
h3. Ne pas autoriser la mise à jour des modules via l'interface web (pour d7 uniquement)
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.
pour enlever ce droits aux administrateurs des sites, il suffit d'ajouter cette ligne au fichier settings.php
$conf['allow_authorize_operations'] = FALSE;
h1. Création de site: nom de dossier
- 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 :
- nom du dossier du site : assos.centrale-marseille.fr.monsite
- la personne ou asso qui demande un site veut une URL en monsite.centrale-marseille.fr :
- nom du dossier du site : assos.centrale-marseille.fr.monsite
- un lien : monsite.centrale-marseille.fr -> assos.centrale-marseille.fr.monsite
[[Catégorie: Club Drupal]][[Catégorie: Projet Multi-assos]]