이 문서는 HQbird 2027의 변경을 최신 항목부터 적습니다. 각 부분은 릴리스 번호와 날짜로 시작합니다. 새 릴리스는 그 부분을 맨 위에 더하고, 그 아래 부분은 그대로 둡니다.

  • 2027.2.34 이후: 릴리스마다 부분이 하나 있습니다.
  • 2027.2.33: 그 릴리스 시점의 HQbird 2027 전체를 HQbird 2024와 비교한 내용입니다.
  • 2027.2.8부터 2027.2.33까지 각 키트의 기록은 다운로드 사이트의 hqbird2027-whats-new-2027.2.8-2027.2.33.md에 있습니다.

설치 프로그램: HQbird 2027 다운로드.

다운로드: https://ib-aid.com/download/hqbird/v2027/ (Firebird 2.5, 3.0, 4.0, 5.0용 Windows 설치 .exe와 Linux .run. 체크섬은 SHA256SUMS에 있습니다). Docker 이미지: ghcr.io/ibsurgeon/hqbird2027-fb25, -fb30, -fb40, -fb50.


2027.2.35 (2026-11-18)

버전

구성 요소 버전 변경
HQbird 에이전트(fbagent, enroll) 3.6.0 예
HQbird Monitor 1.59.0 예
구성 편집기(HQbird Monitor 안) 1.63.0 예
HQbird RCM 2027.5.13 예
HQCluster 노드 2027.5.13 예
fbmcp(Firebird용 MCP 서버) 2027.2.24 아니요
Firebird 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 아니요

클러스터: 마스터 데이터베이스를 백업하고 복원한 뒤의 재초기화

  • 마스터 데이터베이스의 백업과 복원(gbak)은 그 데이터베이스에 새 GUID를 줍니다. 복제본은 그 저널을 더 이상 적용할 수 없습니다. 노드는 몇 초 안에 이것을 보고, 전과 같이 각 복제본으로의 전달을 일시 중지하며(이유는 master_db_replaced), 마스터를 NEEDS_REINIT로 설정합니다.
  • 새 기능: RCM은 rcm.json의 설정 auto_reinit.on_master_restore(설정 페이지에도 있습니다)에 따라 다음에 할 일을 정합니다.
    • auto: RCM이 300초를 기다린 뒤(auto_reinit.master_restore_settle_sec) 그 데이터베이스의 모든 복제본을 스스로 재초기화합니다.
    • window: RCM은 자동 재초기화 시간에 그 복제본을 재초기화합니다.
    • propose: RCM은 아무것도 시작하지 않고 운영자를 기다립니다.
  • 이 설정이 없으면 동작은 바뀌지 않습니다. 자동 재초기화가 켜져 있으면 window, 꺼져 있으면 propose입니다.
  • 데이터베이스 페이지에 있는 마스터 데이터베이스의 행은, 무슨 일이 있었는지와 RCM이 무엇을 하는지를 알려 줍니다. 새 버튼 모든 복제본을 지금 재초기화는 모든 복제본의 재초기화를 하나씩 차례로 시작합니다. 스누즈는 재초기화를 보류합니다.
  • 노드는 데이터베이스 파일의 교체라면 어느 것이든 반응합니다. 손으로 한 복원이든, 에이전트의 백업-복원 주기이든 같습니다. Firebird 2.5, 3.0, 5.0에서 확인했습니다. 경보 master_db_replaced는 RCM의 알림 채널로 갑니다.

클러스터: HQbird 2024(FBDataGuard)의 복제가 RCM으로 넘어감

  • HQbird 2024에서 갱신한 서버에서는 에이전트가 FBDataGuard의 복제 설정(역할, 저널과 아카이브 폴더, 복제본 대상)을 읽고 RCM에 넘깁니다.
  • RCM은 복제본 호스트를 스스로 연결합니다. 연결하지 못한 호스트는 호스트 연결 페이지에 후보로 표시됩니다.
  • 이어서 RCM은 데이터베이스의 복제를 있는 그대로 이어받습니다. 복제본을 재초기화하지 않고, Firebird를 다시 시작하지 않으며, 파일을 지우지 않습니다. FBDataGuard가 아직 동작하는 동안은 기다립니다.
  • 설정 → FBDataGuard에서 가져오기 페이지는 가져오기의 상태를 보여 주고, 가져오기를 다시 실행합니다. 명령줄에는 hqbirdrcm dg-import status와 hqbirdrcm dg-import retry가 있습니다.
  • 노드는 FBDataGuard가 replication.conf에 쓴 블록과, .uploaded로 이름을 바꾼 저널 세그먼트를 읽습니다.
  • 이 가져오기는 Linux 서버에서 확인했습니다.

RCM: 데이터베이스 페이지

  • 게시가 켜진 마스터 데이터베이스의 줄은, 게시에 들어 있는 테이블의 수와 운영자가 뺀 수를 보여 줍니다. 예를 들어 publication on · tables: 118 · taken out: 2입니다.

설치 프로그램: 첫 RCM 암호

  • RCM이 포함된 설치 뒤에, Linux 설치 프로그램은 생성한 rcmadmin의 암호를 그 파일의 경로와 함께 터미널에 보여 줍니다. Windows 설치 프로그램은 결과 페이지에 보여 줍니다.
  • 암호가 표시되는 곳은 터미널뿐입니다. 로그, 파이프, 설치 결과 파일에는 쓰지 않습니다.

HQbird Monitor: 범위의 시각

  • 시간 범위의 시각 필드(대시보드, 데이터베이스 페이지, 로그, 오류)는 목록 대신, 시와 분을 입력하는 필드 두 개입니다. 위아래 화살표는 값을 1씩 바꾸고, :는 시에서 분으로 옮기며, 짧은 목록은 15분 단위를 보여 줍니다.

