Debian 10 ("Buster") devrait être publié @TODO@! Donc on veut faire des tests de mise à jour pendant quelque temps pour trouver tous les problèmes potentiels pour ensuite pouvoir upgrader en masse. Voici des notes et références pour la mise à jour.

Voir https://redmine.koumbit.net/projects/kt-sa-debian-upgrades pour la liste complète des mises à jour et des outils de suivi de la progression.

Sommaire des changements

Les changements importants de Buster sont bien documentés ici, mais on peut noter rapidement:

@TODO@

Le manuel de mise à jour inclus également les enjeux majeurs de mise à jour.

Upgrade process

Depuis les mises à jour à Lenny, des procédures détaillées sont maintenus par Koumbit, en parallèle avec la documentation officielle. La procédure de StretchUpgrade servira de base à celle de Buster ici.

Notez aussi que notre documentation vise principalement les serveurs. Par exemple, nous suivons la procédure de temps mort minimal. La procédure devrait tout de même pouvoir être utilisée pour les desktops.

Attention: cette procédure peut échouer si elle est roulée à partir de l'interface graphique, qui est redémarrée durant la procédure, selon cette note de Debian. TODO: Vérifier si c'est toujours un problème dans Buster.

Normalement, dans les premiers cycles de mise à jour, on documente surtout les problèmes avec les différents packages ensuite, on revoit la procédure de mise à jour pour de l'optimisation.

Pre-upgrade

  1. Take a look at this page's Problèmes rencontrés section to spot which applications will possibly have issues with the upgrade.

  2. inform users
  3. check to make sure the backup job will not start while the upgrade takes place!
  4. check backups on backup server
  5. If the server is a fresh jessie install, run  apt install ttyrec screen  and avoid the puppet and sudo's below

  6. Run in tmux and record the session
    • sudo ttyrec -e tmux /var/log/upgrade-buster.ttyrec
  7. Run puppet once to see if there's any outstanding issues. If so, try to fix them.
    • puppet agent -t
  8. backup configuration:
    • NEXT_RELEASE=buster
      cd /etc; git tag pre-${NEXT_RELEASE}
      git gc --prune # make /etc smaller for backup
      tar cfz /var/backups/pre-${NEXT_RELEASE}-backup.tgz /etc /var/lib/dpkg /var/lib/apt/extended_states /var/lib/aptitude/pkgstates # Note: it may be /var/lib/apt/extended_states in jessie, depending on installed software and history (?)
      dpkg --get-selections "*" > /var/backups/dpkg-selections-pre-${NEXT_RELEASE}.txt
      chmod 0600 /var/backups/pre-${NEXT_RELEASE}-backup.tgz /var/backups/dpkg-selections-pre-${NEXT_RELEASE}.txt
  9. Put servers in maintenance in Nagios.

