Upgrading to Debian 11 (Bullseye) - HT020EN

The upgrade from Wazo 23.05 (or earlier) to Wazo 23.06 (or later) will take longer than usual because the entire Debian system must be updated.

The database management system (PostgreSQL) will also be upgraded from version 11 to version 13 at the same time. This will upgrade the database used by Wazo.

After updating, the system will reboot.

Before Updating

• Back up your database and Wazo data. (ref. /var/backup/wazo/)
• Back up your stack (for example, create a "snapshot" image).
• Ensure that you have at least 15GB available on the system.
• If you have customized the Debian system of your Wazo in a non-trivial way, you may want to review the Debian release notes before upgrading. Most importantly, you should:
  
  • Remove packages that were automatically installed and are no longer needed by executing the command:
    
    • apt-get autoremove --purge
  • Purge the removed packages. You can see the list of packages in this state by executing the command: dpkg -l | awk '/^rc/ { print $2 }'' and purge all packages with the command:
    • apt-get purge $(dpkg -l | awk '/^rc/ { print $2 }')
  • Delete the files .dpkg-*, .ucf-* and .merge-errorfrom the previous upgrade. You can see a list of these files by executing the command:
    
    • find /etc -name '*.dpkg-*' -o -name '*.ucf-*' -o -name '*.merge-error'

Updating

The upgrade must be performed using three commands:

• wazo-upgrade: Install the script wazo-dist-upgrade and ensure the system is up to date
• wazo-dist-upgrade: Upgrades to the latest version of Wazo with Debian 11 (Bullseye). This upgrade will take longer than usual.

After the update

• Check that all the modifications you have made to your configuration files are still present and functioning correctly.
• During the upgrade, new versions of configuration files are installed and may overwrite your local modifications. (For example, the vim package provides a new file /etc/vim/vimrc. If you have customized this file, after the upgrade, you will have both a file /etc/vim/vimrc and a file /etc/vim/vimrc.dpkg-old, the first containing the new version of the file provided by the vim package, while the second is your customized version. You should merge your customizations with .dpkg-old.)
• You can see a list of affected files by executing find /etc -name '*.dpkg-old'.

  If some files appear and you have not modified them yourself, you can ignore them.

• Delete the removed packages. You can see the list of packages in this state by executing dpkg -l | awk '/^rc/ { print $2 }' and deleting them all apt-get purge $(dpkg -l | awk '/^rc/ { print $2 }').

• Restart your system. This is necessary for the new Linux kernel to take effect.

External Link

• Official Release notes Debian 11