HQbird Monitor의 구성 편집기

  • 타임스탬프는 정확한 시각입니다. 경과 시간(“23분 전”)은 툴팁에 있습니다.
  • 백업 작업의 결과 패널에는 크기 행이 있습니다. 그 실행의 백업 파일과, 테스트 복원이 만든 데이터베이스입니다.
  • 에이전트 구성 페이지는 휴대폰과 1280 px 화면에 맞습니다. 탭 줄은 줄바꿈됩니다. 설정은 항목을 가로로 스크롤되는 한 줄로 보여 줍니다. 작업과 백업 표는 1280 px에서 더 이상 가로로 스크롤되지 않습니다.

수정

  • HQbird 2024에서 갱신한 서버에서는 클러스터를 구성한 뒤 HQbird 3.0이 시작되지 않았습니다(“Incorrect version of replication config file”). Firebird가 plugins 폴더에서 복제 플러그인의 예전 사본을 읽었기 때문입니다. 그 사본은 이제 그 폴더 밖에 둡니다.
  • 노드는 limits.rescan_interval_sec의 변경을 재시작 없이 적용합니다.

업그레이드

  • 2027.2.35 Windows 설치 프로그램 또는 Linux .run으로 설치하거나 갱신합니다. 자동 갱신이 켜진 서버는 에이전트 3.6.0과 HQbird Monitor 1.59.0을 스스로 받습니다.
  • 클러스터에서는 RCM을 노드보다 먼저, 또는 동시에 갱신하십시오. RCM 2027.5.13은 더 오래된 노드와도 동작합니다. FBDataGuard에서 가져오려면 노드 2027.5.13이 필요합니다.
  • 클러스터의 마스터 데이터베이스에서 예약한 백업-복원 주기를 실행할 때는 auto_reinit.on_master_restore를 auto로 설정합니다. 그렇지 않으면 주기 뒤에, 운영자가 재초기화를 시작할 때까지 복제본은 변경을 받지 못합니다.
  • Docker: 2027.2.35 이미지를 pull하고, 같은 볼륨으로 새 컨테이너를 시작합니다.

2027.2.34 (2026-11-17)

버전

구성 요소 버전 변경
HQbird 에이전트(fbagent, enroll) 3.5.0 예
HQbird Monitor 1.58.0 예
구성 편집기(HQbird Monitor 안) 1.62.0 예
fbmcp(Firebird용 MCP 서버) 2027.2.24 아니요
HQbird RCM 2027.5.12 아니요
HQCluster 노드 2027.5.12 아니요
Firebird 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 아니요

gbak 작업 로그를 빠짐없이 보존

  • 이전에는 에이전트가 16 MiB보다 큰 gbak 로그의 중간을 잘라 냈습니다. 이제는 백업 또는 복원 작업의 각 단계 로그가, gbak이 출력한 내용을 모두 담은 .log.zip 아카이브 하나가 됩니다.
  • 아카이브 옆에 에이전트는 출력과 오류의 마지막 100줄을 담은 작은 텍스트 파일을 둡니다.
  • 구성 편집기의 로그 다운로드는 그 아카이브를 저장합니다. 작업의 로그 줄과 복원 이력에 있는 새 버튼 마지막 줄은 다운로드 없이 로그의 끝을 보여 줍니다.
  • 30 MB보다 큰 아카이브는 HQCenter로 보내지 않습니다. 그 줄에는 서버에만 보관이라고 나오고, 로그 다운로드는 서버에 있는 아카이브의 경로를 보여 줍니다. 마지막 줄은 계속 보냅니다.
  • 이전 버전이 쓴 로그(.log.gz)는 남기고, 예전과 같이 다운로드할 수 있습니다.

휴대폰의 HQbird Monitor

  • 너비가 768 px 이하인 화면에서 헤더는 한 줄입니다. 뒤로 가기 화살표, 서버 이름, 메뉴 버튼입니다. 버튼을 누르면 서버 메뉴, 설정, 언어, 로그아웃이 패널로 열립니다. 이전 헤더는 세 줄을 차지했고, 메뉴 항목 7개 중 4개를 보여 주었습니다.
  • 시간 범위는 버튼 하나입니다. 날짜, 구간, 프리셋이 패널로 열립니다. 로그, 오류, 충돌의 포함 필터와 제외 필터는 필터 버튼 아래로 접힙니다.
  • 너비가 600 px 이하인 화면에서는 서버, 대시보드의 데이터베이스, 오류, 로그 기록이 카드가 됩니다. 가로로 스크롤되지 않습니다.
  • 버튼과 필드의 높이는 44 px 이상이고, 필드 글자는 16 px입니다. 그래서 iPhone의 Safari는 필드를 눌러도 페이지를 확대하지 않습니다.

HQbird Monitor의 데이터베이스 페이지

  • 데이터베이스 페이지는 서버 메뉴를 유지합니다. 로그, 설정, 오류, 충돌, 성능 보고서, 작업, 백업으로 한 번의 클릭에 갈 수 있습니다. 이전에는 데이터베이스 항목이 서버 메뉴의 자리를 차지했습니다.
  • 데이터베이스 항목(데이터베이스, 메트릭, 클라이언트 버전, 통계, 성능 보고서)은 헤더 아래 한 줄에 놓입니다. 줄은 DB 레이블과 데이터베이스 이름으로 시작하고, 스크롤해도 그 자리에 있습니다.
  • 데이터베이스 이름을 누르면 그 서버의 데이터베이스가 보입니다. 각각의 이름, 경로, 크기입니다. 다른 데이터베이스는 같은 페이지, 같은 날, 같은 시간 범위로 열립니다. 데이터베이스가 8개 이상이면 목록에 검색 필드가 생깁니다.
  • 성능 보고서는 데이터베이스 목록에서 그 데이터베이스가 선택된 동안 그 데이터베이스의 행을 보여 줍니다.
  • 데이터베이스 페이지에서 대시보드로 가는 링크는 로고가 아니라 서버 이름입니다.
  • 사용자 안내서(영어와 브라질 포르투갈어)를 갱신하고 새 그림을 넣었습니다.

