====== Backdrop CMS ======
Sources :
[[https://docs.backdropcms.org/documentation/updates-vs-upgrades|Updates vs Upgrades]]

===== Mises à jour =====
==== Core update ====
La mise à jour du Core effectue également celle des modules compris dans la distribution. Tous les éléments concernés figurent dans le sous-répertoire //core// de l'archive de mise à jour.
Si d'autres fichiers((Tels.htaccess, robots.txt, settings.php…)) doivent également être mis à jour, ils seront indiqués dans les notes de mise à jour (release notes).
  - lire les [[https://backdropcms.org/project/backdrop/releases|notes de mise à jour]] (mise à jour possible de certains fichiers((settings.php, .htaccess, robots.txt…)) en dehors du //Core//)
  - passer le site en mode maintenance
  - dans le root directory,
    - renommer le répertoire //core// en //core-old//
    - effectuer une sauvegarde du répertoire de configuration, selon le schéma actif((Tel que défini dans la section //Configuration storage// du fichier //settings.php//.)) :
      - répertoire //config// hors DocumentRoot
      - sous-répertoire ~/files/config_[hash-code]
  - dans un répertoire temporaire
    - télécharger l'archive de mise à jour (.zip)
    - extraire l'archive %%>>>%% entraîne la création du répertoire "backdrop"
    - déplacer le sous répertoire "core" dans le root directory
  - lancer la mise à jour : https://mon-site/core/update.php
  - si tout s'est bien passé
    - supprimer les sauvegarde du //core// et de la configuation: core-old et config.tgz
    - supprimer l'archive de mise à jour et son extraction
    - remettre le site en mode consultation
=== Commandes typiques ===
À adapter au contexte d'hébergement.
<code>
cd ~user/domains/domain.tld/tmp
wget https://github.com/backdrop/backdrop/releases/download/x.yy.z/backdrop.zip
unzip backdrop.zip
mv ../public_html/core ../public_html/core-old
mv backdrop/core/ ../public_html/
tar czf config.tgz ../config
          tar czf config.tgz ../public_html/files/config_[hash-code]   /// avant 1.30.0
    ////// si OK après update.php effectué
rm -Rf backdrop backdrop.zip config.tgz ../public_html/core-old
</code>

==== Modules update ====
Sauf mention particulière, les modules se mettent à jour par une simple suppression du répertoire ad hoc et remplacement par le répertoire extrait.

Pour des modules légers tels que //mimemail//, //site_map// et //xmlsitemap//, le plus simple est de les téléverser manuellement.

La procédure est alors la suivante :
  - passer le site en mode maintenance
  - depuis la page des mises à jour, télécharger les zip sur le poste de travail
    - si le serveur de mise à jour est H.S. aller sur la [[https://backdropcms.org/modules|page des modules]] de //Backdrop CMS//
  - extraire localement les contenus des zip (chaque zip contient un répertoire éponyme)
  - lire la documentation
  - sur le serveur, supprimer (rm -Rf <liste> les répertoires obsolètes cd ~user/domains/domain.tld/public_html/modules
  - copier les répertoires des mises à jour depuis le poste de travail sur le serveur.
  - actualiser la page des mises à jour
  - remettre le site en mode consultation

=== Commandes typiques ===

À adapter au contexte d'hébergement. Ici, en téléchargement sur le serveur sans passer par la station de travail.

<code>
cd ~user/domains/domain.tld/public_html/modules
ls -d */
rm -R <liste des répertoires de modules à mettre à jour>
cd ~user/domains/domain.tld/tmp
              //// pour tous les modules à mettre à jour
wget <url du zip du module>
unzip module.zip -d ../public-html/modules
</code>