Prepare and check system

  1. disable puppet, pinning and check for packages on hold or broken
    • puppet agent --disable upgrading system to buster # Disable puppet so it won't overwrite apt's config while we upgrade:
      rm /etc/apt/preferences /etc/apt/preferences.d/* #  Check for pinned (on hold) packages, and possibly disable
      rm /etc/apt/sources.list.d/testing.list # or other similar backports or sources from later releases
      apt-mark showhold
      dpkg --audit
  2. If keeping puppet 4.x, run this and then set profile::puppet::client::puppet_version to '4' in the node's hieradata

    @TODO fill this in
  3. Run any pending upgrade:
    • apt update && apt -y upgrade

Preparing sources.list

  1. This mostly means changing stretch to buster.

    • sed -i 's/stretch/buster/g' /etc/apt/sources.list /etc/apt/sources.list.d/stretch*
      rm /etc/apt/sources.list.d/stretch-backports.list

      Note that in some cases, additional sources are defined in /etc/apt/sources.list.d and that you should review these sources to ensure they are still relevant:

      ls /etc/apt/sources.list.d

      we want to keep the following APT repository sources:

      /etc/apt/sources.list.d/aegir-stable.list
      /etc/apt/sources.list.d/koumbit.list
      /etc/apt/sources.list.d/stretch* # as long they are actually buster on the inside

Upgrading the packages

  1. on physical servers: make sure the serial console works

  2. Update the package list and check disk space:
  3. Download packages:
    • apt -y -d upgrade && apt -y -d dist-upgrade
  4. Warn users of potential downtime, if relevant
    • look at the list of packages downloaded above to see if any key service may be disrupted

  5. preseed some answers:
    • debconf-set-selections <<EOF
      console-data    console-data/keymap/policy      select  Don't touch keymap
      localepurge     localepurge/use-dpkg-feature    boolean true
      libpam-runtime  libpam-runtime/override boolean false
      libnss-ldap     libnss-ldap/override    boolean false
      libpam-ldap     libpam-ldap/override    boolean false
      libc6   libraries/restart-without-asking        boolean true
      EOF
  6. Minimal upgrade run:
    • env DEBIAN_FRONTEND=noninteractive APT_LISTCHANGES_FRONTEND=mail apt upgrade -y -o Dpkg::Options::='--force-confdef' -o Dpkg::Options::='--force-confold'
  7. On physical servers (dom0):

    • xen packages for i386 platform do NOT exist since Jessie. If you are upgrading a 32bit system, ignore the purge command below and pin the xen packages to keep the ones from wheezy. (TODO we might want to change this recommendation to switch to KVM because keeping wheezy around in buster is really, really sketcy)

    • Using XEN/ganeti see their sections below for details #Xen #Ganeti

  8. Now you can safely reboot:
    • Pendant le reboot, utiliser la console série pour aller dans le BIOS et vérifier que la redirection série est configurée à "VT-UTF8" et non "VT-100".

      reboot
      sudo ttyrec -e tmux /var/log/upgrade-buster-phase2.ttyrec

      (TODO p-e que cette étape de reboot est inutile. il faudrait considérer la retirer) Les sysadmins de Debian font un seul reboot durant leur procédure, réviser la notre, particulièrement en révisant la procédure de temps mort minimal également.

  9. Upgrade the rest of the system:
    • env DEBIAN_FRONTEND=noninteractive APT_LISTCHANGES_FRONTEND=mail apt dist-upgrade -y -o Dpkg::Options::='--force-confdef' -o Dpkg::Options::='--force-confold'

Re-enable and run puppet!

  1. verify that puppet doesn't break anything:
    • puppet agent --enable; puppet agent -t --noop --no-report; puppet agent --disable verifications post-upgrade to buster
  2. Re-enable puppet if everything seems ok:
    • puppet agent --enable && puppet agent -t

Things to do after the upgrade

  1. Install the package koumbit-scripts if it's not already there:

    • apt-get install koumbit-scripts-vps
  2. check the updates on configuration files, by looking for .dpkg-* or .ucf-* files in /etc, or by using the clean_conflicts script in koumbit-scripts 1.2:

    • /opt/bin/clean_conflicts
  3. On dom0 servers, rerun grub and make sure the right drives are configured for a reboot

    • dpkg-reconfigure grub-pc
  4. Suivre tout les autres procédures applicables (voir la section plus bas)
  5. Remove obsolete packages

    • apt autoremove --purge
  6. Cleanup packages that are not in any current apt sources.
    • First have a look at the list of packages to be removed.
    • # list all packages not in any installed sources.
      aptitude search '?narrow(?not(?archive("^[^n][^o].*$")),?version(CURRENT))'
      • First look at the list to see if anything needs to be kept around. If so, remove other packages manually from that list.

      If (only if) everything can be removed, you can do so with one command:

      • # uninstall anything that shouldn't be kept around.
        aptitude purge '?narrow(?not(?archive("^[^n][^o].*$")),?version(CURRENT))'
  7. Empty apt cache
    • apt-get clean
      l
  8. Reboot one last time and monitor for problems in the boot sequence (lags, or errors, fsck, maybe console output failure)
    • reboot
  9. Vérfier qu'il y a assez d'espace restant pour que les backups aient lieux.
  10. Bien sûr, vérifier que les services offerts par la machine fonctionnent toujours. Tester les vrais services (e.g. accéder à une page web, faire un appel -- accéder à ce que chaque service est supposé offrir), et aussi vérifier l'état dans nagios.

  11. Vérifier les stats du serveur sur http://stats0.koumbit.net/

  12. Enlever le downtime dans nagios.
  13. Vérifier dans la file roots@rt.k.n si la file est spammé par des erreurs suite à votre mise à jour!

  14. update the wiki documentation to reflect the new release; you're now done!

Autres procédures

Finir upgrade Postgresql 9.6 -> 11

Faire celà pour enlèver l'ancien cluster.

  1. Lister les clusters postgres:

    pg_lsclusters
    # normalement 9.6 est commencé, est 11 est "down"
  2. Backup

    sudo -u postgres pg_dumpall > /tmp/pg9.6.backup
  3. Arrêt pgsql:

    service postgresql stop
  4. Upgrade cluster

    pg_upgradecluster -m upgrade 9.6 main
  5. Start mysql:

    service postgresql start
  6. List clusters

    pg_lsclusters
    # Normale 9.6 devrait être down, puis 11 up
  7. Test
  8. Enlèver l'ancienc cluster

     sudo pg_dropcluster 9.6 main --stop

Problèmes Recontrées

Références


CategoryDebian

BusterUpgrade (last edited 2019-02-11 22:55:58 by KienanStewart)