Linux 설치 프로그램

  • ALT Linux. 깨끗한 ALT 11에서 Firebird 3.0, 4.0, 5.0용 키트가 코드 6으로 멈췄습니다. 설치 프로그램이 Debian 패키지 이름을 요구했기 때문입니다. 설치 프로그램은 이제 ALT Linux를 인식하고, 올바른 패키지를 설치합니다.
  • sudo를 쓸 수 있는 그룹이 하나뿐인 경우. sudo를 실행할 수 있는 그룹이 하나뿐인 시스템(ALT Linux에서는 그룹 wheel)에서 설치가 롤백되었습니다. 설치 프로그램은 이제 에이전트 계정을 그 그룹에 넣고, 그렇게 했다고 알립니다. 그 그룹이 암호 없이 모든 명령을 실행할 수 있거나, root만 sudo를 실행할 수 있으면, 이유를 밝히고 멈춥니다.
  • 실패한 설치는 아무것도 남기지 않습니다. 롤백은 이제 제거된 폴더에서 실행되며 포트를 잡고 있던 Firebird 서비스를 멈추고, 에이전트 폴더와 그 sudoers 파일을 지웁니다. 다음 시도는 깨끗한 상태에서 시작합니다.
  • SELinux. AlmaLinux 8에서는 HQbird Monitor가 설치되지 않았습니다. 유닛 파일의 SELinux 레이블이 잘못되어 있었습니다. 설치 프로그램은 이제 그 레이블을 설정합니다.

Docker 이미지

  • 클러스터 라우터(HAProxy)가 컨테이너 안에서 시작됩니다. 이전에는 이미지 안에서 라우터 서비스가 시작되지 않았습니다.
  • 이전 컨테이너의 볼륨을 쓰는 새 컨테이너는, 그 볼륨에 라우터가 있어도 재시작 루프에서 멈추지 않습니다.

수정

  • 휴대폰의 HQbird Monitor: 구성 편집기가 없는 에이전트의 서버에 작업과 백업 항목이 표시되었습니다.

업그레이드

  • 2027.2.34 Windows 설치 프로그램 또는 Linux .run으로 설치하거나 갱신합니다. 자동 갱신이 켜진 서버는 에이전트 3.5.0과 HQbird Monitor 1.58.0을 스스로 받습니다.
  • HQCenter가 에이전트의 새 .log.zip 로그를 다운로드하려면 HQbird Monitor 1.58.0이 필요합니다. HQCenter를 에이전트보다 먼저, 또는 동시에 갱신하십시오.
  • HQbird Monitor 앞에서 응답 콘텐츠 유형을 거르는 프록시는 api/joblog에서 application/zip을 허용해야 합니다.
  • Docker: 2027.2.34 이미지를 pull하고, 같은 볼륨으로 새 컨테이너를 시작합니다.

2027.2.33 (2026-11-16): HQbird 2024와 비교한 HQbird 2027

소스 코드의 상태는 2026-11-16 기준입니다. 출시된 키트는 2027.2.33(2026-11-16)이었습니다. 이 부분은 HQbird 2024와 견준 전체 그림입니다.

1. 요약

  • Java 도구 FBDataGuard는 교체되었습니다. 그 일은 이제 서비스 fbagent와 웹 콘솔 HQbird Monitor가 합니다.
  • 새 기능: HQbird Cluster. 클러스터 관리자(RCM)와 각 서버의 노드가 웹 페이지에서 복제본 설정, 스위치오버, 페일오버, 재합류를 제공합니다.
  • 새 기능: HQCenter. 많은 HQbird 서버를 위한 자체 중앙 서버입니다. 콘솔은 하나이고, 구성 전달, 갱신, 라이선스, 문제 감시를 합니다.
  • 새 기능: fbmcp. AI 도우미가 Firebird DBA로 일하게 하는 MCP 서버입니다. 중대한 변경은 AI 클라이언트 밖에 있는 사람의 승인이 필요합니다.
  • 새 설치 프로그램. Firebird 메이저 버전마다 오프라인 설치 프로그램이 하나 있고, Windows(.exe)와 Linux(.run)용입니다. 서버 한 대에 Firebird 메이저 버전 여러 개와 인스턴스 여러 개를 둘 수 있습니다. 메이저 버전별 Docker 이미지도 있습니다.
  • 새 라이선스. 서명된 라이선스 파일, 등록 없이 7일인 체험, 라이선스 구역 EU / RU / BR.
  • 에이전트, HQbird Monitor, fbmcp, 클러스터 프로그램, Firebird의 자동 갱신. 서명 검사와 롤백이 있습니다.
  • 엔진. NGRAM 인덱스, 구체화 뷰, CREATE INDEX CONCURRENTLY, CREATE TABLE AS SELECT, 고급 트레이스 옵션, 데이터베이스별 연결 수 제한, Linux의 Active Directory 로그인.

2. 구성 요소: 2024와 2027

HQbird 2024 HQbird 2027
FBDataGuard(Java, 포트 8082의 웹 콘솔) fbagent(서비스) + HQbird Monitor(웹 콘솔) + Monitor 안의 구성 편집기
Advanced Monitoring Viewer(AMV), 데스크톱 도구 HQbird Monitor 페이지: 대시보드, 성능 보고서, 오류, 충돌, 통계
수동으로 또는 FBDataGuard에서 설정하는 복제, 수동 페일오버 HQbird Cluster: RCM + 노드, 스위치오버, 페일오버, 라우터
중앙 서버 없음 서버 집단을 위한 HQCenter(Linux)
AI 도구 없음 도구 약 120개를 갖춘 MCP 서버, fbmcp
구성 요소가 들어 있는 Windows 설치 프로그램 하나와 Linux 스크립트 Firebird 메이저 버전별 오프라인 설치 프로그램, .exe와 .run, Docker 이미지
이메일 주소와 암호로 하는 활성화 서명된 라이선스 파일, 체험, 라이선스 구역
FBDataGuard의 이메일 경보 HQCenter 상태 감시의 이메일. 에이전트의 Telegram, 웹훅, 이메일

