# Оновлення Proxmox VE 8 до версії 9: порядок дій і відкат

> Покроковий план оновлення Proxmox VE 8 до версії 9: перевірка кластера, зміна репозиторіїв APT, порядок вузлів і відкат.

Мажорне оновлення Proxmox VE змінює версію Debian під капотом, схему зберігання конфігурації і подекуди формат файлів віртуальних машин. Оновлення наосліп командою `apt full-upgrade` без підготовки — надійний спосіб отримати кластер без кворуму посеред робочого дня.

## Що змінюється при переході з Proxmox VE 8 на 9

Proxmox VE 9 переходить на новий реліз Debian, оновлює ядро Linux і версії QEMU, LXC та ZFS. Частина параметрів у файлах `/etc/pve/qemu-server/*.conf` і мережевих налаштуваннях може потребувати ручного виправлення після оновлення. Перш ніж оновлювати прод, прогоніть апгрейд на тестовому вузлі або окремій VM зі схожою конфігурацією.

## Підготовка кластера до оновлення

Перед стартом зробіть знімок конфігурації кластера і резервні копії критичних віртуальних машин через [Proxmox Backup Server](https://www.zevshost.net/uk/kb/proxmox-backup-server/). Потім запустіть штатний скрипт перевірки сумісності на кожному вузлі:

```
pve8to9 --full
```

Скрипт перевіряє версії пакетів, конфігурацію кластера, storage.cfg і мережеві мости, позначаючи проблеми мітками FAIL і WARN. Оновлення варто починати лише тоді, коли список FAIL порожній.

## Як перемкнути репозиторії APT на новий реліз

До запуску оновлення пакетів замініть посилання на репозиторії Proxmox і Debian у файлах джерел:

| Файл | Було | Стало |
| --- | --- | --- |
| /etc/apt/sources.list | bookworm | trixie |
| /etc/apt/sources.list.d/pve-enterprise.list | bookworm | trixie |
| /etc/apt/sources.list.d/ceph.list | quincy/bookworm | squid/trixie |

Після правки файлів оновіть індекс пакетів і переконайтеся, що немає помилок підключення до репозиторіїв:

```
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/pve-enterprise.list
apt update
```

## У якому порядку оновлювати вузли кластера

Оновлення кластера триває по одному вузлу за раз, щоб кворум не зникав ні на секунду:

1. Перенесіть віртуальні машини з вузла, що оновлюється, на сусідні за допомогою [живої міграції](https://www.zevshost.net/uk/kb/proxmox-migration-live/) або через вебінтерфейс.
2. Вимкніть служби HA для вузла або переведіть його в режим обслуговування.
3. Оновіть пакети та перезавантажте вузол, дочекайтеся повернення в кластер і появи зеленого статусу кворуму.
4. Поверніть віртуальні машини на оновлений вузол і переходьте до наступного.

## Як оновити пакети та перезавантажити вузол

Саме встановлення пакетів виконується двома командами поспіль, між якими варто перевірити журнал на помилки залежностей:

```
apt full-upgrade
reboot
```

Після перезавантаження перевірте версію через `pveversion` і статус служб `pve-cluster`, `pvedaemon` та `corosync`. Якщо вузол не входить у кластер за 2-3 хвилини, дивіться журнал `journalctl -u corosync` щодо розсинхронізації версій протоколу.

## План відкату, якщо оновлення пішло не так

- Якщо вузол не завантажився, виберіть попереднє ядро в меню GRUB — старі версії ядра не видаляються автоматично під час оновлення.
- Якщо зламалась мережа, відновіть файл `/etc/network/interfaces` із резервної копії, знятої перед оновленням.
- Якщо пакетний менеджер завис посередині операції, виконайте `dpkg --configure -a` і повторіть `apt full-upgrade`.
- Якщо вузол не підлягає відновленню, розгорніть віртуальні машини на справному вузлі з резервної копії PBS і виключіть проблемний вузол із кластера.

## Чек-лист після оновлення кластера

Оновлення Proxmox VE 8 до версії 9 вважається завершеним, коли виконано всі пункти:

- Усі вузли показують однакову версію у виведенні `pveversion`.
- Кворум кластера зібрано, статус corosync зелений на всіх вузлах.
- Усі віртуальні машини та контейнери запущені та відповідають на пінг.
- Завдання резервного копіювання відпрацювали хоча б один раз без помилок після оновлення.

---

Джерело: https://www.zevshost.net/uk/kb/proxmox-obnovlenie-8-na-9/