[zabbix] 5.4 -> 6.4 upgrade

개요

---

현재 zabbix 5.4 환경

CentOS Linux release 8.4.2105

php-fpm-7.2.24

nginx-1.14

mariadb-server-10.3.28

 

 

zabbix 6.4 요구 조건

mariadb : 10.5.00-11.1.X 버전으로 InnoDB 엔진이 필요하며 권장 버전은 10.5

php-fpm : 7.4.0 - 8.3.X 버전으로 권장 버전은 8.0 이상

nginx : 1.20 이상

참조 : https://www.zabbix.com/documentation/current/en/manual/installation/requirements

 

 

upgrade 개요

CentOS Linux release 8에서 기본 제공하는 패키지는 아래와 같다.

php 

php는 7.2가 default고 7.4까지 제공한다.

# dnf module list php
Last metadata expiration check: 0:01:52 ago on Thu 18 Jan 2024 02:13:39 PM KST.
CentOS Linux 8 - AppStream
Name                         Stream                         Profiles                                          Summary                                      
php                          7.2 [d][e]                     common [d], devel, minimal                        PHP scripting language                       
php                          7.3                            common [d], devel, minimal                        PHP scripting language                       
php                          7.4                            common [d], devel, minimal                        PHP scripting language                       

Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled

 

mariadb

mariadb는 10.3이 default 고 10.5까지 제공한다.

# dnf module list mariadb
Last metadata expiration check: 0:04:31 ago on Thu 18 Jan 2024 02:13:39 PM KST.
CentOS Linux 8 - AppStream
Name                             Stream                           Profiles                                           Summary                               
mariadb                          10.3 [d][e]                      client, galera, server [d]                         MariaDB Module                        
mariadb                          10.5                             client, galera, server [d]                         MariaDB Module                        

Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled

 

nginx

nginx는 1.14가 default고 1.20까지 제공한다.

# dnf module list nginx
Last metadata expiration check: 0:17:36 ago on Thu 18 Jan 2024 02:13:39 PM KST.
CentOS Linux 8 - AppStream
Name                              Stream                                  Profiles                               Summary                                   
nginx                             1.14 [d][e]                             common [d]                             nginx webserver                           
nginx                             1.16                                    common [d]                             nginx webserver                           
nginx                             1.18                                    common [d]                             nginx webserver                           
nginx                             1.20                                    common [d]                             nginx webserver                           

Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled

 

 

따라서 별도로 설치가 필요없이 아래 버전으로 upgrade를 진행하려고 한다.

zabbix 6.4

php-fpm 7.4

mariadb 10.5

nginx 1.20

 

 

 

upgrade

---

mariadb backup(옵션)

zabbix의 database 는 "zabbix" 이다. mariadb upgrade를 통해 기존 database에 문제가 생길 소지는 적지만 혹시 모를 경우를 대비하여 기존 database는 백업 해 주는 것이 좋다.

database 확인

# mysql -u zabbix -p -e "show databases;"
Enter password: 
+--------------------+
| Database           |
+--------------------+
| information_schema |
| zabbix             |
+--------------------+

database 백업

# mysqldump -u root -p zabbix > zabbix.sql

 

 

 

설정파일 백업(옵션)

upgrade 대상이 되는 zabbix, nginx, php-fpm의 설정 파일을 백업한다.

upgrade 후에도 설정 파일은 유지 적용되나 혹시 모를 경우를 대비하여 백업해 두는 것이 좋다.

특별한 설정없이 default 설정을 사용한다면 백업이 필요 없을 수 있다.

# mkdir /opt/zabbix-backup/
# cp -arf /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# cp -arf /etc/nginx/conf.d/zabbix.conf  /opt/zabbix-backup/
# cp -arf /etc/php-fpm* /opt/zabbix-backup/

 

 

 

 

서비스 중지

upgrade 전에 서비스를 중지한다.

# systemctl stop zabbix-server
# systemctl stop mariadb
# systemctl stop php-fpm
# systemctl stop nginx

 

 

 

zabbix 6.4 repo 추가

# rpm -Uvh https://repo.zabbix.com/zabbix/6.4/rhel/8/x86_64/zabbix-release-6.4-1.el8.noarch.rpm

 

zabbix mirror 사이트 참고 : https://repo.zabbix.com/zabbix/6.4/rhel/8/x86_64/

Zabbix Official Repository

 

 

zabbix upgrade

# dnf upgrade zabbix-server-mysql zabbix-web-mysql zabbix-nginx-conf zabbix-sql-scripts zabbix-selinux-policy zabbix-agent2

 

 

 

php-fpm upgrade

# dnf module switch-to php:7.4

 

 

 

mariadb upgrade

# dnf module switch-to mariadb:10.5

 

 

참고 : 혹시 다른 버전의 mariadb를 설치하고자 하는 경우 아래와 같이 repository 추가 후 설치를 진행 할 수 있다.

# curl -LsS -O https://downloads.mariadb.com/MariaDB/mariadb_repo_setup
# sudo bash mariadb_repo_setup --mariadb-server-version=10.5
# dnf install MariaDB-server MariaDB-client

단, 새로 설치해야 하는 경우가 발생 할 수 있어 반드시 백업후 진행하도록 한다.

 

또한 mariadb에서 제공하는 공식 repository를 사용하고자 하는경우 아래를 참조한다. 

https://mariadb.org/download/?t=repo-config&d=CentOS+Stream&v=10.6&r_m=blendbyte

Download MariaDB Server - MariaDB.org

 

mariadb mirror 사이트 참고 : https://mirror.mariadb.org/yum/10.5/centos8-amd64/rpms/

Index of /yum/10.5/centos8-amd64/rpms/

 

 

 

nginx upgrade

# dnf module list nginx

 

 

 

서비스 시작

# systemctl start mariadb
# systemctl start php-fpm
# systemctl start nginx
# systemctl start zabbix-server