3. 버전

구성 요소 키트 2027.2.33의 버전
Firebird(HQbird 빌드) 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917
fbagent 3.4.0
HQbird Monitor 1.57.0
구성 편집기(Monitor 안) 1.61.0
HQbird RCM / 클러스터 노드 2027.5.12
fbmcp 2027.2.24
HQCenter(goafts, site stack) 1.22.0
fblogspacker(fbagent 안) 1.5.12

4. Firebird 엔진(HQbird 빌드)

HQbird의 Firebird 빌드에는 같은 버전의 vanilla Firebird에는 없는 서버 수준 기능(플러그인과 코어 변경)이 있습니다. 표는 각 기능과, 그 기능이 있는 Firebird 메이저 버전을 보여 줍니다. 출처는 HQbird 2027 서버 수준 개선 페이지입니다.

기능 제공하는 것 매개변수 메이저 버전
NGRAM 인덱스 VARCHAR와 텍스트 BLOB에 대한 인덱스를 쓰는 부분 문자열 검색(LIKE '%search%') - 5.0
구체화 뷰 BI와 복잡한 쿼리를 위한 CREATE MATERIALIZED VIEW. 대량 삽입을 사용합니다 - 5.0
쿼리 결과로 만드는 테이블 CREATE TABLE AS SELECT. 대량 삽입을 사용합니다 - 5.0
부하가 있는 동안의 인덱스 생성 CREATE INDEX ... CONCURRENTLY: 테이블을 계속 사용할 수 있습니다 - 5.0
더 빠른 MON$ 테이블 필요하지 않은 데이터 수집을 끕니다 FillMonCompiledStatements, FillMonStatements, FillMonCallStack 5.0
5.0으로 옮기기 쉽게 예전 형식의 리터럴을 알아봅니다. 오래된 응용 프로그램을 위해 COUNT(*)를 INT로 기술합니다 LegacyTimeLiterals, LegacyIntForCount 5.0
GSSAPI/SSPI 인증 Active Directory용 gssauth 플러그인. Windows와 Linux의 서버와 클라이언트 - 5.0
INET 오류를 기록하지 않음 네트워크 오류를 firebird.log에 쓰지 않습니다 DisableLogNetIOErrors 5.0
경량 모니터링 부하 없이 서버 상태를 추적합니다 MonitoringPlugin 2.5, 3.0, 4.0, 5.0
데이터베이스 연결 수 제한 연결이 갑자기 늘어나는 것을 막습니다 WarnCountAttachments, MaxCountAttachments 3.0, 4.0, 5.0
고급 트레이스 옵션 충돌(데드락)과 변경(예를 들어 변경 감사)을 추적합니다 - 3.0, 4.0, 5.0
실행 중 쿼리 치환 서버가 쿼리 텍스트를 바꿉니다. 새 텍스트는 트레이스와 MON$에서 보입니다 SqlSubstDirectory 2.5, 3.0, 4.0, 5.0
임시 공간의 BLOB 캐시 BLOB이 15-200% 더 빨라집니다 BlobTempSpace 2.5, 3.0, 4.0, 5.0
큰 정렬이 있는 쿼리 로그 쿼리 텍스트를 firebird.log에 씁니다 TempSpaceLogThreshold 2.5, 3.0, 4.0, 5.0
외부 데이터 소스: MySQL과 ODBC MySQL과 ODBC로 가는 EXECUTE STATEMENT ... ON EXTERNAL - 3.0, 4.0, 5.0
스트리밍 / CDC(Kafka, RabbitMQ, JSON, Mongo) 고른 테이블의 INSERT/UPDATE/DELETE를 복제에 기반해 보냅니다. 요청 시 제공 - 4.0, 5.0
전문 검색(Lucene) 오픈 소스 UDR과, 스트리밍에 기반한 플러그인 - 3.0, 4.0, 5.0
캐시 매개변수 자동 수정 firebird.conf / databases.conf에 있는 잘못된 DefaultDbCachePages 값을 고칩니다 DefaultDbCachePages, MinDbCachePages, MaxDbCachePages 4.0, 5.0
HQbird 버전 가리기 Firebird API가 HQbird 버전 문자열을 돌려줄지를 설정합니다 HQbirdVersionString 2.5, 3.0, 4.0, 5.0
데이터베이스 암호화(플러그인) AES-256, 오버헤드 4-20%. 요청 시 제공 - 3.0, 4.0, 5.0
JOIN 옵티마이저 암시적 내부 조인을 명시적 조인으로 바꿉니다 LeftJoinConversion 3.0, 4.0
준비된 쿼리 캐시 준비된 쿼리를 연결 메모리에 남겨 둡니다 DSQLCacheSize 3.0, 4.0
다중 스레드 백업, 복원, 스윕, 인덱스 생성 백업과 스윕이 최대 4-6배, 복원이 2-4배 빨라집니다(8코어, SSD) - 2.5, 3.0, 4.0
네이티브 복제 플러그인. PK/UK가 없는 레코드를 제외할 수 있습니다 - 2.5, 3.0
큰 정렬의 옵티마이저 리페치 플랜 SortDataStorageThreshold 2.5, 3.0
병렬 데이터 읽기 make_dbkey()와 공유 스냅샷 - 2.5, 3.0
외부 연결 풀 Firebird로 가는 병렬 외부 쿼리 ExtConnPoolSize, ExtConnPoolLifeTime 2.5, 3.0
Amazon S3 백업(플러그인) 요청 시 제공 - 명시되지 않음

5. fbagent: FBDataGuard를 대신하는 에이전트

에이전트 하나가 Firebird 인스턴스 하나를 맡습니다. 호스트 하나에서 에이전트 여러 개를 실행할 수 있습니다. 에이전트는 Windows와 Linux의 Firebird 2.5, 3.0, 4.0, 5.0에서 동작합니다.

