2 Debian/Ubuntu

Обзор

Этот раздел описывает требуемые шаги для успешного обновления с Zabbix 6.2.x до Zabbix 6.4.x с использованием официальных пакетов Zabbix для Debian/Ubuntu.

Перед выполнением обновления убедитесь, что прочитали все соответствующие заметки по обновлению!

Также может быть необходимо ознакомиться с требованиями для 6.4.

Для удобства можно запустить две параллельные SSH-сессии во время обновления, выполняя шаги обновления в одной сессии и наблюдая за файлами журналов сервера/прокси в другой. Например, при выполнении tail -f zabbix_server.log или tail -f zabbix_proxy.log во второй SSH-сессии будут отображаться последние записи из файла журнала и возможные ошибки в режиме реального времени. Такой подход может быть критичным в продукционных установках.

Процедура обновления

1 Остановите процессы Zabbix

Остановите Zabbix сервер, чтобы быть уверенным, что в базу данных не будет происходить запись новых данных.

# service zabbix-server stop

При обновлении прокси, остановите также и его.

# service zabbix-proxy stop
2 Сделайте резервную копию существующей базы данных Zabbix

Этот шаг очень важен. Убедитесь, что у вас имеется резервная копия вашей базы данных. Копия поможет, если процедура обновления закончится неудачно (отсутствие свободного места на диске, отключение питания, любая непредвиденная проблема).

3 Выполните резервное копирование файлов конфигурации, PHP-файлов и бинарных файлов Zabbix

Создайте резервные копии бинарных файлов Zabbix, файлов конфигурации и папки с PHP-файлами.

Файлы конфигурации:

# mkdir /opt/zabbix-backup/
# cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

Файлы PHP и бинарные файлы Zabbix:

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
# cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Обновите пакет конфигурации репозитория

Чтобы продолжить обновление, необходимо удалить текущий пакет репозитория.

# rm -Rf /etc/apt/sources.list.d/zabbix.list

Затем установите новый пакет конфигурации репозитория.

На Debian 12 выполните:

# wget https://repo.zabbix.com/zabbix/6.4/debian/pool/main/z/zabbix-release/zabbix-release_6.4-1+debian12_all.deb
# dpkg -i zabbix-release_6.4-1+debian12_all.deb

На Debian 11 выполните:

# wget https://repo.zabbix.com/zabbix/6.4/debian/pool/main/z/zabbix-release/zabbix-release_6.4-1+debian11_all.deb
# dpkg -i zabbix-release_6.4-1+debian11_all.deb

На Debian 10 выполните:

# wget https://repo.zabbix.com/zabbix/6.4/debian/pool/main/z/zabbix-release/zabbix-release_6.4-1+debian10_all.deb
# dpkg -i zabbix-release_6.4-1+debian10_all.deb

На Debian 9 выполните:

# wget https://repo.zabbix.com/zabbix/6.4/debian/pool/main/z/zabbix-release/zabbix-release_6.4-1+debian9_all.deb
# dpkg -i zabbix-release_6.4-1+debian9_all.deb

На Ubuntu 22.04 выполните:

# wget https://repo.zabbix.com/zabbix/6.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.4-1+ubuntu22.04_all.deb
# dpkg -i zabbix-release_6.4-1+ubuntu22.04_all.deb

На Ubuntu 20.04 выполните:

# wget https://repo.zabbix.com/zabbix/6.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.4-1+ubuntu20.04_all.deb
# dpkg -i zabbix-release_6.4-1+ubuntu20.04_all.deb

На Ubuntu 18.04 выполните:

# wget https://repo.zabbix.com/zabbix/6.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.4-1+ubuntu18.04_all.deb
# dpkg -i zabbix-release_6.4-1+ubuntu18.04_all.deb

На Ubuntu 16.04 выполните:

# wget https://repo.zabbix.com/zabbix/6.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.4-1+ubuntu16.04_all.deb
# dpkg -i zabbix-release_6.4-1+ubuntu16.04_all.deb

На Ubuntu 14.04 выполните:

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.4-1+ubuntu14.04_all.deb
# dpkg -i zabbix-release_6.4-1+ubuntu14.04_all.deb

Обновите информацию о репозитории.

# apt-get update
5 Обновите компоненты Zabbix

Для обновления компонентов Zabbix вы можете выполнить что-то вроде:

# apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

При использовании PostgreSQL замените в команде mysql на pgsql. При обновлении прокси замените в команде server на proxy. При обновлении агента 2 замените в команде zabbix-agent на zabbix-agent2.

Обновление Zabbix агента 2 при помощи команды apt install zabbix-agent2 может привести к ошибке. Для получения дополнительной информации смотрите Известные проблемы.:::

Затем для корректного обновления веб-интерфейса с Apache также выполните:

# apt-get install zabbix-apache-conf

Дистрибутивы до Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) не предоставляют PHP 7.2 или более новые версии, который требуется веб-интерфейсу Zabbix 5.0. Смотрите информацию касательно установки веб-интерфейса Zabbix на устаревшие дистрибутивы.

6 Проверьте параметры конфигурации компонентов

Обязательно ознакомьтесь с Заметками по обновлению, чтобы проверить, не требуются ли какие-то изменения в параметрах конфигурации.

Новые необязательные параметры можно найти на странице What's new.

7 Запустите процессы Zabbix

Запустите обновленные компоненты Zabbix.

# service zabbix-server start
# service zabbix-proxy start
# service zabbix-agent start
# service zabbix-agent2 start
8 Очистите cookies и кэш в веб-браузере

После обновления вам, возможно, потребуется очистить cookies веб-браузера и кэш веб-браузера, чтобы веб-интерфейс Zabbix работал должным образом.

Обновление между минорными версиями

Есть возможность обновить минорные версии 6.4.х (например, с 6.4.1 до 6.4.3). Это легко.

Чтобы обновить минорную версию Zabbix, запустите:

$ sudo apt install --only-upgrade 'zabbix.*'

Чтобы обновить минорную версию сервера Zabbix, запустите:

$ sudo apt install --only-upgrade 'zabbix-server.*'

или для Zabbix агента 2:

$ sudo apt install --only-upgrade 'zabbix-agent2.*'