2 Debian/Ubuntu

개요

이 섹션은 Debian/Ubuntu용 공식 Zabbix 패키지를 사용하여 Zabbix 6.4.x에서 최신 버전의 Zabbix 7.0.x로 업그레이드하는 방법을 제공합니다.

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 Zabbix 설정 파일, PHP 파일, Zabbix 바이너리 백업

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

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

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 agent 2를 업그레이드하는 경우, 명령어에서 zabbix-agent를 zabbix-agent2 zabbix-agent2-plugin-*로 바꿔주세요.

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).

그런 다음, Apache와 함께 Zabbix 프론트엔드를 업그레이드하고 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 웹 브라우저 쿠키와 캐시 삭제

업그레이드 후, Zabbix 웹 인터페이스가 제대로 작동하도록 웹 브라우저 쿠키와 웹 브라우저 캐시를 삭제해야 할 수 있습니다.

마이너 버전 간 업그레이드

Zabbix 7.0.x 마이너 버전 간 업그레이드가 가능합니다 (예: 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 agent 2만 업그레이드하려면, 명령어에서 'zabbix*'를 'zabbix-agent2*'로 교체하세요.