5.1 백업

  • 검증 백업(gbak). 데이터베이스 하나, 또는 폴더에 모은 데이터베이스 묶음이 대상이고, 테스트 복원은 선택입니다.
  • 증분 nbackup. 수준은 0에서 4. 모드는 단순, 고급, 그룹입니다.
  • nbackup 계획 모드: 규칙이 수준, 날짜, 시각을 정합니다. 편집기는 달력과 저장 공간 예측을 보여 줍니다. 보존은 수준 0과 그 증분을 함께 남깁니다.
  • 백업-복원 주기: 백업, 복원, 운영 중인 데이터베이스의 교체를 하고, 크래시 뒤에는 롤백합니다.
  • 복원 작업. .fbk 또는 .nbk에서. 로컬 또는 S3에서.
  • 압축: deflate, zip, gz, zstd.
  • 암호화: 키 위탁이 있는 AES-256 zip 아카이브.
  • 클라우드: 로컬 파일을 만들지 않는 S3 스트리밍 백업. S3와 FTP/FTPS로 복사.
  • 백업 목록: 모든 백업 파일과 모든 복원의 기록. 크기, 시각, 검증 결과를 포함합니다.
  • 명령 이력: 작업당 최대 50회 실행과 gbak 로그.

5.2 유지 보수

  • 스윕, 인덱스 통계, gfix 검증, 실행 시간이 있는 SQL 스크립트, 메타데이터 추적.
  • 모든 작업에 cron 일정과 실행 시간이 있습니다.
  • 중요한 작업의 지금 실행. 로컬, 또는 HQCenter를 거친 원격. 진행 표시와 취소가 됩니다.
  • 밤 시간대의 디스크 속도 테스트.

5.3 상태 점검

  • 약 10분마다의 서버 상태. 각 발견에는 수준, 근거의 줄, 힌트가 있습니다. 상태는 추세(예를 들어 디스크가 가득 차기까지 남은 시간)를 보여 주고, 문제 뒤에 있는 트랜잭션이나 프로그램의 이름을 밝힙니다.
  • 호스트 메트릭: 프로그램별 CPU와 메모리, 디스크별 지연과 IOPS, 어느 서비스가 디스크를 쓰는지, OS 캐시에 있는 데이터베이스.
  • Linux 제한: TasksMax, NPROC, NOFILE, OOM kill.
  • 디스크 공간: 여유 공간의 하한과, 빨리 차는 상태의 감지.
  • 로그: firebird.log와 replication.log를 시그니처로 분류합니다. 예를 들어 손상 가능성입니다.
  • 헤더 페이지에서 알 수 있는 데이터베이스 상태. 종료, nbackup 잠금, 복제본, 읽기 전용.
  • Firebird 모드: SuperServer, SuperClassic, Classic. 모드 변경이 재시작을 기다리면 발견이 됩니다.
  • 토큰이 있는 Prometheus /metrics 엔드포인트.
  • 리소스 가드가 에이전트 자신의 CPU와 메모리를 제한합니다. 백업을 멈추지는 않습니다.

5.4 성능

  • 워치독이 있는 연속 트레이스.
  • 시간 범위별 성능 보고서. 소요 시간, 빈도, 합계 시간, 페치, 읽기, 쓰기에 따른 순위. 플랜, 프로시저, 트리거. 누가, 언제, 어디에서 문을 실행했는지. 실패한 실행.
  • 고른 범위와 데이터베이스에 대한 요청 시 성능 보고서.
  • 양쪽 SQL이 있는 잠금 충돌과 데드락.
  • 클라이언트 응용 프로그램과 주소가 있는, 클래스별 트레이스 오류.
  • fblwmon 플러그인을 통한 경량 모니터링.

5.5 구성

  • 에이전트는 재시작 없이 구성을 다시 읽습니다. 검증, 백업, 오류 시 롤백이 있습니다.
  • databases.conf 편집기(2.5에서는 aliases.conf). 엔진 버전별 검사, 저장 전의 사본, 주석 유지.
  • 사용자: 보안 데이터베이스의 사용자 목록과 사용자 만들기.
  • HQCenter에서 오는 구성 전달. 각 변경의 상태는 보냄, 적용됨, 거부됨, 드리프트입니다.

5.6 로그 전달(fblogspacker)

  • 에이전트는 새 데이터만 HQCenter로 보냅니다. firebird.log와 replication.log의 새 끝부분, 분 단위 트레이스 파일과 모니터링 파일, 메트릭, 서버 상태입니다.
  • 아카이브에는 크기 상한이 있습니다(기본 120 MiB). 큰 파일은 조각으로 갑니다.
  • 백업과 데이터베이스는 보내지 않습니다.

6. HQbird Monitor: 새 웹 콘솔

