HQbird 2027의 새로운 기능
이 문서는 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 서명이 있습니다.
- 제거는 인스턴스 하나 또는 전부를 지웁니다. 데이터베이스는 항상 남습니다.
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와 함께 쓰십시오.