Sources : Updates vs Upgrades

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¹⁾ doivent également être mis à jour, ils seront indiqués dans les notes de mise à jour (release notes).

1. lire les notes de mise à jour (mise à jour possible de certains fichiers²⁾ en dehors du Core)
2. passer le site en mode maintenance
3. dans le root directory,
   1. renommer le répertoire core en core-old
   2. effectuer une sauvegarde du répertoire de configuration, selon le schéma actif³⁾ :
      1. répertoire config hors DocumentRoot
      2. sous-répertoire ~/files/config_[hash-code]
4. dans un répertoire temporaire
   1. télécharger l'archive de mise à jour (.zip)
   2. extraire l'archive >>> entraîne la création du répertoire “backdrop”
   3. déplacer le sous répertoire “core” dans le root directory
5. lancer la mise à jour : https://mon-site/core/update.php
6. si tout s'est bien passé
   1. supprimer les sauvegarde du core et de la configuation: core-old et config.tgz
   2. supprimer l'archive de mise à jour et son extraction
   3. remettre le site en mode consultation

À adapter au contexte d'hébergement.

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

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 :

1. passer le site en mode maintenance
2. depuis la page des mises à jour, télécharger les zip sur le poste de travail
   1. si le serveur de mise à jour est H.S. aller sur la page des modules de Backdrop CMS
3. extraire localement les contenus des zip (chaque zip contient un répertoire éponyme)
4. lire la documentation
5. sur le serveur, supprimer (rm -Rf <liste> les répertoires obsolètes cd ~user/domains/domain.tld/public_html/modules
6. copier les répertoires des mises à jour depuis le poste de travail sur le serveur.
7. actualiser la page des mises à jour
8. remettre le site en mode consultation

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

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