Firebird 인스턴스마다 콘솔이 하나 있습니다(포트는 20000에 Firebird 포트를 더한 번호. 예: 23050). 또는 HQCenter에 속한 모든 서버를 위한 중앙 콘솔이 하나 있습니다.

  • 서버: 모든 서버. 상태, Firebird 버전과 모드, 에이전트 버전, 라이선스, 작은 차트.
  • 대시보드: CPU, 메모리, 연결. 프로그램별 CPU. 디스크와 메모리를 쓰는 주체. 임시 파일. 디스크 여유, 지연, 속도. 상태 배지가 있는 데이터베이스 표. 분을 누르면 그 분이 보입니다.
  • 서버 상태 보고서: 24시간, 7일 또는 14일 동안의 18개 계통 행렬. 문제의 시간순 기록. 영역별 발견. 디스크, 트랜잭션, 복제, 오류, 쿼리, 백업의 표. 동작 버튼을 누르면 편집기에서 고칠 곳이 열립니다.
  • 데이터베이스 페이지: 모니터링, I/O, 트랜잭션 차트. 고른 분의 상위 쿼리와 연결.
  • 성능 보고서: 순위 10가지, 시간대별 실행, 두 시간 범위의 비교, 문의 30일 이력, 요청 시 보고서.
  • 오류와 충돌: CSV 내보내기가 있는 트레이스 오류. 분당 잠금 충돌과 데드락.
  • 통계: 권고, 추세, 예측이 있는 gstat 분석. Excel과 JSON 내보내기.
  • 로그와 구성: 필터가 있는, 날짜별 firebird.log와 replication.log. .conf 파일의 변경 이력.
  • 작업, 백업, 활동: 내장 구성 편집기와 백업 목록.
  • 라이선스, 갱신, 사용자, 클러스터, 설정.
  • 알림 페이지(버튼은 서버 페이지에 있습니다). 누가 보내는지(에이전트, HQCenter, 둘 다, 또는 아무도 보내지 않음), 채널, 테스트 메시지, Telegram 봇의 채팅 ID, 최근 배달 50건. 이 페이지는 저장된 토큰, URL, 암호를 보여 주지 않습니다.
  • 언어: 영어, 러시아어, 독일어, 브라질 포르투갈어, 스페인어.
  • 접근: 로그인은 하나, 또는 서버 목록과 관리자 역할이 있는 여러 사용자. 감사 로그. 밝음, 어두움, 고대비 테마. 이름과 SQL 리터럴을 가리는 데모 모드. 인터넷 없이도 동작합니다.

7. HQbird Cluster: RCM과 노드

HQbird 2024에는 복제가 있었고, 클러스터 관리자는 없었습니다. HQbird 2027이 클러스터 관리자를 더합니다.

  • 구성. 각 Firebird 인스턴스 옆에 노드가 하나 있고, 클러스터마다 RCM이 하나 있습니다. 웹 콘솔(HTTPS, 포트 7444), 명령줄, API가 있습니다.
  • 복제는 비동기입니다. Firebird 4.0과 5.0은 네이티브 복제를 씁니다. HQbird 2.5와 3.0은 복제 플러그인을 씁니다.
  • HQCenter가 없는 클러스터. fbagent --cluster-init가 RCM과 첫 관리자를 만듭니다. 호스트 연결 페이지가 일회용 토큰으로 다른 서버를 참여시킵니다. 클러스터는 기본적으로 꺼져 있습니다. 설치할 때, 또는 HQbird Monitor에서 켭니다.
  • 콘솔에서 복제본 설정: 데이터베이스를 등록하고, 게시를 설정하고, 초기화합니다. 복사는 nbackup으로 만듭니다. 부드러운 재초기화는 긴 쓰기 트랜잭션을 기다립니다. 노드는 동작 중인 데이터베이스를 덮어쓰지 않습니다.
  • 손으로 만든 구성으로 이미 복제 중인 데이터베이스의 이어받기.
  • 마스터 하나에 대한 복제본 여러 개.
  • 데이터베이스마다의 상태와 지연(동기화됨, 지연, 재초기화 필요, 그 밖). 각각에 이유가 있습니다.
  • 검증: 마스터와 복제본의 행 수 비교. 요청 시 또는 일정에 따라 합니다.
  • 서비스: 논리 데이터베이스 하나를 여러 호스트에 둡니다.
    • 스위치오버는 데이터를 잃지 않습니다. 그 뒤 이전 마스터는 복제본으로 다시 합류합니다.
    • 수동 페일오버는 마스터 호스트를 잃었을 때 하며, 데이터 손실 보고가 붙습니다.
    • 자동 페일오버는 서비스마다 있고, 기본적으로 꺼져 있습니다. 라우터가 필요합니다.
    • 라우터(HAProxy, Linux)는 클라이언트에게 안정된 주소 하나를 줍니다.
  • 콘솔: 언어 6개, 읽기 전용 뷰어 역할, 감사 로그, 코드별 런북이 있는 경보.
  • 심각도 warn 이상의 문제를 위한 경보 채널(Telegram, 웹훅, 이메일). 경보 페이지에는 채널마다 테스트 버튼이 있습니다.
  • 보안: 클러스터 인증 기관 아래의 상호 TLS, 인증서 자동 갱신, 서명된 릴리스.

제한: 클러스터를 통한 동기 복제는 없습니다. 게시되는 테이블은 기본 키 또는 고유 키가 있는 테이블뿐입니다. 라이선스상 클러스터당 호스트는 최대 3대입니다. RCM은 클러스터당 하나입니다. 라우터는 Linux만 해당합니다. 스위치오버는 Linux의 Firebird 5.0에서 실험실 검증을 마쳤습니다.

안내: 클러스터 가이드, 클러스터 런북.

8. HQCenter: 많은 HQbird 서버를 위한 중앙 서버

  • 개요. 자신의 네트워크에 있는 Linux 서버입니다. 에이전트가 여기에 등록하고 데이터를 올립니다. 중앙 HQbird Monitor와 관리 패널이 있습니다.
  • 설치는 Ubuntu 22.04 / 24.04 / 26.04 또는 AlmaLinux 9 / 10에서 명령 하나입니다. 닫힌 네트워크도 지원하며, 가지고 온 번들로 설치할 수 있습니다.
  • 등록: 에이전트가 자신의 키를 만듭니다. 운영자가 승인하거나, 빈 시트가 있는 동안은 라이선스 토큰이 승인합니다. 에이전트 트래픽은 모두 상호 TLS입니다.
  • 서버 집단 표: 에이전트와 Firebird 버전, 마지막 연락, 릴리스 채널.
  • 에이전트로의 구성 전달. 이력과 복원이 있습니다. 어느 서버에서든 중요한 작업을 지금 실행할 수 있습니다.
  • 서버 집단 갱신: 에이전트, HQbird Monitor, 클러스터 프로그램, Firebird는 HQCenter 카탈로그에서 옵니다. 공급자 서명을 검사합니다.
  • HQCenter는 자신을 갱신합니다. 서명된 스택에서 하며, 검사와 자동 롤백이 있습니다. 소유자가 이것을 끌 수 있습니다.
  • 상태 감시: 모든 서버의 새 문제, 심각도가 올라간 문제, 해소된 문제. 이메일과 주간 보고서. Telegram, 웹훅, SMTP 채널, 조용한 시간, “무응답 서버” 이벤트.
  • 라이선스: 업로드, 에이전트에 할당, 시트 수.
  • 요청 감사: 누가 서버에서 무엇을 바꿨는지.
  • 범위가 있는 토큰을 쓰는 API. HQCenter 자신을 위한 Prometheus 메트릭과 Grafana 대시보드.
  • 관리 패널 언어는 4개입니다. 영어, 브라질 포르투갈어, 러시아어, 독일어.

