Utilisation de Drupal multi-site » History » Revision 62
« Previous |
Revision 62/107
(diff)
| Next »
Julien Enselme, 05/09/2014 12:10 PM
h1. Création d'un sous site
- Table of contents
- Vérifier qu'il n'y a pas de fichiers modifiés/ajoutés en attente avec @git status@
- 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.
- Créer ce qu’il faut pour les sauvegardes :
- 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).
- Créer une nouvelle base de donnée et un nouvel utilisateur nommés nondusite via User > add user.
- On configure le settings.php qui contient toutes les variables indispensables au bon fonctionnement de drupal.
- Copier-coller le fichier d7-settings.php (présent dans le dossier template) dans le dossier du site.
- 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)
- Copier-coller le fichier d7-settings-local-template.php
- Renommer ce fichier en settings.local.php (il contient les infos sur la base de données)
- Remplacer %%DBPASS%% par le mot de passe généré ci-avant.
- Ajouter à la fin du fichier sites.php la ligne : @$sites['assos.centrale-marseille.fr.NOMDUSITE'] = 'assos.centrale-marseille.fr.NOMDUSITE@ ou si l’url est différente, remplacer le @'assos.centrale-marseille.fr.NOMDUSITE'@ de gauche par celle-ci.
- Ajouter dans le fichier ~/.drush/aliases.drushrc.php la ligne correspondant au site :
- 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 (également configurable après) et en créant un compte pour l'administrateur.
- Lancer le script d7-reset-variables.sh dans le dossier du site.
- Mettre les bons droits sur les dossiers/fichiers entrer ces commandes dans le répertoire htmltest/sites
- Commiter les changements pour qu'ils soient pris en compte dans git : @git commit -a -m "Creation of site: $d7_site_name"@
- Vérifier qu'il n'y a pas de fichiers modifiés/ajoutés en attente avec @git status@
- Supprimer la base de données du site et l’utilisateur dans phpmyadmin, via l’onglet Users :
- Supprimer le dossier créé dans htmltest/sites en se redonnant les droits (si nécessaire)
- Supprimer la ligne du site dans le sites.php
- Supprimer les deux lignes du site dans .drush/aliases.drushrc.php
- Supprimer les sauvegardes de base données
- Commiter les changements pour qu'ils soient pris en compte dans git : @git commit -a -m "Deletion of site: $d7_site_name"@
- supprimer le dossier du projet dans le répertoire sites/all/modules ou sites/all/themes
- vérifier que le module n'avait pas besoin d'une librairie dans le répertoire sites/all/libraries, la supprimer si besoin.
- 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 drush -y en update pour activer la mise à jour
- lancer la commande drush -y 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
- Mettre à jour les settings.php
- Commiter les changements : @git add -A drupalX && git commit -m "Udpate to 7.xx"@
- Faire une sauvegarde complète (base de données et dossiers)
- Effectuer la mise à jour des projets
- Lancer la commande drush -y en update pour activer l'update sur tous les sites.
- Lancer drush updb pour faire la mise à jour de la base de données.
- Lancer la commande drush -y dis update 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)
- Mettre à jour les settings.php
- Commiter les changements : @git add -A drupalX && git commit -m "Udpate to 7.xx"@
- Récupérer le nouveau settings.php
- 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.
- Supprimer du nouveau les informations spécifiques à un site :
- Remplacer tous les settings.php (à la main ou via le scripts @d7-all-update-settings.sh@.
- 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
- Renommer le fichier en fr.po
- Recharger la page d'installation, la langue française doit maintenant être disponible.
- Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande).
- Changer le mot de passe (se renseigner sur la procédure/commande avant).
- Prévenir les membres du club que le mot de passe a changé.
- Mettre à jour le fichier phpmyadmin.txt
- Se connecter au serveur de base de données myassos (via phpmyadmin ou en ligne de commande).
- Changer le mot de passe (se renseigner sur la procédure/commande avant).
- Modifier le settings.php (la partie de connexion à la base de données. Le script chmdp.sh ne devrait pas être utilisé)
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 "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).
h2. Méthode Drupal 7
{{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.)}}
h3. Création du site drupal 7
Vérifier qu'il n'y a pas de fichiers modifiés/ajoutés en attente avec @git status@¶
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.¶
Créer ce qu’il faut pour les sauvegardes :¶
Créer deux dossiers pour les sauvegardes individiuelles (automatiques et manuelles)¶
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.¶
Par exemple :¶
for i in {1..4} ; do
touch auto/d7/assos.centrale-marseille.fr.camara/`date "+%Y-%m-%d-%Hh%Mm%Ss"`.assos.centrale-marseille.fr.camara.sql$i
done
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).¶
Créer une nouvelle base de donnée et un nouvel utilisateur nommés nondusite via User > add user.¶
Renseigner son nom.¶
Générer un mot de passe aléatoire et le conserver (il est à renseigner dans le settings.php).¶
Dans database for user, cocher Create database with same name and grant all privileges.¶
Laisser toutes les autres options par défaut.¶
Valider¶
On configure le settings.php qui contient toutes les variables indispensables au bon fonctionnement de drupal.¶
Copier-coller le fichier d7-settings.php (présent dans le dossier template) dans le dossier du site.¶
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)¶
Copier-coller le fichier d7-settings-local-template.php¶
Renommer ce fichier en settings.local.php (il contient les infos sur la base de données)¶
Remplacer %%DBUSER%%, %%DBNAME%% et %%SITE_NAME%% par nomdusite
Remplacer %%DBPASS%% par le mot de passe généré ci-avant.¶
Ajouter à la fin du fichier sites.php la ligne : @$sites['assos.centrale-marseille.fr.NOMDUSITE'] = 'assos.centrale-marseille.fr.NOMDUSITE@ ou si l’url est différente, remplacer le @'assos.centrale-marseille.fr.NOMDUSITE'@ de gauche par celle-ci.¶
Ajouter dans le fichier ~/.drush/aliases.drushrc.php la ligne correspondant au site :¶
dans 'site-list' : @'assos.centrale-marseille.fr/$site_name',@¶
à la fin du fichier : @$aliases['$site_name'] = array('uri' => 'assos.centrale-marseille.fr/SITE_NAME', 'root' => '/users/guest/assos/htmltest/', );@¶
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 (également configurable après) et en créant un compte pour l'administrateur.¶
Lancer le script d7-reset-variables.sh dans le dossier du site.¶
Mettre les bons droits sur les dossiers/fichiers entrer ces commandes dans le répertoire htmltest/sites¶
chmod -R 755 DOSSIER_DU_SITE¶
chmod 400 DOSSIER_DU_SITE/settings.php¶
Commiter les changements pour qu'ils soient pris en compte dans git : @git commit -a -m "Creation of site: $d7_site_name"@¶
{{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.)}}
h3. Trucs à faire sur le site juste après l’ouverture du site drupal 7
- Conseiller à l'administrateur de ne pas laisser les inscriptions ouvertes à son site
- Donner à l'administrateur le lien des tutoriels écrits par le club Drupal
- Créer un contenu de type "Site" sur la page du projet multiassos
- Inscrire à la liste de diffusion webmasters@listes.centrale-marseille.fr
h2. Script de création de site drupal 7
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 informations sur le pourquoi du comment
Si la méthode est périmée, voici quelques informations 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
Vérifier qu'il n'y a pas de fichiers modifiés/ajoutés en attente avec @git status@¶
Supprimer la base de données du site et l’utilisateur dans phpmyadmin, via l’onglet Users :¶
Trouver l’utilisateur¶
Dans _ Remove selected users_, cocher Drop the databases that have the same names as the users.
Valider¶
Supprimer le dossier créé dans htmltest/sites en se redonnant les droits (si nécessaire)¶
Supprimer la ligne du site dans le sites.php¶
Supprimer les deux lignes du site dans .drush/aliases.drushrc.php¶
Supprimer les sauvegardes de base données¶
** dans individual/auto/d7/NOM_DU_SITE
** dans individual/manual/d7/NOM_DU_SITE
Actualiser les informations sur la liste des sites administrés : Éditer le type de contenu site et cocher État du site
Commiter les changements pour qu'ils soient pris en compte dans git : @git commit -a -m "Deletion of site: $d7_site_name"@¶
Les utilisateurs se retirent eux même de la liste webmaster
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. Installation de module/thème à 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