설치 및 업데이트
예상치 못한 일 없는 설치
Firebird 라인당 하나의 설치 프로그램. 서버에서 Firebird, 이전 HQbird 및 에이전트를 찾아내고 계획을 보여주며, "예"라고 말하기 전까지는 아무것도 변경하지 않습니다. 그 후에는 에이전트가 스스로 업데이트되고, 콘솔과 Firebird도 자체적으로 업데이트되며, 검사와 롤백이 함께 이루어집니다.
- 4개 설치 프로그램: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 계획을 확인하기 전 0건의 변경
- 인터넷 불필요 모든 것이 하나의 파일에
- Windows 및 Linux 마법사, 자동 모드, .run
- 롤백 설치 또는 업데이트 실패 시
setup.exe · .run
키트 구성
설치 프로그램은 하나의 파일입니다: Windows용 hqbird2027-fb50-setup-<version>.exe 또는 Linux용 hqbird2027-fb50-linux-<version>.run. 서버에 필요한 모든 것이 포함되어 있습니다. 아무것도 다운로드하지 않습니다.
각 설치 프로그램은 하나의 Firebird 라인을 설치합니다. 데이터베이스가 실행되는 라인을 선택하세요. 설치는 키트 내부의 에이전트가 수행합니다: 서버를 검사하고 계획을 세운 뒤 실행합니다.
| 구성 요소 | 기능 | Windows | Linux |
|---|---|---|---|
| Firebird, HQbird 빌드 | 새 서버 또는 제자리 업데이트. 이미 설치된 서버의 경우 firebird.conf에 한 줄이 추가됩니다: MonitoringPlugin = fblwmon. 새 서버의 경우 설치 프로그램이 포트도 설정합니다. databases.conf, 보안 DB 및 SYSDBA 비밀번호는 변경되지 않습니다. | 서비스 FirebirdServer… | /opt/firebird |
| fbagent 에이전트 | 백업, 모니터링, 유지보수, 업데이트. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, 사용자 firebird |
| HQbird Monitor | 이 서버용 웹 콘솔. 포트 = 20000 + Firebird 포트: 3050의 경우 23050입니다. 포트는 설치 시 선택되며, 나중에 Firebird 포트를 변경하더라도 변경되지 않습니다. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| 클러스터 구성 요소 | 클러스터 프로그램은 서버에 배치되지만 활성화되지 않습니다: RCM과 페어링 창은 기본적으로 꺼져 있습니다. RCM은 서버를 새 클러스터의 중심으로 만들고 포트 7443 및 7444를 엽니다. 페어링 창은 24시간 동안 포트 7450–7459를 엽니다: 이를 통해 다른 서버의 RCM이 이 서버를 초대할 수 있습니다. 설치 후에도 둘 다 켤 수 있습니다. | 마법사 페이지 "Replication and cluster setup"; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| fbmcp MCP 서버 | AI 클라이언트의 Firebird 접근. 기본적으로 이 서버에서만 가능합니다. | 마법사의 확인란 또는 /NOFBMCP | --no-fbmcp |
| Firebird 디버그 파일 | Firebird 충돌 분석용 심볼. | — | 예, --no-debug로 끕니다 |
- Windows지원: Windows 10 및 11, Windows Server 2016 이상, 64비트. 관리자 권한. 설치 프로그램은 IBSurgeon Software에서 서명합니다: Windows는 권한 프롬프트에 게시자를 표시합니다.
- 마법사 또는 자동 모드모든 마법사 페이지는 스위치로도 사용할 수 있습니다:
/VERYSILENT /YES /LOG=…. 스크립트와 수백 대의 서버에 적합합니다. - 8개 언어 마법사영어, 포르투갈어(브라질), 독일어, 러시아어, 스페인어, 폴란드어, 터키어, 중국어 간체. 기본값은 Windows 언어입니다. 스위치:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - 서버 이름마법사가 새 에이전트의 이름을 묻습니다; HQCenter는 이 이름으로 서버를 표시합니다. 기본값은 컴퓨터 이름입니다. 자동 모드:
/AGENTID=, Linux에서는--agent-id. 이미 설치된 에이전트는 이름을 유지합니다.
- Linuxx86_64, 커널 3.2 이상, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS 및 apt, dnf, yum 또는 zypper가 있는 기타 배포판.
- 인터넷 없는 서버설치 프로그램은 저장소에서 몇 가지 OS 라이브러리(libtommath, ICU)를 가져옵니다. 저장소가 없으면 정확한 명령을 출력하고 아무것도 변경하지 않습니다.
키트는 두 번 검사됩니다. 압축 해제 전: 전체 키트의 sha256. Firebird와 에이전트 설치 전: 각 파일의 서명. 손상된 다운로드는 Firebird, 에이전트 또는 콘솔에 어떤 변경도 가하기 전에 설치를 중단합니다.
fbagent --install-plan
먼저 계획, 그 다음 변경
먼저 설치 프로그램은 읽기만 합니다: 서비스, 레지스트리, Firebird 및 HQbird 폴더. 그런 다음 발견한 것과 수행할 작업을 보여줍니다. 변경은 "예"라고 말한 후에 시작됩니다.
서버에 있는 것을 선택하고 계획을 확인하세요. 텍스트는 축약 및 번역되었으며, 순서와 결정은 Firebird 5.0 설치 프로그램과 동일합니다.
- 1서버 검사권한, 비트 수; Linux에서는 systemd와 커널도
- 2키트 검사압축 해제 전 sha256; 설치 전 파일 서명
- 3계획발견한 것과 수행할 작업
- 4질문HQCenter용 서버 이름; Firebird 중지? 다른 버전?
- 5설치Firebird, 에이전트, 콘솔, 서비스
- 6✓ 결과서비스, 콘솔 주소, 로그인
문제가 발생하면
계획 단계에서의 거부(포트 사용 중, 폴더가 비어 있지 않음)는 아무것도 바꾸지 않습니다. 설치 프로그램이 그 이유를 알려줍니다. 마법사에서는 값이 잘못된 동안에는 페이지를 떠날 수 없습니다.
에이전트 서비스가 시작되기 전에 설치 중 실패하면 서비스는 이전 상태로 돌아갑니다. 중지되었던 이전 HQbird는 다시 시작됩니다.
| 코드 | 의미 (Linux .run) |
|---|---|
| 0 | 완료 |
| 1 | 거부됨: 서버, 스위치 또는 계획. 아무것도 변경되지 않음 |
| 2 | 설치 실패, 변경 사항 롤백됨 |
| 3 | 롤백 불완전: 결과에 확인할 사항이 표시됨 |
| 4 | 응답 필요: 터미널도 --yes도 없음 |
| 5 | 키트가 검사를 통과하지 못함: 다시 다운로드하십시오 |
| 6 | OS 라이브러리도 저장소도 없음 |
| 7 | 배포판 패키지의 Firebird |
| 코드 | 의미 (Windows setup.exe) |
|---|---|
| 0 | 설치됨 |
| 1 | 설치 전 거부됨: 잘못된 스위치 또는 파일, 더 새로운 버전이 설치되어 있음, 관리자 권한 없음 |
| 4 | 설치 프로그램에 질문이 있었지만 /YES 스위치가 없음 |
| 7 | 서버 검사 또는 설치 실패. 이유는 로그와 결과 파일에 있음 |
| 10 | 설치되었지만 HQCenter 연결 실패 |
-p3050)가 사용됩니다. 새 설치에서는 -fb50이 사용됩니다.FBDataGuard → fbagent
HQbird 2024에서 이전하기
설치 프로그램이 이전 HQbird와 그것이 서비스하는 Firebird를 찾습니다. 이 Firebird는 제자리에서 업데이트되고, FBDataGuard 작업은 에이전트로 이동하며, 이전 서비스는 중지됩니다. 데이터베이스, 구성 및 비밀번호는 그대로 유지됩니다.
- 변경되지 않는 것
databases.conf또는aliases.conf, 보안 DB, SYSDBA 비밀번호, 데이터베이스, 백업 및 이전 HQbird 파일.firebird.conf에는MonitoringPlugin = fblwmon줄이 없으면 추가됩니다. - 이전 Firebird의 복사본이전 Firebird의 프로그램 폴더는 옆에
<folder>.old_<time>으로 보관됩니다. - 작업gbak 및 nbackup 백업, sweep, 인덱스 통계. 가져오기는 한 번 실행되며 새 구성의 검사를 거칩니다. 이전 구성은 보관됩니다.
- 이전 백업에이전트는 FBDataGuard 저널의 백업을 자체 기록으로 가져옵니다. 보존 규칙과 복원은 새 백업과 동일하게 처리합니다. nbackup 레벨의 이름은 동일하게 유지됩니다.
- 작업 이름작업 이름은 FBDataGuard의 데이터베이스 이름으로 끝납니다(예: "Verified backup - MANUAL"). 그룹 작업은 원본 폴더의 트리를 반복합니다.
- 이전 서비스: 세 가지 옵션자동(권장): FBDataGuard가 서비스하는 모든 Firebird에 에이전트가 있으면 비활성화합니다. 모두 비활성화:
/DISABLEHQBIRD. 그대로 두기:/NOHQBIRD. - 되돌릴 수 있음비활성화되기 전 각 서비스의 상태는
fbagent-hqbird-takeover.json에 저장됩니다. 이 파일로 이전 HQbird를 다시 켤 수 있습니다. - 라이선스이전 HQbird 라이선스는 이전되지 않습니다. 새 라이선스를 받거나 HQCenter에 연결할 때까지 평가 기간이 진행됩니다.
- 불명확한 경로가져오기가 FBDataGuard 경로의 치환을 확장할 수 없으면 그대로 두고 작업을 비활성화된 상태로 남깁니다. 경로를 수정하고 작업을 활성화하십시오.
작업이 가져와졌지만 이전 서비스가 여전히 실행 중이면(예: 서버에 FBDataGuard 아래에 두 개의 Firebird 서버가 있는 경우), 작업은 비활성화된 상태로 도착합니다. 이렇게 하면 하나의 작업이 두 번 실행되지 않습니다.
포트 · 폴더 · 서비스
한 머신에 여러 Firebird 서버
Firebird당 하나의 에이전트. 새 인스턴스는 자체 포트, 자체 에이전트 및 자체 콘솔을 사용하여 다른 인스턴스 옆에 설치됩니다. 설치된 인스턴스는 변경되지 않습니다.
Firebird 서버를 추가하고 설치 프로그램이 선택하는 이름과 포트를 확인하십시오.
- 라인별 포트서버의 첫 번째 Firebird는 3050을 사용합니다. 다음 인스턴스는 2.5의 경우 3052, 3.0의 경우 3053, 4.0의 경우 3054, 5.0의 경우 3055를 사용합니다. 설치 프로그램은 사용 중인 포트를 가져가지 않습니다.
- 같은 라인의 두 번째 인스턴스폴더 및 서비스 이름에
-2번호가 붙습니다. Windows에서는 마법사의 "다른 인스턴스 설치" 옵션이며, 포트는 해당 라인 범위에서 첫 번째로 비어 있는 포트입니다.
- 업데이트는 같은 라인 내에서만5.0.x → 5.0.y. 3.0에서 5.0으로 이동한다는 것은 첫 번째 인스턴스 옆에 두 번째 인스턴스를 두는 것을 의미하며, 백업 및 복원으로 데이터베이스를 옮깁니다.
- Windows의 XNET포트 3050에 있지 않은 Firebird는 자체 이름
IpcName = FIREBIRD_<port>을 갖습니다. 두 번째 서버에 대한 로컬 XNET 연결이 작동합니다. - 에이전트당 하나의 콘솔20000 + Firebird 포트에서 실행되는 HQbird Monitor: 23050, 23055. 서버의 모든 인스턴스에 대해 하나의 로그인 파일을 사용합니다.
- 포트는 고정됩니다콘솔과 에이전트 로컬 API의 포트는 설치 시 기록됩니다. 나중에 Firebird 포트를 변경해도 그대로 유지됩니다. 에이전트는 동일한 포트를 허용하지 않습니다.
- 클러스터: 에이전트별 슬롯서버의 각 에이전트는 0에서 9까지의 자체 슬롯을 받습니다: 페어링 포트 7450 + 슬롯, 노드 포트 7051 + 슬롯 및 7061 + 슬롯. 따라서 한 서버의 두 에이전트가 클러스터에 참여할 수 있습니다.
--pairing-port스위치로 슬롯을 명시적으로 설정합니다.
이미지 · compose · 포트
Docker에서의 HQbird
각 Firebird 라인에 대해 준비된 이미지가 있습니다. Firebird, 에이전트 및 HQbird Monitor가 컨테이너에서 실행됩니다. 에이전트는 서버가 클러스터에 참여할 때 컨테이너 자체 내부에 클러스터 노드를 설치합니다. 이 서버가 클러스터 RCM으로 지정된 경우에만 RCM을 설치합니다.
| 이미지 | Firebird | Firebird 포트 | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- 첫 시작키트에서
compose.yaml을 복사하고, SYSDBA 비밀번호를 시크릿 파일에 넣고,secrets:줄에서#을 제거한 다음docker compose up -d를 실행합니다.docker compose ps에healthy가 표시되면 서버가 준비된 것입니다. - Firebird 포트
HQBIRD_FB_PORT변수이며 기본값은 3050입니다. HQbird Monitor는 20000 + 이 포트에서 수신 대기합니다. - 이미지 서명이미지는 cosign 도구로 서명됩니다. 검증용 공개 키는 아직 게시되지 않았습니다.
- 한 호스트의 여러 인스턴스Firebird는 3050 + N, HQbird Monitor는 20000 + Firebird 포트, 클러스터 노드는 7051 + N. 호스트의 한 인스턴스만 RCM을 가질 수 있습니다.
- 외부와 내부의 동일한 포트 번호
3051:3050이 아닌3051:3051로 게시하십시오. 에이전트와 클러스터는 컨테이너 내부에서 보이는 포트를 보고합니다. - 클러스터멤버 주소는 Docker 호스트의 주소입니다. 노드 포트를 게시하고, RCM의 경우 포트 7443과 7444를 게시하십시오.
Docker는 ufw를 우회하여 포트를 게시합니다. "포트 22만" 허용하는 ufw 규칙은 컨테이너 포트를 닫지 않습니다. 포트를 하나의 호스트 주소에 게시하거나 외부 방화벽으로 닫으십시오.
클라우드 및 Docker: 설정, 볼륨, 포트, 업데이트에이전트 · 콘솔 · 클러스터 · Firebird
설치 후 업데이트
HQCenter에 연결한 후 에이전트는 자체적으로 자신, HQbird Monitor, 클러스터 구성 요소, fbmcp 및 Firebird를 업데이트합니다. HQCenter가 없는 서버도 자체적으로 업데이트됩니다: 에이전트는 IBSurgeon 업데이트 서버에서 새 버전을 가져옵니다.
에이전트는 1분 이내에 HQCenter에서 자신의 새 버전을 확인합니다. HQbird Monitor, fbmcp 및 Firebird의 새 버전은 1시간 이내에 확인합니다. 모든 업데이트는 하나의 패턴을 따릅니다: 확인, 롤백 지점 저장, 교체, 작동 확인. 작동하지 않으면 이전 버전을 복원합니다.
HQCenter 없이 업데이트
- 자체적으로 업데이트되는 항목에이전트, HQbird Monitor 및 MCP 서버. 확인은 6시간마다 한 번 실행됩니다.
- Firebird는 명령을 기다립니다Firebird 패키지가 다운로드되어 대기합니다. 관리자가 업데이트 페이지의 버튼 또는
fbagent --firebird-update --apply명령으로 적용합니다. - 모드 선택설치 스위치
--auto-update all|agent|off, Windows에서는/AUTOUPDATE=all|agent|off.agent가 기본값입니다.all은 업데이트 창에서 Firebird도 설치합니다.off는 아무것도 확인하지 않습니다.
- HQbird Monitor의 업데이트 페이지에이전트가 버전을 가져오는 위치, 모드 및 서버의 마지막 응답, Firebird, 콘솔 및 MCP 서버 업데이트의 상태를 표시합니다. 관리자는 모드를 변경하고 Firebird 패키지를 적용합니다.
- 소스 확인업데이트 서버는 고정된 키로 확인됩니다. 공급업체 서명은 항상 필요합니다.
- 클러스터는 센터를 통해 진행클러스터 노드와 RCM은 이 방식으로 업데이트되지 않습니다: HQCenter 또는 RCM이 업데이트합니다.
에이전트 자체 업데이트
- 전진만 허용에이전트는 자신보다 오래된 버전을 설치하지 않으며, 필수 버전이라도 마찬가지입니다. 확인은 첫 바이트를 다운로드하기 전에 실행됩니다. 이렇게 하면 가짜 서버가 취약한 이전 빌드를 되살릴 수 없습니다. 예외는 에이전트 자체 설정에서 허용된 하나의 이전 버전입니다(
allow_downgrade_to). - 서명릴리스는 Ed25519 키로 서명되며, 공개 키는 에이전트에 내장되어 있습니다. 잘못된 서명은 항상 거부됩니다. “서명된 것만” 모드는 서버가 아닌 에이전트 자체 설정에서 켜집니다.
- 수동 롤백에이전트 옆에
rollback_to_version_NNN스크립트가 있습니다. 이 스크립트는 이전 에이전트와 설정을 복원하고 실패한 버전을 차단합니다. 최근 두 개의 롤백 지점이 유지되며, 더 오래된 것은 자동으로 삭제됩니다. - Linux: root는 자신의 사본만 실행에이전트는
firebird로 실행됩니다. 교체는 root만 쓸 수 있는 폴더에 있는 검증된 사본에 의해 수행됩니다.
Firebird 업데이트
Firebird는 해당 라인 내에서만, 그리고 더 새로운 빌드로만 업데이트됩니다. 에이전트는 언제든지 패키지를 다운로드하고 준비할 수 있지만, 업데이트 창에서만 Firebird를 중지합니다.
- 1준비다운로드, 서명, 엔진보다 오래되지 않은 빌드
- 2창매일 창; 필수 릴리스도 창을 기다림
- 3작업gbak, nbackup 또는 SQL 스크립트 실행 중: 시도 연기
- 4교체이전 엔진 파일은 따로 보관, 설정은 유지
- 5확인Firebird가 시작되고 포트에서 응답
- 6✓ 또는 롤백이전 파일 복원, 빌드 차단
| 업데이트 대상 | 보호 | 실패 시 |
|---|---|---|
| fbagent 에이전트 | 서명, 더 새로운 것만, 180초 이내 준비 및 45초 실행 | 롤백, 30분 일시 중지; 두 번째 실패 시 버전 차단 |
| HQbird Monitor, 클러스터, fbmcp | 서명, 설치된 것보다 새로운 것만 | 이전 버전 유지; 최근 2개 사본 보관 |
| Firebird | 창, 백업 대기, 시작 후 확인 | 이전 엔진 복원, 빌드는 차단 목록으로 |
차단된 버전은 다시 설치되지 않지만, 다음 버전은 평소처럼 설치됩니다. 이렇게 하면 서버가 “업데이트 → 롤백 → 업데이트"를 반복하지 않습니다.
폴더 · 로그 · 제거
파일 위치 및 제거 방법
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, 설정, 보안 DB fbagent-fb50\ 에이전트 및 HQbird Monitor agent_config.json 에이전트 설정 logs\ bak\ update\ 로그, 사본, 업데이트 캐시 C:\HQbirdData\ 에이전트 및 콘솔 작업 데이터 config\access.properties 콘솔 로그인 C:\ProgramData\fbagent\ 설치 결과 및 로그
Linux
/opt/firebird/ Firebird 5.0 (두 번째 라인: /opt/fb50) /opt/hqbird/ conf/access.properties 콘솔 로그인, 0600 fbagent-fb50/ 에이전트 및 HQ Monitor agent_config.json 에이전트 설정 logs/ bak/ update/ 로그, 사본, 업데이트 캐시 /var/lib/hqmonitor/ 콘솔 데이터 /var/log/fbagent/install.log 설치 로그, 비밀번호 없음
- 제거해도 데이터베이스는 건드리지 않음데이터베이스와 백업(
*.fdb,*.gdb,*.fbk,*.nbk)은 항상 유지됩니다. 데이터 제거는 보안 DB와 Firebird 패키지의 샘플만 삭제합니다. - Windows"앱": 에이전트, 콘솔, 이 에이전트의 RCM, 방화벽 규칙, 그리고 이 설치 프로그램이 새로 설치한 Firebird를 제거합니다. 다른 에이전트가 이 에이전트의 RCM을 사용하는 경우 마법사가 "이 인스턴스를 그래도 제거하시겠습니까?"라고 묻습니다. 자동 제거에는
/FORCE가 필요합니다. 업데이트된 Firebird는 유지됩니다. 설정과 보안 DB는 "데이터 제거"를 선택한 경우에만 삭제됩니다.
- Linux
--uninstall은 에이전트 및 콘솔 서비스, 이 에이전트의 RCM, sudoers 규칙, 그리고 설치 프로그램이 firewalld 또는 ufw에서 연 포트를 제거합니다. 에이전트는 먼저 클러스터에서 나갑니다. 다른 에이전트가 이 에이전트의 RCM을 사용하는 경우--force스위치가 필요합니다. Firebird는 유지됩니다.--remove-data는 설정, 로그, 콘솔 데이터도 제거합니다. - 이전 HQbirdHQbird 2027을 제거해도 이전 서비스가 다시 켜지지 않습니다. 관리자가 상태 파일을 사용하여 결정합니다.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2