안내: site-install.md.

9. fbmcp: AI 도우미를 위한 Firebird 도구

  • 데이터베이스 호스트에서 동작하는 MCP 서버입니다. AI 클라이언트(예를 들어 Claude Desktop 또는 Claude Code)가 이것을 써서 Firebird 2.5부터 5.0까지 살펴보고 관리합니다.
  • 도구 약 120개: 플랜과 통계가 있는 쿼리, 스키마, 세션, 인덱스 조언, gstat, 추세. 백업, 테스트 복원, 검증, 스윕. DDL과 마이그레이션. 사용자와 권한. 트레이스. firebird.conf. 스케줄러. fbagent용 도구 약 30개(상태, 보고서, 작업, 라이선스, 갱신). 클러스터(연결, 등록, 재초기화, 검증, 스위치오버, 페일오버).
  • 단계별 안전:
    • 읽기에는 승인이 필요 없습니다. 읽기 전용 트랜잭션에서 실행됩니다.
    • 보통의 변경은 AI 클라이언트 안에서 일회용 토큰으로 확인합니다.
    • 영향이 큰 변경은 AI 클라이언트 밖에서만 승인합니다(Windows에서는 트레이 창, 서버에서는 명령). 열려 있는 유지 보수 시간과, 만든 지 24시간이 되지 않은 검증된 백업도 필요합니다.
    • 데이터베이스 삭제는 꺼져 있습니다.
  • 모든 판단은 감사 로그에 남습니다.
  • HQbird 설치 프로그램은 fbmcp를 기본적으로 설치합니다. 로컬 사용만 해당합니다. 원격 사용에는 HTTPS와 API 키가 필요합니다.

10. 설치 프로그램

Windows

  • 설치 프로그램은 네 개이고, Firebird 메이저 버전마다 하나(fb25, fb30, fb40, fb50)입니다. 각각 오프라인이며, 필요한 파일은 모두 안에 있습니다.
  • 각 설치 프로그램은 Firebird, fbagent, HQbird Monitor, fbmcp를 설치합니다. 클러스터 프로그램은 복사되고, 켤 때까지 꺼져 있습니다.
  • 서버 한 대에 Firebird 메이저 버전 여러 개를 둘 수 있습니다. 같은 메이저 버전의 인스턴스도 여러 개 둘 수 있습니다.
  • 체험, 라이선스 파일, HQCenter 연결, 자동 갱신을 위한 마법사 페이지.
  • 페이지마다 스위치가 있는 무인 설치.
  • 마법사 언어는 8개입니다. 영어, 브라질 포르투갈어, 독일어, 러시아어, 스페인어, 폴란드어, 터키어, 간체 중국어.
  • 설치 프로그램과 제거 프로그램에는 Authenticode 서명이 있습니다.
  • 제거는 인스턴스 하나 또는 전부를 지웁니다. 데이터베이스는 항상 남습니다.

안내: HQbird Windows 설치 가이드.

Linux

  • Firebird 메이저 버전마다 오프라인 .run 파일이 하나입니다. 다운로드되는 것은 빠진 OS 패키지뿐입니다.
  • 대상 호스트: systemd와 apt, dnf/yum 또는 zypper가 있는 x86_64(Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS). SELinux enforcing 모드에서 동작합니다.
  • 기본은 전체 화면 텍스트 화면이고, 언어는 영어, 러시아어, 브라질 포르투갈어, 독일어입니다. --no-tui는 일반 텍스트 모드로 바꿉니다.
  • 호스트 하나에 인스턴스 여러 개를 둘 수 있습니다(Firebird 2.5는 인스턴스 하나).
  • --yes와 옵션으로 하는 무인 설치.

안내: HQbird Linux 설정 가이드.

Docker

  • 공개 이미지는 ghcr.io/ibsurgeon/hqbird2027-fb25, -fb30, -fb40, -fb50입니다. 컨테이너 하나가 모든 구성 요소가 있는 인스턴스 하나를 담습니다.
  • 이미지는 cosign으로 서명되어 있습니다.
  • compose 파일이 있는 클러스터 역할 HQBIRD_CLUSTER_ROLE=master|replica.
  • 이미지 안의 폴더는 다른 사용자에게 닫혀 있고, 새 컨테이너는 RCM 계정을 유지합니다.

안내: Docker 가이드.

11. 라이선스와 체험

  • 서명된 라이선스 파일. 에이전트는 공급자 서명을 검사합니다. 라이선스 처리가 데이터베이스를 멈추지는 않습니다.
  • 체험: 네트워크 절차 없이 7일. 업무용 이메일과 6자리 코드로 30일까지 늘릴 수 있습니다.
  • 라이선스 구역 EU, RU, BR. 각각 자신의 키가 있습니다.
  • 오프라인: 설치할 때 라이선스 파일을 줍니다. Windows 설치 프로그램은 라이선스 요청 파일을 만들 수 있습니다.
  • HQCenter가 있을 때: 라이선스를 한 번 올리고 에이전트에 할당합니다.
  • 새 라이선스는 스스로 도착합니다. 체험 요청으로 라이선스를 받은 에이전트는 한 시간에 한 번 공급자 라이선스 서버에 묻습니다. 서버가 그 에이전트에게 가지고 있는 라이선스를 설치합니다. 더 긴 체험, 체험에서 만든 유료 라이선스, 또는 구독의 다음 기간입니다. 서버에서 할 일은 없습니다. 공급자 라이선스 서버는 이런 라이선스 제공을 단계적으로 시작합니다.
  • 체험 30일이 지난 뒤에도 체험 요청을 보낼 수 있습니다. 그 이메일 주소는 라이선스가 있는 고객의 것일 수 있습니다.

