02. 패키지로 Zabbix 설치하기

Rocky Linux 9에 Zabbix 설치

1. 본 문서는 Rocky Linux 9 환경에 Zabbix Server, Web Frontend, Agent를 설치하는 절차를 설명한다.
2. 설치 방식은 Zabbix 공식 Repository 기반 패키지 설치를 기준으로 하며, 데이터베이스는 MySQL 계열(MariaDB), 웹 서버는 Apache를 사용한다.
3. Zabbix 공식 문서는 운영체제 기본 저장소 패키지보다 공식 저장소 패키지 사용을 권장한다.

설치 구성

• OS: Rocky Linux 9
• Zabbix: 7.0 LTS 또는 7.4 계열 패키지 기준, 운영 환경에서는 보통 LTS 사용을 우선 검토한다.
• DBMS: MariaDB(MySQL 호환)
• Web Server: Apache
• 구성 요소: zabbix-server-mysql, zabbix-web-mysql, zabbix-apache-conf, zabbix-sql-scripts, zabbix-agent

사전 준비

1. OS 패키지를 최신 상태로 갱신한다.
2. EL9 계열에서 EPEL이 활성화되어 있고 EPEL의 Zabbix 패키지가 함께 잡히는 경우 충돌 가능성이 있으므로, 공식 Zabbix 패키지 사용 시 주의가 필요하다.
3. 방화벽과 SELinux 사용 여부를 미리 확인한다. Rocky Linux 9에서도 SELinux Enforcing 상태로 운영 가능하며, 필요한 정책만 추가하는 것이 권장된다.

   $> dnf update -y

Zabbix Repository 등록

1. Rocky Linux는 RHEL 계열로 분류되며, 공식 설치 문서에서도 Rocky Linux용 패키지 제공이 명시되어 있다.
2. 운영 시점에는 사용하려는 버전에 맞는 공식 Release RPM을 설치한다. 아래 예시는 7.4 기준이다

   $> rpm -Uvh https://repo.zabbix.com/zabbix/7.4/release/rhel/9/noarch/zabbix-release-latest.el9.noarch.rpm
   dnf clean all

• 7.0 LTS를 사용할 경우에는 Zabbix 다운로드 페이지에서 Rocky Linux 9, MySQL, Apache 조합으로 생성된 명령을 사용하는 방식이 가장 안전하다.

Zabbix 패키지 설치

1. 서버, 웹 프론트엔드, Apache 설정, SQL 스크립트, Agent 패키지를 함께 설치한다.
2. 필요 시 SELinux 정책 패키지와 ICMP 체크용 fping도 함께 검토할 수 있다.

   $> dnf install -y zabbix-server-mysql zabbix-web-mysql zabbix-apache-conf zabbix-sql-scripts zabbix-agent zabbix-selinux-policy mariadb-server

MariaDB 설정

1. MariaDB를 설치하고 서비스 자동 시작을 활성화한다.
2. 초기 설치 직후에는 root 비밀번호 설정 및 기본 보안 설정을 진행하는 것이 좋다.
3. $> systemctl enable --now mariadb $> $mysql_secure_installation
4. 이후 Zabbix 전용 데이터베이스와 계정을 생성한다.
5. $> mysql -uroot -p CREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin; CREATE USER 'zabbix'@'localhost' IDENTIFIED BY 'StrongPassword'; GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost'; SET GLOBAL log_bin_trust_function_creators = 1; FLUSH PRIVILEGES; QUIT;
6. Zabbix 초기 스키마를 DB에 반영한다. 공식 설치 예시들에서도 server.sql.gz import 방식을 사용한다.

$> zcat /usr/share/zabbix/sql-scripts/mysql/server.sql.gz | mysql --default-character-set=utf8mb4 -uzabbix -p zabbix

1. 스키마 import가 끝나면 필요 시 log_bin_trust_function_creators 값을 원복한다.

$> mysql -uroot -p

SET GLOBAL log_bin_trust_function_creators = 0;
QUIT;

Zabbix Server 설정

1. Zabbix Server 설정 파일에서 DB 비밀번호를 지정한다.

   $> vi /etc/zabbix/zabbix_server.conf
   
   

• 아래 항목을 확인 또는 수정한다.
  ...
  DBPassword=StrongPassword

• 환경에 따라 DBHost, DBName, DBUser를 명시적으로 지정할 수 있다.

  ini
  DBHost=localhost
  DBName=zabbix
  DBUser=zabbix
  DBPassword=StrongPassword

Apache 및 PHP 연동

1. Apache 기반 프론트엔드는 Zabbix 패키지 설치 시 함께 배포된다.
2. 서비스 시작 전 Apache 설정 문법과 PHP 관련 패키지 상태를 확인한다.
3. $> httpd -t

• EL 계열에서는 Zabbix 웹 프론트엔드 구동을 위해 Apache와 PHP-FPM을 함께 사용하는 구성이 일반적이다.
• $> systemctl enable --now httpd php-fpm

서비스 시작

1. Zabbix Server, Agent, Apache, PHP-FPM을 시작하고 부팅 시 자동 실행되도록 설정한다.
2. $> systemctl restart zabbix-server zabbix-agent httpd php-fpm $> systemctl enable zabbix-server zabbix-agent httpd php-fpm
3. 서비스 상태를 확인한다.
4. $> systemctl status zabbix-server $> systemctl status zabbix-agent $> systemctl status httpd $> systemctl status php-fpm

웹 초기 설정

1. 브라우저에서 아래 주소로 접속한다.

$> curl http://<server-ip>/zabbix

• 초기 설정 마법사에서는 다음 항목을 순서대로 확인한다.
  1. Prerequisites 확인
  2. Database connection 정보 입력
  3. Zabbix server host/port 확인
  4. 설정 요약 확인 후 완료
• 초기 로그인 계정은 기본적으로 아래 값을 사용한다.
  • Username: Admin
  • Password: zabbix

설치 후 점검

1. zabbix_server.log에서 DB 연결 오류, 스키마 오류, 권한 오류 여부를 확인한다.
2. Agent가 로컬에 설치된 경우 127.0.0.1 대상 Host를 등록해 기본 템플릿 연결 후 데이터 수집 여부를 확인한다.
3. Ping, Agent availability, CPU, Memory, Filesystem 항목이 정상 수집되는지 먼저 확인한 뒤, 이후 DB, Web, Middleware 템플릿을 확장 적용하는 것이 좋다.

Reference

http://igoni.kr/02.Open-Infra/01.%EB%AA%A8%EB%8B%88%ED%84%B0%EB%A7%81/Zabbix%EA%B5%AC%EC%84%B1%ED%95%98%EA%B8%B0/02.%20%ED%8C%A8%ED%82%A4%EC%A7%80%EB%A1%9C%20Zabbix%20%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0.html

02. 패키지로 Zabbix 설치하기 - 이곤아이.kr