Debian/Ubuntu

Обзор

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

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

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

Инструкции по обновлению между минорными версиями Zabbix 8.0.x (например, с 8.0.1 до 8.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 Обновление пакета конфигурации репозитория

Перед продолжением обновления удалите текущий пакет репозитория Zabbix:

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

Также может потребоваться вручную удалить все старые пакеты Zabbix из рабочего каталога (например, rm zabbix-release_latest+debian12_all.deb) перед загрузкой нового, чтобы менеджер пакетов не использовал устаревшую версию повторно в процессе обновления.

Затем установите последний пакет конфигурации репозитория, чтобы обеспечить совместимость с новейшими пакетами, а также включить последние исправления безопасности и ошибок.

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

wget https://repo.zabbix.com/zabbix/8.0/release/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/8.0/release/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/8.0/release/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 и перезапустить Apache, выполните:

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

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

Сведения о новых необязательных параметрах см. на странице Что нового.

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

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

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

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

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

Возможно обновление между минорными версиями Zabbix 8.0.x (например, с 8.0.1 до 8.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*' в команде.