12. 자동 갱신

  • 에이전트는 자신을 갱신합니다. 공급자 서명을 검사하고, 다운그레이드를 거부하며, 롤백할 수 있습니다.
  • 에이전트는 HQbird Monitor, fbmcp, 클러스터 프로그램, Firebird를 갱신합니다. Firebird 갱신에는 백업, 적용 시간, 상태 점검, 되돌리기가 있습니다.
  • HQCenter가 있을 때: 갱신은 릴리스 채널에 따라 HQCenter 카탈로그에서 옵니다.
  • HQCenter가 없을 때: 갱신은 공급자 구역에서 옵니다. 모드는 all, agent(Firebird는 관리자를 기다립니다), off입니다. HQbird Monitor의 갱신 페이지가 상태를 보여 줍니다.

13. 경보와 알림

  • HQCenter 상태 감시는 서버 집단의 문제에 대해 이메일을 보냅니다. 클러스터 콘솔은 경보를 보여 줍니다.
  • 에이전트는 서버 문제에 대해 자신의 메시지를 보냅니다. 문제가 새로 생겼을 때, 더 나빠졌을 때, 사라졌을 때입니다. 상태 점검 한 번의 변경은 메시지 한 통에 모입니다.
  • 채널은 직접 준비한 Telegram 봇, 웹훅(Slack, Teams, Discord, Mattermost, Rocket.Chat, ntfy), 이메일(SMTP)입니다. 심각도 필터와 조용한 시간이 있습니다. 채널은 여러 개일 수 있습니다. 채널을 더하기 전에는 아무것도 보내지 않습니다.
  • 일일 요약: 열려 있는 문제를 하루에 메시지 한 통으로 보냅니다(notify.daily_summary, 기본은 꺼짐).
  • 컴퓨터 한 대에 에이전트가 여러 개 있으면, 컴퓨터 자체의 문제(디스크, 메모리)를 보내는 것은 그중 하나뿐입니다.
  • 에이전트 명령은 두 개입니다. --notify-history [N]은 최근 배달을 출력하고, --notify-test <channel>은 테스트 메시지를 보냅니다.
  • 라이선스가 보내기를 허용하지 않는 동안 에이전트는 보내지 않습니다.
  • HQbird Telegram 봇: 유효한 라이선스가 있는 서버 또는 HQCenter가 일회용 코드로 채팅을 연결합니다. 자신의 봇은 필요 없습니다. 공급자 서버는 이 서비스를 아직 제공하지 않습니다. 제공이 시작될 때까지는 자신의 Telegram 봇, 웹훅 또는 이메일을 쓰십시오.
  • RCM은 클러스터 경보를 같은 종류의 채널로 보냅니다(rcm.json의 notify.channels).

14. 보안

  • 에이전트, HQCenter, 클러스터의 상호 TLS.
  • 서명된 릴리스. 유효한 공급자 서명이 없는 갱신을 에이전트는 거부합니다.
  • Windows 설치 프로그램과 프로그램에는 Authenticode. Docker 이미지에는 cosign.
  • 백업 아카이브의 AES-256 암호화.
  • 비밀은 명령줄과 구성 스냅샷에 들어가지 않습니다.
  • 에이전트의 요청 감사 로그. HQbird Monitor, HQCenter, RCM, fbmcp의 감사 로그.
  • 서버에서 원격 명령을 끌 수 있습니다(--remote-commands off).

15. HQbird 2024에서 업그레이드

  • 2027 설치 프로그램은 HQbird 2024를 찾고, Firebird를 그 자리에서 갱신하며, 이전 폴더를 사본으로 남깁니다.
  • FBDataGuard 작업은 첫 시작 때 한 번 가져옵니다. 대상은 gbak, nbackup(수준 0에서 4), 그룹 백업, 스윕, 인덱스 통계입니다. 에이전트는 기존 백업 세트를 이어서 갑니다.
  • 가져오지 않는 것: 복제, 트레이스, 파일 전송, 클라우드 백업, 복원, 검증. 편집기에서 다시 설정합니다.
  • 2024 라이선스는 넘어가지 않습니다. 새 에이전트는 체험 모드로 시작합니다. 2027 라이선스를 설치하십시오.
  • 제거된 것: 포트 8082의 FBDataGuard 콘솔, AMV, VSS 백업, FTP 서버, SFTP 업로드.
  • 2024 설치 프로그램용 스크립트에서는, 2027에 해당하는 스위치가 있으면 받아들입니다. 그 밖의 스위치는 거부하고, 대체 이름을 메시지에 적습니다.
  • 가져오기는 FBDataGuard의 데이터베이스를 등록합니다. 등록 위치는 Firebird 별칭 파일입니다(databases.conf. Firebird 2.5에서는 aliases.conf). 이전 파일은 먼저 복사합니다. 경로가 이미 파일에 있거나 그 파일이 없으면 그 데이터베이스는 빠집니다. include 지시가 있는 파일은 바꾸지 않습니다.
  • 가져오기는 FBDataGuard의 이전 모니터링 로그를 지웁니다(폴더 mon\outcoming과 mon\outtrace). 이전 HQbird의 서비스가 동작하는 동안에는 아무것도 지우지 않습니다. 삭제는 되돌릴 수 없습니다.
  • 둘 다 기본적으로 켜져 있습니다. 끄려면 hqbird_import.register_databases 또는 hqbird_import.clean_mon_logs를 false로 두거나, --no-register-databases와 --no-clean-mon-logs를 --import-hqbird-config와 함께 쓰십시오.