2. Debian/Ubuntu

Обзор

В этом разделе приведены инструкции по обновлению с Zabbix 6.4.x на последнюю версию Zabbix 7.0.x с использованием официальных пакетов Zabbix для Debian/Ubuntu.

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

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

Инструкции по обновлению между минорными версиями Zabbix 7.0.x (например, с 7.0.1 до 7.0.3) смотрите в разделе Обновление между минорными версиями.

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

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

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

systemctl stop zabbix-server

Если обновляете Zabbix прокси, агента или агента 2, то остановите и эти компоненты тоже.

systemctl stop zabbix-proxy
       systemctl stop zabbix-agent
       systemctl stop zabbix-agent2
2. Сделайте резервную копию базы данных Zabbix

Сделайте резервную копию вашей существующей базы данных Zabbix, чтобы подстраховаться от возможных сбоев при обновлении (например, проблем с дисковым пространством, отключения электричества или непредвиденных проблем).

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

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

Для файлов конфигурации выполните:

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/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
       dpkg -i zabbix-release_latest+debian12_all.deb

Для более старых версий Debian замените ссылку выше на правильную из репозитория Zabbix. Однако, обратите внимание, что пакеты для этих версий могут не включать все компоненты Zabbix. Список включённых компонентов см. Пакеты Zabbix.

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

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

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

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Для более старых версий Ubuntu замените ссылку выше на правильную из репозитория Zabbix. Однако, обратите внимание, что пакеты для этих версий могут не включать все компоненты Zabbix. Список включённых компонентов см. Пакеты Zabbix.

Вы можете увидеть запрос о конфигурации репозитория Zabbix:

Configuration file '/etc/apt/sources.list.d/zabbix.list'
       ==> Deleted (by you or by a script) since installation.
       ==> Package distributor has shipped an updated version.
       What would you like to do about it ?  Your options are:
       Y or I  : install the package maintainer's version
       N or O  : keep your currently-installed version
       D       : show the differences between the versions
       Z       : start a shell to examine the situation
       The default action is to keep your current version.
       *** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

Введите Y (илиI), чтобы установить версию сопровождающего (мейнтейнера) пакета конфигурации репозитория Zabbix.

Затем обновите информацию о репозитории:

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

Чтобы обновить компоненты Zabbix, выполните:

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent
  • При использовании PostgreSQL замените в команде mysql на pgsql.
  • При обновлении прокси замените в команде server на proxy.
  • При обновлении Zabbix агента 2 замените в команде zabbix-agent на zabbix-agent2 zabbix-agent2-plugin-*.

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

Вы можете увидеть запрос о конфигурации Zabbix сервера (или прокси):

Configuration file '/etc/zabbix/zabbix_server.conf'
       ==> Modified (by you or by a script) since installation.
       ==> Package distributor has shipped an updated version.
       What would you like to do about it ?  Your options are:
       Y or I  : install the package maintainer's version
       N or O  : keep your currently-installed version
       D       : show the differences between the versions
       Z       : start a shell to examine the situation
       The default action is to keep your current version.
       *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

Введите опцию, которая лучше подходит для вашей ситуации. Например, введите D, чтобы сравнить текущую и новую конфигурацию, а затем решите, хотите ли вы установить версию сопровождающего (мейнтенера) пакета (Y или I).

Затем, чтобы обновить веб-интерфейс Zabbix с сервером Apache, выполните:

apt install zabbix-apache-conf
6. Проверьте параметры конфигурации компонентов

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

Новые необязательные параметры можно найти на странице Что нового.

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

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

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

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

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

Возможно обновление между минорными версиями 7.0.х (например, с 7.0.1 до 7.0.3).

Сначала обновите информацию о репозитории:

apt update

Затем, чтобы обновить все компоненты Zabbix, выполните:

apt install --only-upgrade 'zabbix*'
  • Чтобы обновить только сервер Zabbix, замените в команде 'zabbix*' на 'zabbix-server*'.
  • Чтобы обновить только прокси Zabbix, замените в команде 'zabbix*' на 'zabbix-proxy*'.
  • Чтобы обновить только агент Zabbix, замените в команде 'zabbix*' на 'zabbix-agent*'.
  • Чтобы обновить только Zabbix агент 2, замените в команде 'zabbix*' на 'zabbix-agent2*'.