Upgrade Luna to Maia

Warning

For Maia Debian was upgraded to Debian 12 (Bookworm).

Therefore:

the upgrade to Maia will take longer than usual

upgrade from older version than XiVO Izar (2022.05) are not supported (you need first to upgrade to a version above or equal to Izar before being able to upgrade to Maia).

Please read carefully Debian 12 (Bookworm) upgrade notes page.

Note also that upgrade to Debian 12 on MeetingRooms, Edge and XiVO CC is manual (see manual procedure below).

Before Upgrade 

On XiVO PBX 

N.A.

On XiVO CC 

The XiVO CC upgrade is now handled by the xivocc-upgrade script.
1. You need to install it manually to be able to use it:
```
xivo-dist xivo-maia
apt update
apt install xivocc-upgrade
```
2. Then follow the XiVO CC upgrade process as described in Upgrade to another LTS version

On MDS 

N.A.

On Edge 

Upgrade system to Debian 12 (Bookworm):

Rewrite the apt preferences for docker-ce

#set docker-ce preferences
cat > /etc/apt/preferences.d/docker-ce << EOF
Package: docker-ce*
Pin: version 5:25.0.5*
Pin-Priority: 1000

EOF

Remove docker-compose
```
rm -f /usr/local/bin/docker-compose
```

Install docker compose plugin

apt update
apt install docker-compose-plugin

Update bash alias to launch services:

sed -i 's/docker-compose/docker compose/g' ~/.bashrc
source ~/.bashrc

and then follow the Debian 12 upgrade manual procedure:

On Meeting Rooms 

Upgrade system to Debian 12 (Bookworm):

Rewrite the apt preferences for docker-ce

#set docker-ce preferences
cat > /etc/apt/preferences.d/docker-ce << EOF
Package: docker-ce*
Pin: version 5:25.0.5*
Pin-Priority: 1000

EOF

Remove docker-compose
```
rm -f /usr/local/bin/docker-compose
```

Install docker compose plugin

apt update
apt install docker-compose-plugin

Update bash alias to launch services:

sed -i 's/docker-compose/docker compose/g' ~/.bashrc
source ~/.bashrc

and then follow the Debian 12 upgrade manual procedure:

After Upgrade 

On XiVO PBX 

Upgrade: the upgrade deactivated all apt sources list except those needed for XiVO (xivo, debian, docker, postgres). After the upgrade you might need to reactivate some custom sources list you had. Please make sure that they are compatible with Debian 12.
If you customized your directories, upgrade them so they match the new display filter. Default directories (xivodir, internal) have been automatically upgraded to match the new Display filter variable. Check out internal matching the xivo directory (internal xivo users) and xivodir for the phonebook contacts. You can reduce the value mapping to what stands as default, and/or update your customization.

On MDS 

Upgrade: the upgrade deactivated all apt sources list except those needed for XiVO (xivo, debian, docker, postgres). After the upgrade you might need to reactivate some custom sources list you had. Please make sure that they are compatible with Debian 12.

On XiVO CC 

Upgrade system to Debian 12 (Bookworm) with the following manual procedure:

On Edge 

Ensure you correctly replaced the alias edge-dcomp as stated in the documentation.

On Meeting Rooms 

Ensure you correctly replaced the alias meetingrooms-dcomp as stated in the documentation.

Upgrade to Debian12 

These steps are to be done before an upgrade from Luna to Maia on XiVO CC, Edge and Meeting Rooms:

Check GRUB before upgrading

install_device=$(debconf-show grub-pc | grep 'grub-pc/install_devices:' | cut -b3- | cut -f2 -d' ' | cut -d',' -f1)
if [ "$install_device" -a ! -e "$install_device" ]; then
  echo -e "\e[1;31mYou must install GRUB BEFORE upgrading\e[0m"
fi

If it’s broken you can fix it this way before rechecking

apt update
apt install grub-pc
dpkg-reconfigure grub-pc

Check you are in Debian 11 (we prevent upgrade from Debian 10 - see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=993755#62)

if [ "$(cut -d '.' -f 1 /etc/debian_version)" -ne 11 ]; then
  echo -e "\e[1;31mYou are not in Debian 11. Please upgrade first to Debian 11\e[0m"
  echo -e "\e[1;31mSee Helios to Izar Upgrade page.\e[0m"
fi

Upgrade to Debian12

# Move to bookworm
sed -i 's/bullseye/bookworm/' /etc/apt/sources.list /etc/apt/sources.list.d/*.list
apt update

export DEBIAN_FRONTEND=noninteractive
export APT_LISTCHANGES_FRONTEND=none
force_yes="--allow-downgrades --allow-remove-essential --allow-change-held-packages"

echo "Download packages..."
apt full-upgrade -d --yes
echo "Executing full upgrade actions..."
apt full-upgrade --yes ${force_yes} -o Dpkg::Options::="--force-confnew"
apt autoremove --yes

Reboot