소스 업그레이드
개요
이 섹션에서는 성공적인 업그레이드에 필요한 단계를 설명합니다. 공식 Zabbix 소스를 사용하여 Zabbix 7.2.x에서 Zabbix 7.4.x로 업그레이드합니다.
업그레이드하기 전에 관련 업그레이드 참고 사항을 반드시 읽어 보십시오!
7.4의 요구 사항도 검토하는 것이 좋습니다.
업그레이드 중에 두 개의 SSH 세션을 병렬로 실행하여 한 세션에서는 업그레이드 단계를 수행하고 다른 세션에서는
서버/프록시 로그를 모니터링하면 편리할 수 있습니다. 예를 들어 두 번째 SSH 세션에서
tail -f zabbix_server.log 또는 tail -f zabbix_proxy.log를 실행하면 최신 로그 파일 항목과 발생 가능한 오류를
실시간으로 확인할 수 있습니다. 이는 프로덕션
인스턴스에서 매우 중요할 수 있습니다.
서버 업그레이드 절차
1 서버 중지
데이터베이스에 새 데이터가 삽입되지 않도록 Zabbix 서버를 중지합니다.
2 기존 Zabbix 데이터베이스 백업
이는 매우 중요한 단계입니다. 데이터베이스를 백업했는지 확인하십시오. 업그레이드 절차가 실패하는 경우(디스크 공간 부족, 전원 꺼짐, 예기치 않은 문제) 도움이 됩니다.
3 구성 파일, PHP 파일 및 Zabbix 바이너리 백업
Zabbix 바이너리, 구성 파일 및 PHP 파일 디렉터리의 백업 사본을 만듭니다.
4 새 서버 바이너리 설치
다음 지침에 따라 소스에서 Zabbix 서버를 컴파일합니다.
5 서버 구성 매개변수 검토
구성 매개변수를 변경해야 하는지 확인하려면 업그레이드 참고 사항을 반드시 검토하십시오.
새로운 선택적 매개변수는 새로운 기능 페이지를 참조하십시오.
6 새 Zabbix 바이너리 시작
새 바이너리를 시작합니다. 바이너리가 성공적으로 시작되었는지 로그 파일에서 확인합니다.
Zabbix 서버는 데이터베이스를 자동으로 업그레이드합니다. 시작할 때 Zabbix 서버는 현재 데이터베이스 버전(필수 및 선택 사항)과 필요한 데이터베이스 버전을 보고합니다. 현재 필수 버전이 필요한 버전보다 오래된 경우 Zabbix 서버는 필요한 데이터베이스 업그레이드 패치를 자동으로 실행합니다. 데이터베이스 업그레이드의 시작 및 진행 수준(백분율)은 Zabbix 서버 로그 파일에 기록됩니다. 업그레이드가 완료되면 "database upgrade fully completed" 메시지가 로그 파일에 기록됩니다. 업그레이드 패치 중 하나라도 실패하면 Zabbix 서버가 시작되지 않습니다. 현재 필수 데이터베이스 버전이 필요한 버전보다 최신인 경우에도 Zabbix 서버가 시작되지 않습니다. Zabbix 서버는 현재 필수 데이터베이스 버전이 필요한 필수 버전과 일치하는 경우에만 시작됩니다.
8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000
8673:20161117:104750.259 required mandatory version: 03040000
서버를 시작하기 전에 다음을 확인하십시오.
- 데이터베이스 사용자에게 충분한 권한이 있는지 확인합니다(create table, drop table, create index, drop index).
- 사용 가능한 디스크 공간이 충분한지 확인합니다.
7 새 Zabbix 웹 인터페이스 설치
필요한 최소 PHP 버전은 8.0.0입니다. 필요한 경우 업데이트하고 설치 지침을 따르십시오.
8 웹 브라우저 쿠키 및 캐시 삭제
업그레이드 후 Zabbix 웹 인터페이스가 제대로 작동하도록 웹 브라우저 쿠키와 웹 브라우저 캐시를 삭제해야 할 수 있습니다.
프록시 업그레이드 절차
1 프록시 중지
Zabbix 프록시를 중지합니다.
2 구성 파일 및 Zabbix 프록시 바이너리 백업
Zabbix 프록시 바이너리와 구성 파일의 백업 사본을 만듭니다.
3 새 프록시 바이너리 설치
다음 지침에 따라 소스에서 Zabbix 프록시를 컴파일합니다.
4 프록시 구성 매개변수 검토
구성 매개변수를 변경해야 하는지 확인하려면 업그레이드 참고 사항을 반드시 검토하십시오.
새로운 선택적 매개변수는 새로운 기능 페이지를 참조하십시오.
5 새 Zabbix 프록시 시작
새 Zabbix 프록시를 시작합니다. 프록시가 성공적으로 시작되었는지 로그 파일에서 확인합니다.
Zabbix 프록시는 데이터베이스를 자동으로 업그레이드합니다. 데이터베이스 업그레이드는 Zabbix 서버를 시작할 때와 비슷하게 진행됩니다.
에이전트 업그레이드 절차
에이전트 업그레이드는 필수가 아닙니다. 새로운 기능을 사용하기 위해 필요한 경우에만 에이전트를 업그레이드하면 됩니다.
이 섹션에서 설명하는 업그레이드 절차는 Zabbix 에이전트와 Zabbix 에이전트 2 모두를 업그레이드하는 데 사용할 수 있습니다.
1 에이전트 중지
Zabbix 에이전트를 중지합니다.
2 구성 파일 및 Zabbix 에이전트 바이너리 백업
Zabbix 에이전트 바이너리와 구성 파일의 백업 사본을 만듭니다.
3 새 에이전트 바이너리 설치
다음 지침에 따라 소스에서 Zabbix 에이전트를 컴파일합니다.
또는 미리 컴파일된 Zabbix 에이전트를 Zabbix 다운로드 페이지에서 다운로드할 수 있습니다.
4 에이전트 구성 매개변수 검토
구성 매개변수를 변경해야 하는지 확인하려면 업그레이드 참고 사항을 반드시 검토하십시오.
새로운 선택적 매개변수는 새로운 기능 페이지를 참조하십시오.
5 새 Zabbix 에이전트 시작
새 Zabbix 에이전트를 시작합니다. 에이전트가 성공적으로 시작되었는지 로그 파일에서 확인합니다.
마이너 버전 간 업그레이드
7.4.x의 마이너 버전 간에 업그레이드할 때(예: 7.4.1에서 7.4.3으로) 메이저 버전 간 업그레이드와 동일한 작업을 서버/프록시/에이전트에 수행해야 합니다. 유일한 차이점은 마이너 버전 간 업그레이드 시 데이터베이스가 변경되지 않는다는 것입니다.