1 소스에서 업그레이드
원본 보기1 소스에서 업그레이드
개요
이 섹션에서는 공식 Zabbix 소스를 사용하여 Zabbix 6.4.x에서 Zabbix 7.0.x로 성공적인 업그레이드에 필요한 단계를 제공합니다.
업그레이드하기 전에 관련 업그레이드 노트를 반드시 읽어보세요!
또한 7.0의 요구사항을 확인해보실 수도 있습니다.
업그레이드 중에 두 개의 병렬 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.0.x의 마이너 버전 간 업그레이드(예: 7.0.1에서 7.0.3으로) 시에는 메이저 버전 간 업그레이드와 동일한 서버/프록시/에이전트 작업을 실행해야 합니다. 유일한 차이점은 마이너 버전 간 업그레이드 시에는 데이터베이스에 변경이 없다는 것입니다.