이 페이지는 기계 번역되었습니다. 영어 원본을 읽어보세요. English

이 안내서는 오프라인 설치 프로그램 hqbird2027-fbNN-linux-<version>.run을 사용하여 Linux 서버에 HQbird 2027을 설치하는 관리자를 위한 것입니다. 새 설치, 이전 HQbird 및 이전 HQbird 2027 버전의 업데이트, 유지 관리 명령, HQCenter 연결, 무인(스크립트) 설치, 그리고 설치 후 파일 위치를 다룹니다.

예제는 Ubuntu 24.04에서 Firebird 5.0용 설치 프로그램을 보여줍니다. Firebird 2.5, 3.0, 4.0용 설치 프로그램도 동일하게 작동하며, 버전, 기본 포트, 폴더 이름만 다릅니다. Windows 설정은 Windows installation에 설명되어 있습니다.

목차

  1. 1. 설치 프로그램이 설치하는 것
  2. 2. 설치 개요
  3. 3. 새 설치
  4. 4. 설치 후
  5. 5. 이전 HQbird 업데이트(2024 및 이전)
  6. 6. HQbird 2027을 새 버전으로 업데이트
  7. 7. 유지 관리 명령
  8. 8. HQCenter에 연결
  9. 9. 무인 설치 및 스크립트
  10. 10. 문제 해결

1. 설치 프로그램이 설치하는 것

하나의 .run 파일 = 하나의 Firebird 라인. 데이터베이스가 사용하는 Firebird 버전의 설치 프로그램을 선택하십시오:

설치 프로그램 설치 또는 업데이트하는 Firebird 호스트의 첫 Firebird 크기
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (HQbird 빌드) /opt/firebird, 포트 3050 약 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (HQbird 빌드) /opt/firebird, 포트 3050 약 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (HQbird 빌드) /opt/firebird, 포트 3050 약 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (HQbird 빌드) /opt/firebird, 포트 3050 약 80 MB

모든 설치 프로그램은 인터넷 없이 다음을 포함하고 설치합니다:

  • Firebird (해당 라인의 HQbird 빌드): 새 서버, 또는 호스트에 이미 있는 해당 라인의 Firebird를 제자리에서 업데이트합니다. firebird.conf, databases.conf(2.5의 경우 aliases.conf), 보안 데이터베이스 및 SYSDBA 비밀번호는 유지됩니다.
  • Firebird 디버그 파일 (충돌 분석용 심볼), Firebird 폴더에 설치됩니다. --no-debug는 이를 건너뜁니다.
  • HQbird 에이전트 (fbagent): systemd 유닛 hqbirdfbagent-fb50, 사용자 firebird로 실행되며 백업, 모니터링, 유지 관리 작업 및 업데이트를 수행합니다. 이름은 Firebird 라인(-fb25 … -fb50)으로 끝납니다. 해당 라인의 두 번째 인스턴스는 -fb50-2입니다.
  • HQ Monitor: 이 HQbird 인스턴스의 웹 콘솔, 유닛 hqbirdmonitor-fb50, 주소 http://<server>:<20000 + Firebird port>/ (포트 3050의 Firebird의 경우: http://localhost:23050/).
  • 클러스터 구성 요소: 클러스터 콘솔 RCM(hqbirdrcm)과 클러스터 노드(hqclusternode)가 에이전트의 캐시에 복사됩니다. 에이전트(fbagent) 3.1.0 이상이 포함된 키트는 기본적으로 클러스터를 만들지 않습니다: RCM 없음, 페어링 창 없음, 방화벽에 클러스터 포트 없음. 두 가지 질문(또는 --rcm on, --cluster-pairing on)으로 이를 켤 수 있습니다(섹션 3의 “Next: cluster”). RCM을 사용하면 /opt/hqbirdrcm에 설치되고 유닛 hqbirdrcm으로 실행됩니다. 요약에는 RCM: 줄에 주소가 표시됩니다. 노드는 RCM에서 호스트를 연결할 때 해당 유닛(예: hqclusternode-master-p3050)을 갖습니다. 이전 에이전트가 있는 2027.2.19부터의 키트는 각 서버에 RCM을 설치하고(--rcm off는 캐시에 남겨둠) 페어링 창을 엽니다. 2027.2.19 이전의 키트는 두 구성 요소를 에이전트의 캐시에만 복사합니다: 유닛 hqbirdrcm도 RCM: 줄도 없습니다.

2027.2.9 이전에 설치된 인스턴스는 에이전트 이름에 Firebird 포트가 있습니다: 폴더 /opt/hqbird/fbagent-p3050, 유닛 hqbirdfbagent-p3050 및 hqbirdmonitor-p3050. 업데이트는 이러한 이름을 변경하지 않습니다. 새 인스턴스만 -fb<NN> 이름을 받으므로 한 호스트에 두 형식이 모두 있을 수 있습니다.

요구 사항: x86_64, 커널 3.2 이상, systemd; apt, dnf/yum 또는 zypper가 있는 Linux(Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS 등); root. 설치 중 /var/tmp에 약 300 MB의 여유 공간(프로그램이 실행될 수 있는 폴더, --tmpdir 참조). 몇 가지 OS 라이브러리(libtommath, ICU)는 배포판의 저장소에서 가져옵니다. 인터넷이 없는 서버는 이를 준비하기 위한 정확한 명령을 받습니다(섹션 9).

지원되지 않음: 배포판의 패키지(firebird3.0-server, firebird rpm)에서 설치된 Firebird. 설치 프로그램은 아무것도 변경하기 전에 중지됩니다(종료 코드 7). 먼저 패키지를 제거하거나(데이터베이스의 gbak 백업 유지) --import-firebird와 함께 온라인 설치 프로그램을 사용하십시오.

한 서버에 여러 Firebird 라인: 각 라인에는 자체 설치 프로그램이 있습니다. 호스트의 첫 Firebird는 /opt/firebird로 이동합니다. 두 번째 라인은 /opt/fb<NN>(/opt/fb50, /opt/fb40, /opt/fb30)으로 이동하며 해당 라인의 포트(3.0의 경우 3053, 4.0의 경우 3054, 5.0의 경우 3055)를 사용합니다. 해당 포트가 사용 중이면 설치 프로그램이 중지되고 --port N을 요청합니다. 한 라인의 여러 인스턴스(다른 포트의 두 번째 Firebird 5.0)는 --fb-root <new folder> --port <port>로 설치됩니다(섹션 7). Firebird 2.5는 /opt/firebird에 하나의 인스턴스만 있습니다. 그 옆에 두 번째 서버를 두려면 다른 라인(예: /opt/fb50의 Firebird 5.0)을 사용하십시오.

포트 3050 및 3051의 두 인스턴스에 대한 단계별 런북이 모든 라인에 대해 복사-붙여넣기 명령과 함께 hqbird2027-linux-two-instances-runbook.ru.md(러시아어) 및 hqbird2027-linux-two-instances-runbook.pt.md(포르투갈어)에 있습니다.

평가판: 라이선스가 없으면 에이전트는 7일 평가판을 실행합니다. 평가판 이메일(--email)은 이를 30일로 연장합니다. 라이선스 파일(--license) 또는 HQCenter 연결(섹션 8)이 평가판을 대체합니다.

업데이트: 키트 2027.2.31(에이전트 3.3.0)부터 HQCenter에 연결되지 않은 서버는 공급업체의 업데이트 서버를 확인합니다. 기본적으로 에이전트, HQ Monitor 및 fbmcp는 스스로 업데이트되며, 새 Firebird 패키지가 다운로드되어 대기합니다. --auto-update all|agent|off 또는 텍스트 인터페이스의 Updates 줄이 이를 변경합니다(섹션 4의 “Updates without HQCenter”). HQCenter에 연결된 서버는 해당 HQCenter에서 업데이트를 받습니다.

2. 설치 개요

Diagram

서버 검사와 설치 자체는 설치 프로그램이 포함한 HQbird 에이전트(fbagent --install-plan, fbagent --setup-install)에 의해 수행됩니다. 누락된 OS 패키지를 제외하고는 아무것도 다운로드되지 않습니다. 계획이 확인되기 전에는 아무것도 변경되지 않습니다. OS 패키지는 확인 후에 설치됩니다. 터미널에서 2027.2.30 이후의 키트는 텍스트 인터페이스를 엽니다(섹션 3의 3단계). --no-tui는 질문을 텍스트 줄로 묻는 일반 설치 프로그램을 실행합니다. 터미널이 없고 --yes도 없으면 설치 프로그램은 확인 단계에서 종료 코드 4로 중지됩니다. 에이전트 유닛이 시작되기 전에 설치가 실패하면 에이전트는 유닛을 이전 상태로 롤백합니다(종료 코드 2, 롤백이 완료되지 않은 경우 코드 3, 요약에 확인할 사항이 표시됨).

3. 새 설치

1단계: 설치 프로그램 다운로드 및 확인

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

다른 라인은 fb40, fb30, fb25로 동일한 이름을 가집니다. 예상 결과: hqbird2027-fb50-linux-2027.2.9.run: OK. 인터넷이 없는 서버: 동일한 링크로 PC에서 두 파일을 다운로드하고 서버로 복사하십시오(scp, USB 드라이브, 공유).

설치 프로그램은 압축을 풀기 전에 자체 페이로드도 확인합니다: 잘린

또는 손상된 다운로드는 종료 코드 5(“다시 다운로드하십시오”)와 함께 중단됩니다.

2단계: 호스트를 변경하지 않고 확인하기 (선택 사항)

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check

--check는 호스트 검사를 실행하고, 누락된 OS 라이브러리(및 인터넷이 없는 서버에서 이를 확보하는 명령)를 보고하며, 에이전트가 발견한 것과 수행할 작업을 표시한 후 종료합니다. 아무것도 설치되지 않습니다.

3단계: 설치 프로그램 실행하기

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

2027.2.30 이후의 키트는 터미널에서 시작하면 텍스트 인터페이스를 엽니다. 계획과 설정이 표시된 전체 화면 페이지입니다. 2027.2.30까지의 키트와 아래 “일반 설치 프로그램"에 나오는 경우는 질문을 텍스트 한 줄씩 표시합니다. 둘 다 동일한 옵션으로 동일한 설치를 수행합니다.

텍스트 인터페이스

설치 프로그램은 호스트를 확인하고, 자체 압축을 풀고, 계획을 읽은 후 첫 페이지를 표시합니다. Install 페이지에서 설치를 시작하기 전까지는 호스트의 어떤 것도 변경되지 않습니다.

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

상단 줄은 현재 설정에 대한 계획입니다. 즉, 계획 코드와 설치 프로그램이 Firebird 및 에이전트에 대해 수행할 작업입니다. 불가능한 계획은 빨간색으로 이유와 함께 표시되며, 커서는 이를 해결하는 설정 위에 놓입니다. 변경할 때마다 설치 프로그램은 계획을 다시 읽습니다.

키 기능
위, 아래 커서 이동 (k, j도 가능)
Enter 커서 아래의 설정 열기, 항목 선택, 입력한 값 수락
Space 구성 요소 켜기 또는 끄기 (Components 페이지)
Esc 이전 페이지로 돌아가기; 첫 페이지에서는 설치 프로그램 종료 (먼저 확인을 요청함)
Ctrl+C 설치 프로그램 즉시 중지 (종료 코드 2). Install 페이지 이전에는 아무것도 변경되지 않음

값을 입력하는 페이지(폴더, 포트, 주소)에서는 Enter로 값을 수락하며, 빈 값은 “자동"을 의미합니다. Esc는 이러한 페이지를 떠나지 않습니다.

설정 선택 항목 동일한 옵션
Language 영어, 러시아어, 브라질 포르투갈어, 독일어; 페이지가 즉시 변경됨 --lang
Firebird folder 새 Firebird의 폴더 또는 업데이트할 Firebird의 폴더. Firebird 2.5는 폴더가 하나이므로 해당 설치 프로그램에는 이 줄이 없음 --fb-root
Firebird port Firebird의 TCP 포트 --port
Agent id 자동, 호스트 이름, 호스트 이름과 인스턴스, 또는 직접 입력한 값. 새 에이전트에만 해당: 설치된 에이전트는 ID를 유지하며 이 줄은 표시되지 않음 --agent-id
SYSDBA password 새 Firebird의 경우: 생성됨 또는 직접 입력 --sysdba-pass-file
HQ Monitor 웹 콘솔의 포트 및 로그인 --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License 지금 안 함, 이메일을 통한 30일 평가판(주소, 개인정보 보호 고지, 지역), 또는 라이선스 파일 --email --accept-privacy --trial-zone, --license
HQCenter HQCenter의 attach.json 파일 --attach
Cluster 클러스터 관리자 RCM(클러스터 ID, 관리자 비밀번호), 검색 모드, 페어링 포트 --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Firebird 디버그 파일; fbmcp 및 원격 모드의 주소 --no-debug, --no-fbmcp, --fbmcp-allow-from
Updates HQbird만(에이전트, HQ Monitor 및 fbmcp는 스스로 업데이트하고, 새 Firebird는 사용자를 기다림), HQbird 및 Firebird(Firebird도 스스로 업데이트하며, 밤 03:30부터 04:00까지 Firebird 재시작 포함), 또는 끄기. 2027.2.31부터의 키트; attach.json 파일이 없는 새 에이전트에만 해당: 연결된 에이전트의 업데이트는 HQCenter가 제어함 --auto-update

명령줄의 옵션은 페이지가 시작하는 값입니다. sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055는 RCM이 켜지고 포트가 3055인 상태로 첫 페이지를 엽니다.

설정 아래의 네 줄:

  • Install은 계획을 전체 표시한 후 Start the install now?를 묻고 커서는 No에 놓입니다. 계획의 질문(이전 HQbird, 중지할 실행 중인 Firebird)은 같은 페이지에 있습니다. Yes는 모든 질문에 답합니다. Yes 이후 페이지가 닫히고, 설치 프로그램은 아래 일반 설치 프로그램에서처럼 일반 화면에 로그와 요약을 출력합니다.
  • Plan details는 계획 코드의 의미, 설치 프로그램이 호스트에서 발견한 것, 경고 및 설치할 OS 패키지를 표시합니다.
  • About plans는 모든 코드(M1 … M17)를 나열합니다. 코드에서 Enter를 누르면 설명이 표시됩니다. *는 현재 계획의 코드를 표시합니다.
  • Quit은 설치 프로그램을 종료합니다(종료 코드 1). 아무것도 변경되지 않았습니다.

일반 설치 프로그램

일반 설치 프로그램은 다음 중 하나에 해당할 때 실행됩니다:

  • 옵션 --no-tui 또는 변수 HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin 또는 stdout이 터미널이 아님: 스크립트, 터미널 없는 ssh host 'command', 또는 ... 2>&1 | tee install.log와 같은 파이프;
  • TERM이 dumb이거나 설정되지 않음;
  • 창이 80열 x 24행보다 작음(tmux에서 상태 표시줄이 있는 80x24 터미널은 23행임: 창을 더 크게 만들거나 --no-tui 사용);
  • 호스트의 bash가 4.4보다 오래됨(RHEL 7, CentOS 7);
  • 키트가 2027.2.30 이하임.

창과 bash의 경우, 출력의 첫 줄이 페이지가 열리지 않은 이유를 알려줍니다.

Firebird가 없는 서버에서 일반 설치 프로그램의 일반적인 실행 예:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

이 예는 키트 2027.2.9의 것입니다. 키트 2027.2.19부터 요약에는 클러스터 콘솔의 RCM: 및 Pairing: 줄도 포함됩니다(아래 “다음: 클러스터”). 에이전트 3.1.0 이상이고 클러스터를 선택하지 않은 경우 다음과 같습니다:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

각 줄의 의미:

  • host: 배포판 및 커널; 설치 프로그램은 x86_64가 아니거나, systemd가 없거나, 3.2보다 오래된 커널을 실행하는 호스트를 거부합니다.
  • OS libraries: 이 제품군의 Firebird가 OS에서 필요로 하는 것(섹션 9). 계획은 누락된 패키지(OS packages to install)를 나열하며, 확인 후 설치 프로그램은 배포판의 저장소에서 이를 가져옵니다. 저장소가 없으면 종료 코드 6과 함께 중단됩니다

명령을 출력합니다.

  • plan: 에이전트가 찾은 것(found Firebird ..., HQbird: ... 줄)과 수행할 작업: Firebird new(새 서버), update(이 줄의 Firebird를 제자리에서 업데이트), 또는 이유와 함께 거부(종료 코드 1, 변경 없음).
  • Install as planned? Yes/No: 무엇이든 변경되기 전의 마지막 질문입니다. y로 답하십시오. plan에 자체 질문이 있는 경우(더 오래된 HQbird, 다른 버전)에는 그 질문이 대신 나옵니다(섹션 5). 터미널이 없으면 --yes를 전달하십시오. 그렇지 않으면 설치 프로그램이 종료 코드 4로 중지됩니다.
  • Cluster 질문(에이전트 3.1.0 이상): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] 및 Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. 기본값은 No입니다. 첫 번째는 호스트에 RCM이 없고 에이전트가 어떤 클러스터에도 속해 있지 않을 때만 질문합니다. 두 번째는 에이전트가 클러스터에 속해 있거나 RCM을 실행 중일 때는 질문하지 않습니다. --yes와 터미널 없는 실행은 No로 답합니다 (종료 코드 4 없음).
  • HQ Monitor: 주소와 로그인. 새 설치에는 로그인 admin이 부여되며, 생성된 비밀번호는 /opt/hqbird/conf/access.properties에 있습니다(모드 0600, root와 에이전트만 읽을 수 있음). 호스트의 모든 HQbird 2027 인스턴스가 이 파일을 공유합니다. 비밀번호는 HQ Monitor에서 변경하십시오.

새 Firebird의 SYSDBA 비밀번호는 생성되어 /root/fbagent-install-sysdba.txt에 저장됩니다(모드 0600): 주석 줄, 그다음 SYSDBA_PASS=<password> 줄. 같은 호스트에 나중에 설치되는 추가 Firebird는 이 파일에서 같은 비밀번호를 받습니다. 직접 설정하려면 --sysdba-pass-file <file>(파일의 첫 줄) 또는 --sysdba-pass <password>를 전달하십시오.

설치 프로그램의 언어

2027.2.30 이후의 키트는 네 가지 언어를 지원합니다: 영어, 러시아어(ru), 브라질 포르투갈어(pt-BR), 독일어(de). 설치 프로그램은 다음 순서로 언어를 선택합니다:

  1. 옵션 --lang en|ru|pt-BR|de;
  2. 변수 HQBIRD_LANG;
  3. 콘솔의 로캘(LC_ALL, 그다음 LC_MESSAGES, 그다음 LANG), UTF-8 로캘일 때;
  4. 영어.

출력의 두 번째 줄은 어떤 언어인지와 변경 방법을 알려줍니다. 이 줄은 항상 영어입니다:

text
[install] Language: Русский (auto). Use --lang en to change.

참고:

  • PuTTY는 LANG을 서버로 보내지 않습니다. 서버 자체의 로캘이 기준이 되므로 언어는 흔히 영어입니다. --lang을 사용하십시오.
  • --yes를 사용하고 터미널이 없으면 자동 언어는 영어입니다: 스크립트가 그 출력을 읽습니다. --lang은 그 경우에도 작동합니다.
  • 설치 프로그램은 다른 언어를 위해 호스트에 UTF-8 로캘이 필요합니다 (C.UTF-8 또는 en_US.UTF-8). 자체적으로 하나를 설정합니다. 없으면 영어로 진행합니다.
  • 텍스트 인터페이스에서 첫 페이지의 Language 줄은 언어를 즉시 변경합니다. 터미널은 UTF-8을 표시해야 합니다(PuTTY: Window, Translation, Remote character set UTF-8, 이것이 기본값입니다).
  • 영어가 유지되는 부분: 설치 자체의 진행 줄, Done: 요약, /var/log/fbagent/install.log, 그리고 호스트 스캔의 경고.

plan의 코드

plan에는 코드가 있습니다: M1, M2, … 설치 프로그램이 호스트에서 발견한 사례를 나타냅니다. 설치 프로그램은 코드의 의미를 출력합니다:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help는 모든 코드를 출력하고 종료합니다. 아무것도 변경하지 않습니다. 텍스트 인터페이스에서 첫 페이지는 코드와 그 제목을 보여주고, “Plan details"는 텍스트를 보여주며, “About plans"는 모든 코드를 나열합니다.

코드 설치 프로그램이 찾은 것 Firebird 에이전트 이전 HQbird
M1 없음 새로 설치 새로 설치 —
M2 이 줄의 Firebird, 이전 HQbird 없음 업데이트 새로 설치 —
M3 다른 줄의 Firebird, 이전 HQbird 없음 새로 설치, 포트 305N 새로 설치 —
M4 이 줄의 Firebird를 서비스하는 이전 HQbird 업데이트 새로 설치 꺼짐, 해당 작업은 활성 상태로 가져옴
M5 다른 줄의 이전 HQbird; 이 줄의 Firebird가 있음 질문 후 업데이트 새로 설치 계속 작동
M6 다른 줄의 이전 HQbird; 이 줄의 Firebird 없음 질문 후 새로 설치 새로 설치 계속 작동
M7 알려진 버전의 로컬 Firebird가 없는 이전 HQbird 업데이트 또는 새로 설치 새로 설치 계속 작동, 경고
M8 다른 Firebird를 위한 HQbird 2027 에이전트 업데이트 또는 새로 설치 첫 번째 옆에 새로 설치 변경 없음
M9 M8과 같고, 이전 HQbird가 이 줄을 서비스함 업데이트 첫 번째 옆에 새로 설치 꺼짐, 해당 작업은 활성 상태로 가져옴
M10 에이전트가 이미 이 Firebird를 서비스함(반복 실행) 업데이트 제자리 실행 중이면 꺼짐
M11 --fb-root가 이 줄의 Firebird임 업데이트 새로 설치 또는 제자리 위와 같음
M13 --fb-root가 빈 폴더 또는 새 폴더임 해당 폴더에 새로 설치 새로 설치 위와 같음

거부의 코드(종료 코드 1, 변경 없음): M12 폴더에 설치 프로그램이 업데이트할 수 없는 Firebird가 있음(다른 줄, 읽을 수 없는 버전, 비활성화된 서비스); M14 폴더가 비어 있지 않고 Firebird가 없음; M16 이 줄의 Firebird 서버가 여러 개임, --fb-root를 지정하십시오; M17 Firebird 2.5는 /opt/firebird에서만 작동합니다. M15는 에이전트 전용 키트입니다: Firebird는 설치되지 않고 업데이트되지도 않습니다.

에이전트 id

에이전트 id는 HQCenter, 라이선스, 클러스터에서 에이전트를 식별합니다. 첫 설치 시에만 설정됩니다:

  • 기본값: 호스트 이름 + 날짜 + 인스턴스, 예: srv1261114-fb50.
  • --agent-id ID는 직접 id를 지정합니다(1-128자의 문자, 숫자, ., _ 또는 -; 첫 글자는 문자 또는 숫자).
  • 설치 프로그램은 호스트의 다른 에이전트가 가진 id를 거부합니다.
  • 텍스트 인터페이스의 Agent id 페이지는 자동 id, 호스트 이름, 인스턴스가 포함된 호스트 이름, 직접 입력한 값을 제공하고, 호스트가 이미 가진 id를 나열합니다.
  • 설치된 에이전트는 자신의 id를 유지합니다. 반복 실행 시 plan에 표시되며(id srv1 (kept)), 텍스트 인터페이스에는 그때 Agent id 줄이 없고, --agent-id는 경고만 표시합니다. 이전 설치가 구성을 남긴 폴더에 새 에이전트를 설치하면 그 구성의 id도 유지됩니다.

4단계: 결과 확인

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

샘플 데이터베이스의 전체 경로를 사용하십시오: 모든 줄에서 작동하며 업데이트 후에도 작동합니다. 반면 이전 설치에서 유지된 databases.conf에는 employee 별칭이 없을 수 있습니다(2027.2.3의 새 설치에는 있습니다).

브라우저에서 http://<server>:23050/을 열고 /opt/hqbird/conf/access.properties의 비밀번호로 admin으로 로그인하십시오. Firebird 포트와 HQ Monitor 포트는 firewalld가 실행 중이면 firewalld(zone public)에서, 그렇지 않으면 ufw가 활성이면 ufw에서 열립니다. 다른 방화벽을 사용하는 경우 직접 여십시오. 클러스터 포트는 클러스터 옵션에 대해서만 열립니다: --rcm on이면 7443, 7444 및 노드 포트; --cluster-pairing on이면 노드 포트 및 페어링 포트. 활성 방화벽이 없으면 설치 프로그램은 열지 않은 포트를 한 줄로 출력합니다. 설치 전에 열려 있던 포트는 그대로 유지됩니다.

다음: 클러스터

마스터 서버에서 복제 서버로 데이터베이스를 복제하려면 클러스터 콘솔 RCM에서 두 서버를 연결하십시오. 에이전트 3.1.0 이상에서는 마스터에만 RCM을 설치하고(--rcm on, 또는 y로 답변) 복제 서버에서 discovery 모드를 켜십시오(--cluster-pairing on). Discovery 모드는 24시간 동안 페어링 창을 엽니다: 에이전트 슬롯의 페어링 포트(첫 번째 인스턴스는 7450, 두 번째는 7451, 최대 7459)가 방화벽에서 열리고, RCM이 에이전트를 초대할 수 있습니다. 하나의 호스트에는 하나의 RCM이 있습니다(포트 7443 및 7444). RCM을 만든 에이전트가 이를 실행하며 페어링 창을 열지 않습니다.

나중에 설치 프로그램 없이: HQ Monitor → Clusters → Cluster on this server, 또는 fbagent --cluster-init <id> 및 fbagent --cluster-pairing on. 2027.2.19 이후의 키트에서 이전 에이전트를 사용하는 경우 각 서버에서 RCM을 시작하고 요약의 RCM: 줄에 해당 주소를 출력합니다. 2027.2.19 이전의 설치본은 더 새로운 키트로 업데이트하면 RCM을 얻게 됩니다(섹션 6). 클러스터 가이드(키트 2027.2.33 기준)는 두 개의 새 서버에서 작동하는 복제본까지 단계별로 스크린샷과 함께 안내합니다: Linux 클러스터 가이드 (러시아어 및 포르투갈어로도 제공). 동일한 단계를 명령어만으로 정리한 것: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. 설치 후

유닛

유닛 설명 실행 계정
firebird (2.5, 4.0, 5.0은 /opt/firebird에 있음); firebird-superserver (3.0은 /opt/firebird에 있음); 다른 폴더의 경우 폴더 이름의 / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0은 /opt/fb50, /opt/fb40-2에 있음), firebird.opt_fb30-superserver (3.0은 /opt/fb30에 있음) Firebird 서버 firebird
hqbirdfbagent-fb50 (두 번째 인스턴스는 hqbirdfbagent-fb50-2; 2027.2.9 이전에는 hqbirdfbagent-p<Firebird 포트>) HQbird 에이전트 firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; 2027.2.9 이전에는 hqbirdmonitor-p<Firebird 포트>) HQ Monitor firebird

세 유닛 모두 활성화되어 있으며 부팅 시 시작됩니다. journalctl -u hqbirdfbagent-fb50은 에이전트의 유닛 로그를 보여줍니다. Firebird 3.0에는 또한 firebird-classic.socket 및 [email protected] 유닛이 있으며 (다른 폴더에서는 firebird.opt_fb30-classic.*), Firebird 2.5에는 firebird.socket이 있습니다: 이들은 inactive 상태로 유지되며, 이는 정상입니다. Firebird 2.5 프로세스는 fb_smp_server(SuperClassic)입니다.

파일 위치

예시는 포트 3050에서 /opt/firebird에 있는 첫 번째 Firebird 5.0 인스턴스입니다. 해당 라인의 두 번째 인스턴스는 에이전트 이름에 -2가 붙습니다 (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). 2027.2.9 이전에 설치된 인스턴스는 이 이름들에 포트가 포함됩니다 (fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

설치 프로그램은 /var/tmp에 아무것도 남기지 않습니다: 작업 폴더 /var/tmp/hqbird2027.XXXXXX는 오류 후에도 끝에서 제거됩니다.

로그

로그 위치
설치 프로그램 터미널; /var/log/fbagent/install.log
에이전트 /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50
HQ Monitor journalctl -u hqbirdmonitor-fb50; 감사 로그 /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

HQCenter 없이 업데이트

키트 2027.2.31(에이전트 3.3.0)부터 HQCenter에 연결되지 않은 에이전트는 벤더의 업데이트 서버에서 새 버전을 가져옵니다. 업데이트 모드는 agent_config.json의 update.mode 키입니다:

모드 자동으로 업데이트되는 항목
agent (기본값) 에이전트, HQ Monitor 및 fbmcp. 새 Firebird 패키지는 다운로드되어 관리자를 기다림
all 위와 동일하며 Firebird도 적용 시간대(밤 03:30~04:00; 업데이트가 Firebird를 재시작함)에 업데이트됨
off 아무것도 안 함: 에이전트가 업데이트 확인을 하지 않음. 업데이트하려면 새 버전의 설치 프로그램을 실행(섹션 6)
  • 설치 시: 텍스트 인터페이스의 Updates 줄, 또는 --auto-update all|agent|off. 이를 지정하지 않으면 설치 프로그램은 모드를 변경하지 않습니다.
  • 나중에: HQ Monitor의 Updates 페이지, 또는 --auto-update <mode>로 설치 프로그램을 다시 실행.
  • 상태: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (스크립트용으로 --json 추가). 릴리스 소스, 영역 및 업데이트 서버의 마지막 응답을 출력합니다.

에이전트는 다음 주소로만 나가는 HTTPS 연결을 엽니다. 들어오는 포트는 필요하지 않습니다.

용도 주소
업데이트, EU 영역 liceu.ibsurgeon.com:9443
업데이트, BR 영역 licbr.ibsurgeon.com:9443
업데이트, RU 영역 licru.ibsurgeon.com:20943
평가판 라이선스 trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

HQCenter에 연결된 서버는 업데이트 주소를 사용하지 않습니다: 해당 HQCenter에서 업데이트를 가져옵니다(섹션 8).

알림

키트 2027.2.33(에이전트 3.4.0)부터 에이전트는 서버 문제에 대한 메시지를 자체 Telegram 봇, 웹훅 또는 이메일(SMTP)로 보냅니다. 설치 프로그램은 채널을 설정하지 않으며, 채널을 추가할 때까지 아무것도 전송되지 않습니다: HQ Monitor → Servers → Notifications. 명령줄에서 채널을 테스트하려면: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history는 마지막 전송 내역을 출력합니다.

5. 이전 HQbird 업데이트(2024 및 이전)

설치 프로그램은 /opt/hqbird에 설치된 HQbird(FBDataGuard)와 그 유닛, 그리고 그것이 관리하는 Firebird 서버를 찾습니다. 그런 다음 HQbird 설치 스크립트와 동일한 규칙을 따릅니다:

Diagram

터미널에 표시되는 내용:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • 계획에는 업데이트되는 Firebird가 명시됩니다. --fb-root와 --port로는 이를 옮길 수 없습니다(해당 유닛이 이미 사용 중이기 때문입니다).
  • Confirm to stop running Firebird? 질문은 엔진을 중지해야 할 때 표시되며, 그 앞 줄에 열린 연결이 표시됩니다. Another version은 이전 HQbird가 다른 버전의 Firebird를 관리할 때 표시됩니다(그것을 업데이트하거나, 그 옆에 새로 설치). --yes는 모든 질문에 예로 답합니다. 터미널이 없고 --yes도 없으면 설치 프로그램은 종료 코드 4로 중지하며 아무것도 변경하지 않습니다.
  • --disable-hqbird는 어떤 경우에도 이전 HQbird 유닛을 끕니다. --no-hqbird는 이전 HQbird를 그대로 둡니다(HQbird 2027 옆에서 계속 실행됨).
  • SYSDBA 비밀번호는 묻지 않습니다. 에이전트가 이전 HQbird에서 가져옵니다.
  • HQ Monitor는 이전 HQbird의 로그인 정보를 사용합니다. 해당 파일 /opt/hqbird/conf/access.properties가 유지되므로, 이전에 사용하던 로그인과 비밀번호로 로그인하십시오. 설치 프로그램은 이 파일을 firebird에 모드 0600으로 부여합니다(이전 HQbird는 모든 사용자가 읽을 수 있게 두었습니다). 이전 HQbird의 게스트 로그인(access.guest-login)은 HQ Monitor에서 사용되지 않습니다.

유지되는 항목: firebird.conf, databases.conf / aliases.conf, 보안 데이터베이스, SYSDBA 비밀번호, 데이터베이스, 백업, 그리고 이전 HQbird의 파일들. 업데이트는 Firebird 프로그램 파일을 제자리에서 교체하며, 교체된 파일은 /opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/ 에 보관됩니다(최신 두 개의 업데이트가 유지됨). HQbird 작업(백업, 스윕, 모니터링)은 새 에이전트로 가져옵니다. 이전 HQbird의 HQbird 라이선스는 이전되지 않습니다. 새 에이전트는 라이선스가 설치되거나 서버가 HQCenter에 연결될 때까지 체험판으로 실행됩니다.

킷 2027.2.33(에이전트 3.4.0)부터 이전 HQbird의 구성 가져오기는 두 가지를 더 수행합니다:

  • 이전 HQbird의 데이터베이스를 Firebird 별칭 파일(databases.conf, 2.5의 경우 aliases.conf)에 name = path 줄로 등록합니다. 이전 파일은 먼저 복사됩니다. 데이터베이스의 경로가 이미 파일에 있거나 해당 파일이 존재하지 않으면 제외됩니다. include 지시문이 있는 파일은 변경되지 않습니다.
  • 이전 HQbird의 오래된 모니터링 로그를 제거합니다. 출력 폴더의 mon/outcoming 및 mon/outtrace 폴더 내용을 제거합니다(폴더는 유지됨). 이전 HQbird의 서비스가 실행 중이면 아무것도 제거되지 않습니다. 제거는 되돌릴 수 없습니다. 이 로그가 필요하면 설치 전에 복사하십시오.

둘 다 기본적으로 켜져 있습니다. agent_config.json의 hqbird_import.register_databases와 hqbird_import.clean_mon_logs 키 (둘 다 HQ Monitor의 구성 편집기에 있음)는 이후 가져오기에서 이들을 끕니다. 설치 프로그램에는 이에 대한 옵션이 없습니다.

인수 전 이전 HQbird 유닛의 상태는 /opt/hqbird/fbagent-hqbird-takeover.json에 저장됩니다. --uninstall은 이들을 다시 켜지 않습니다.

무인 실행 형식:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

6. HQbird 2027을 새 버전으로 업데이트

같은 계열의 더 새로운 설치 프로그램을 HQbird 2027이 있는 호스트에서 실행하면 설치된 인스턴스를 제자리에서 업데이트합니다: Firebird, 디버그 파일, 에이전트, HQ Monitor. 구성, 데이터베이스, 체험판 또는 라이선스 상태, HQ Monitor 포트 및 로그인 정보는 유지됩니다.

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

텍스트 인터페이스의 첫 페이지에는 Plan M10: Update of an installed HQbird 2027, id가 (kept)인 에이전트가 표시되며, Agent id 줄은 없습니다. Install을 선택하면 업데이트가 시작됩니다. 일반 설치 프로그램은 다음을 출력합니다:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

업데이트는 에이전트 폴더와 유닛의 이름을 변경하지 않습니다. 이 예의 인스턴스는 2027.2.9 이전에 설치되었으며 fbagent-p3050을 유지합니다.

설치 프로그램의 Firebird 빌드가 이미 설치된 것과 같으면(예를 들어 2.5용 모든 HQbird 2027의 Firebird 2.5.9.27194), 에이전트와 HQ Monitor만 업데이트됩니다. Firebird는 중지되지 않으며 Confirm to stop 질문도 없습니다.

이전 HQbird 2027로 설치된 인스턴스의 유지된 databases.conf에는 employee 별칭이 없을 수 있습니다. 샘플 데이터베이스에는 전체 경로로 연결하십시오(섹션 3, 4단계). Firebird 3.0에서 2027.2.0에서의 업데이트는 /opt/firebird/examples/empbuild/employee.fdb를 모드 0444로 남기며, Firebird는 이를 열 수 없습니다(no permission for read-write access). 샘플 데이터베이스가 필요하면: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. 사용자 자신의 데이터베이스는 건드리지 않습니다.

  • 같은 계열의 인스턴스가 여러 개 있으면 업데이트할 인스턴스를 지정하십시오: --fb-root /opt/fb50-2 --port 3056.
  • 설치된 버전 위에서 같은 설치 프로그램을 다시 실행하면 복구입니다: 프로그램 파일과 유닛이 다시 작성되고 데이터는 유지됩니다.
  • HQCenter에 연결한 후(섹션 8)에는 에이전트, HQ Monitor, Firebird 및 클러스터 구성 요소가 HQCenter 카탈로그에서 업데이트됩니다. 그러면 새 설치 프로그램이 필요하지 않습니다.
  • HQCenter에 연결되지 않은 서버에서 에이전트 3.3.0 이상(2027.2.31 이후 킷)은 업데이트 모드가 off가 아닌 한(섹션 4의 “Updates without HQCenter”) 에이전트, HQ Monitor 및 fbmcp를 스스로 업데이트합니다. 2027.2.31 이전에 설치한 경우에는 더 새로운 설치 프로그램으로 한 번 업데이트한 후 이 기능을 사용할 수 있습니다. 설치 프로그램으로 업데이트하면 업데이트 모드가 유지되며, --auto-update <mode>로 변경합니다.

7. 유지 관리 명령

모든 유지 관리 작업은 옵션을 지정한 설치 프로그램 실행 또는 에이전트 폴더의 에이전트 명령입니다. 터미널에서 --yes 없이 실행하면 이러한 옵션이 이미 설정된 상태로 텍스트 인터페이스가 열립니다(2027.2.30 이후 킷). 첫 페이지에서 계획을 확인한 다음 Install을 선택하십시오.

작업 명령
이 계열의 다른 인스턴스 sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
복구 / 업데이트 sudo sh hqbird2027-fb50-linux-<ver>.run (인스턴스가 여러 개인 경우: --fb-root <folder> --port <port>)
HQCenter에 연결 설치 중 sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json, 또는 나중에 cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
체험판 이메일 보내기 cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
메일의 체험판 코드 확인 cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (또는 HQ Monitor에서)
라이선스 파일 설치 설치 중 --license <file>, 또는 cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
설치 상태 sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
업데이트 상태 (HQCenter 없음) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
업데이트 모드 변경 (HQCenter 없음) HQ Monitor의 Updates 페이지, 또는 sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
제거 sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

다른 인스턴스

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056

새 Firebird는 /opt/fb50-2(새 폴더 또는 빈 폴더)에 설치되고, 유닛은 firebird.opt_fb50-2이며, 자체 에이전트(/opt/hqbird/fbagent-fb50-2, 유닛 hqbirdfbagent-fb50-2)와 자체 HQ Monitor(http://localhost:23056/, 유닛 hqbirdmonitor-fb50-2)를 가집니다. 에이전트는 해당 라인의 가장 낮은 사용 가능한 번호를 받습니다: 두 번째 인스턴스의 경우 fb50-2이며, 2027.2.9 이전에 설치된 에이전트(fbagent-p3050) 옆에서도 마찬가지입니다. HQ Monitor 로그인 파일 /opt/hqbird/conf/access.properties는 호스트의 인스턴스들이 공유합니다: --hqmonitor-login 없이 생성된 새 인스턴스는 기존 로그인을 유지하며, 어느 인스턴스에서든 --hqmonitor-login/--hqmonitor-password-file을 지정하면 모든 인스턴스의 로그인이 변경됩니다(이전 파일은 access.properties.bak-<time>으로 보관됨). Firebird 2.5는 두 번째 인스턴스를 지원하지 않습니다: 설치 프로그램이 refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder>와 함께 중단됩니다(종료 코드 1, 변경 사항 없음). 그 옆에 다른 라인의 Firebird를 설치하십시오. 예: sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

제거

Windows 및 Linux에서의 제거, 클러스터 내 서버, 디스크에 남는 항목은 제거 가이드에 자세히 설명되어 있습니다. 요약하면:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

--agent-dir 없이 설치 프로그램은 /opt/hqbird에 있는 유일한 에이전트를 제거합니다. 호스트에 여러 에이전트가 있으면 중단되고(종료 코드 1), 해당 폴더를 나열하며 --agent-dir을 요청합니다:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

--uninstall은 에이전트와 해당 HQ Monitor의 유닛 (hqbirdfbagent-fb50, hqbirdmonitor-fb50), 에이전트와 그 프로그램 (fbagent, hqmonitor)의 sudoers 규칙을 중지 및 제거하고, 설치 시 firewalld 또는 ufw에서 열었던 HQ Monitor 포트를 닫습니다. 에이전트 폴더는 구성 및 로그와 함께 유지됩니다; --remove-data는 해당 폴더와 /var/lib/hqmonitor/의 HQ Monitor 데이터도 제거합니다. Firebird는 설치된 상태로 유지됩니다(유닛, 프로그램 폴더, 데이터베이스); 꺼져 있던 이전 HQbird 유닛은 꺼진 상태로 유지됩니다. 호스트에 여러 에이전트가 있는 경우, 공유 HQ Monitor 로그인 파일은 마지막 에이전트가 제거될 때까지 유지됩니다.

에이전트가 호스트의 RCM을 실행하고 다른 에이전트가 해당 RCM을 사용하는 경우, --uninstall은 종료 코드 5와 함께 거부하고 아무것도 변경하지 않습니다: this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force는 에이전트를 강제로 제거합니다; 그러면 클러스터는 CA를 잃게 됩니다(새 인증서 없음, 새 멤버 없음). RCM 유닛은 호스트의 다른 에이전트가 사용하는 동안 유지됩니다. 이전 소유자가 사라졌을 때 다른 에이전트를 새 RCM의 소유자로 만들려면: fbagent --cluster-init <id> --rcm-takeover(새 CA: 멤버를 다시 연결하십시오).

설치 끝부분의 힌트(Uninstall: sudo sh ... --uninstall)에는 --agent-dir이 없습니다: 여러 인스턴스가 있는 경우 위와 같이 추가하십시오.

인스턴스의 Firebird도 제거하려면(설치 프로그램은 이를 수행하지 않습니다; 먼저 해당 데이터베이스의 gbak 백업을 만드십시오), 예를 들어 /opt/fb50-2의 Firebird:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

8. HQCenter에 연결

HQCenter는 HQbird 에이전트를 관리하는 회사의 중앙 서버입니다: 라이선스, 구성, 업데이트, 백업 개요. HQCenter 없이 에이전트는 설치 프로그램의 버전과 체험판 또는 라이선스 파일만으로 독립적으로 작동합니다.

Diagram
  1. HQCenter 관리자 패널에서 Tokens (https://<hqcenter>:8443/admin/tokens)를 엽니다. Install script 양식에서 라이선스(또는 없음), 모드, 서버 수 및 유효 기간(1~365일)을 선택합니다; 플랫폼 및 Firebird 필드는 사용되지 않습니다. Download connection file을 클릭하고 attach.json을 저장합니다. 이 파일에는 비밀 토큰이 포함되어 있습니다: 안전하게 보관하고(chmod 600), 사용 후 삭제하며, 같은 페이지의 목록에서 토큰을 폐기하십시오. 이 양식은 admin_panel.install_script_url이 설정된 경우에만 표시됩니다.
  2. attach.json을 서버로 복사합니다.
  3. 다음 두 가지 방법 중 하나로 연결합니다:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

일반 토큰의 경우 명령은 HQCenter 관리자가 요청을 승인할 때까지(최대 30분) 기다립니다. 라이선스 토큰의 경우 에이전트가 즉시 연결되고 라이선스를 받습니다. 연결 후 HQCenter가 에이전트에 라이선스를 부여하면 체험판이 종료됩니다; 이후 에이전트, HQ Monitor, Firebird 및 클러스터 구성 요소는 HQCenter 카탈로그에서 업데이트됩니다. 설치 중 연결에 실패해도 설치는 취소되지 않습니다: 요약에 그렇게 표시되며, 위 명령으로 다시 시도할 수 있습니다.

요구 사항: HQCenter (goafts) 1.15.0 이상(이전 버전에는 연결 파일 버튼이 없음); 서버는 연결을 위해 HQCenter 부트스트랩 포트에 한 번 접속한 다음 에이전트 포트(기본값 443)에 접속합니다. HQCenter는 인터넷 없이도 사용할 수 있습니다. 동일한 서버를 동일한 HQCenter에 두 번째로 연결하려면 라이선스 토큰이 있어도 관리자의 승인이 필요합니다.

9. 무인 설치 및 스크립트

모든 옵션은 터미널에서도 작동합니다. 무인 실행에는 --yes가 필요합니다 (계획의 질문에 답변; 터미널 없이 --yes 없이 실행하면 설치 프로그램이 종료 코드 4와 함께 중단됨). --yes는 텍스트 인터페이스를 절대 열지 않습니다. 터미널에서 설치 프로그램을 시작하고 질문에 스스로 답하는 스크립트(예: expect 사용)는 --no-tui를 추가하거나 HQBIRD_NO_TUI=1을 설정해야 합니다: 2027.2.30 이후의 키트는 그곳에서 페이지를 엽니다. 종료 코드가 결과를 알려줍니다; 자세한 내용은 터미널과 /var/log/fbagent/install.log에 있습니다.

옵션

옵션 의미 기본값
--fb-root DIR 새 Firebird의 폴더(새 폴더 또는 빈 폴더); 또는 업데이트할 Firebird의 폴더 /opt/firebird, 그다음 /opt/fb<NN>
--port N Firebird 포트 첫 번째 Firebird의 경우 3050; 다른 라인의 경우 해당 라인의 포트(3.0은 3053, 4.0은 3054, 5.0은 3055)
--sysdba-pass-file F, --sysdba-pass P 새 Firebird의 SYSDBA 비밀번호(F의 첫 줄; P는 0600 파일에 기록됨) 생성되어 /root/fbagent-install-sysdba.txt에 저장됨; 호스트의 추가 Firebird는 해당 파일에서 비밀번호를 가져옴
--agent-id ID 새 에이전트의 agent.id; 첫 설치 시에만, 설치된 에이전트는 자신의 id를 유지함(섹션 3의 “The agent id”) 호스트 이름 + 날짜 + 인스턴스
--hqmonitor-port N HQ Monitor 포트 20000 + Firebird 포트
--hqmonitor-login L --hqmonitor-password-file F HQ Monitor 로그인, 호스트의 모든 인스턴스가 공유: 한 인스턴스에서 지정하면 모든 인스턴스의 로그인이 변경됨 admin + 생성된 비밀번호; 업데이트 또는 추가 인스턴스는 기존 로그인을 유지함
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] 체험판 이메일(30일); 주소는 벤더의 체험판 서버로 전송됨 없음
--auto-update all|agent|off HQCenter에 연결되지 않은 서버의 업데이트(2027.2.31 이후 키트): agent = 에이전트, HQ Monitor 및 fbmcp가 스스로 업데이트되고, Firebird 패키지는 사용자를 기다림; all = Firebird도 해당 시간대에 업데이트됨; off = 업데이트 확인 없음(섹션 4의 “Updates without HQCenter”) 모드는 변경되지 않음; 새 에이전트는 agent

| --license F | 설치할 라이선스 파일 | 없음 | | --attach F | HQCenter에 연결(attach.json) | 없음 | | --no-hqbird, --disable-hqbird | 이전 HQbird를 그대로 두기 / 모든 유닛 끄기 | 자동 | | --no-debug | Firebird 디버그 파일을 설치하지 않음 | 설치됨 | | --no-fbmcp | fbmcp(AI 클라이언트용 MCP 서버)를 설치하지 않고 이 호스트의 fbmcp를 변경하지 않음 | 설치됨 | | --fbmcp-allow-from A,B | 이 관리자 주소(IP 또는 CIDR)에 대해 fbmcp의 원격 모드를 켬 | 로컬만 | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | fbmcp의 원격 포트; 인증서의 추가 이름; 인증서와 리스너의 주소 | 포트 8650 | | --rcm on\|off | 이 호스트에 클러스터 콘솔 RCM을 설치하고 새 클러스터 생성(에이전트 3.1.0 이상) | 질문함; 아니요 | | --rcm-password-file F | --rcm on과 함께 사용하는 RCM 관리자 비밀번호(F의 첫 줄) | 생성되어 마지막에 표시됨 | | --cluster-id ID | --rcm on과 함께 사용하는 클러스터 ID | 호스트 이름 | | --cluster-pairing on\|off | 검색 모드: 24시간 동안의 페어링 창, RCM이 이 에이전트를 초대할 수 있음 | 질문함; 아니요 | | --rcm-allow A,B,... | 검색 모드에서 이 RCM만 이 호스트를 초대할 수 있음(IP, CIDR 또는 호스트 이름) | 모든 RCM | | --pairing-port N | 새 에이전트의 페어링 포트 7450–7459; 슬롯을 선택함(노드 포트 7051+k, 7061+k). 이후 설정은 슬롯을 유지함 | 첫 번째 빈 슬롯 | | --cluster-node on\|off | 클러스터 노드 서비스를 에이전트의 캐시에 넣음 | 켜기 | | --yes | 계획의 질문에 예라고 답함(클러스터 질문에는 아니요) | 질문함 | | --check | 검사, 라이브러리, 계획만 수행; 아무것도 변경되지 않음 | — | | --plan-help | 계획의 코드(M1, M2, …)가 무엇을 의미하는지 출력하고 종료 | — | | --no-tui | 텍스트 인터페이스가 없는 일반 설치 프로그램; 변수 HQBIRD_NO_TUI=1도 해당(섹션 3의 “일반 설치 프로그램”) | 터미널의 텍스트 인터페이스 | | --lang en\|ru\|pt-BR\|de | 설치 프로그램의 언어; 변수 HQBIRD_LANG도 해당(섹션 3의 “설치 프로그램의 언어”) | 콘솔의 UTF-8 로캘, 없으면 영어 | | --tmpdir DIR | 여기에 압축 해제(프로그램을 실행할 수 있는 폴더) | /var/tmp | | --extract DIR | 페이로드를 DIR/payload에 압축 해제만 하고 종료 | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | 에이전트와 HQ Monitor 제거(Firebird는 유지됨); --force는 다른 에이전트가 사용 중인 호스트의 RCM을 실행하는 에이전트도 제거함 | — |

옵션은 --port 3055 또는 --port=3055로 작성할 수 있습니다. 상대 경로는 현재 폴더를 기준으로 합니다.

예제

기본값으로 새로 설치:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"

선택한 폴더와 포트로 새로 설치, 파일에서 가져온 SYSDBA 비밀번호와 HQ Monitor 로그인 사용:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

체험판 이메일, 라이선스 파일, attach 파일로 새로 설치:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

이전 HQbird 업데이트, 모든 이전 HQbird 유닛 끄기:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

HQbird 2027을 새 버전으로 업데이트(인스턴스 하나; 여러 개인 경우 --fb-root와 --port 추가):

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes

포트 3056의 두 번째 Firebird 5.0 인스턴스:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056

제거:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

설치 실패 시 중단되는 스크립트:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

인터넷이 없는 서버: OS 라이브러리

각 라인의 Firebird는 (glibc 외에) OS에서 다음 라이브러리가 필요합니다:

라인 패키지(Debian/Ubuntu) 패키지(RHEL 계열)
5.0 libtommath1, libicu<NN>, libgssapi-krb5-2 libtommath(EPEL), libicu, krb5-libs
4.0 libtommath1, libicu<NN> libtommath(EPEL), libicu
3.0 libtommath1, libicu<NN> libtommath(EPEL), libicu
2.5 보통 없음(libstdc++6은 기본 시스템에 있음) 보통 없음

3.0, 4.0, 5.0 라인의 2027.2.30 이후 키트는 Firebird 설치 스크립트가 사용하는 colrm 프로그램도 필요합니다: 패키지 bsdextrautils(구버전 Debian 및 Ubuntu에서는 bsdmainutils). 최소 Debian에는 없습니다; RHEL 계열에는 항상 존재하는 util-linux에 있습니다.

패키지가 없고 저장소에 접근할 수 없으면 설치 프로그램은 종료 코드 6으로 중단되고 아무것도 변경되지 않습니다:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

RHEL 계열에서 libtommath는 EPEL에 있습니다: 저장소에 접근할 수 있으면 설치 프로그램이 epel-release를 직접 추가합니다. 접근할 수 없으면 명령은 dnf install -y epel-release, dnf download --resolve <packages>, dnf install -y ./*.rpm입니다. --check는 같은 목록을 미리 출력하므로 설치 시간 전에 패키지를 준비할 수 있습니다.

종료 코드

코드 의미 호스트 변경
0 완료(체험판 이메일, attach 또는 라이선스에 대한 경고는 요약에 있음) 예
1 거부됨: 호스트, 옵션, 파일 또는 계획(이유가 출력됨). 또한: 텍스트 인터페이스에서 종료 없음
2 설치가 실패하여 롤백됨. 또한: 설치 프로그램이 신호(Ctrl+C)로 중단됨 롤백됨; 설치 전에 중단되면 없음
3 설치가 실패하고 롤백이 완전하지 않음(요약에 확인할 사항이 나옴) 일부
4 계획의 질문이 확인되지 않음(터미널 없음, --yes 없음). 없음
5 페이로드가 검사를 통과하지 못함(sha256, 서명): 파일을 다시 다운로드하십시오. --uninstall의 경우: 거부됨, 에이전트가 호스트의 RCM을 실행하고 다른 에이전트가 이를 사용함(섹션 7) 없음
6 OS 라이브러리가 없고 패키지 저장소에 접근할 수 없음 없음
7 배포판 패키지의 Firebird가 설치되어 있음 없음

10. 문제 해결

문제 해결 방법
run as root (sudo sh ...) 설치 프로그램을 sudo로 또는 root로 실행하십시오
텍스트 인터페이스 페이지가 열리지 않음 첫 줄에 이유가 나옴: needs a window of 80x24 or larger(창을 크게 하십시오; 상태 줄이 있는 tmux는 한 행을 차지함) 또는 needs bash 4.4 or newer. 그런 다음 실행되는 일반 설치 프로그램이 같은 설치를 수행함
페이지에 잘못된 문자나 깨진 줄 터미널을 UTF-8로 설정하거나 --lang en으로 실행하십시오; --no-tui는 일반 설치 프로그램을 실행함
/var/tmp is mounted noexec --tmpdir /root로 다시 실행하십시오(프로그램을 실행할 수 있는 폴더)
is damaged or cut(종료 코드 5) .run 파일을 다시 복사하고 sha256sum을 게시된 값과 비교하십시오
종료 코드 6, 라이브러리 없음 출력된 대로 패키지를 준비한 후(섹션 9) 설치 프로그램을 다시 실행하십시오
종료 코드 7, 배포판 패키지의 Firebird 패키지를 제거하거나(apt-get remove firebird3.0-server, gbak 백업 유지) --import-firebird와 함께 온라인 설치 프로그램을 사용하십시오

| refused (M17): Firebird 2.5 works only in /opt/firebird | 두 번째 Firebird 2.5는 불가능합니다. 그 옆에 다른 라인을 설치하십시오(섹션 7) | | 여러 에이전트가 있는 상태에서 --uninstall이 거부됨(종료 코드 1) | 목록의 폴더와 함께 --agent-dir를 추가하십시오. 예: --agent-dir /opt/hqbird/fbagent-fb50-2 | | --uninstall이 거부됨(종료 코드 5): this agent runs the RCM of the host | 먼저 RCM 콘솔에서 클러스터를 제거하거나 --force로 다시 실행하십시오(섹션 7) | | 업데이트(3.0) 후 employee.fdb에 대한 no permission for read-write access | sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb(섹션 6) | | refused (M14): the folder is not empty | --fb-root로 비어 있거나 새로운 폴더를 선택하거나, 업데이트할 Firebird를 지정하십시오 | | 종료 코드 2 또는 3 | /var/log/fbagent/install.log를 확인하십시오. 유닛은 실행 전 상태로 돌아갔거나(코드 2) 점검이 필요합니다(코드 3) | | HQ Monitor가 열리지 않음 | systemctl status hqbirdmonitor-fb50(2027.2.9 이전에는 hqbirdmonitor-p<port>); 포트에서 다른 것이 수신 대기하지 않는지 확인하고, 방화벽에서 포트를 여십시오. 다른 포트를 사용하려면 --hqmonitor-port | | HQ Monitor 비밀번호를 분실함 | --hqmonitor-login admin --hqmonitor-password-file <file>과 함께 설치 프로그램을 다시 실행하십시오(복구). 기존 /opt/hqbird/conf/access.properties는 access.properties.bak-<time>으로 보존됩니다. 새 로그인 정보는 호스트의 모든 인스턴스에 적용됩니다 | | 평가판 이메일이 전송되지 않음(네트워크 없음) | 나중에 전송하십시오: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy | | SELinux(AlmaLinux, RHEL) | enforcing 모드에서 지원됩니다. 설치 프로그램이 작성하는 파일의 컨텍스트를 복원하므로 별도로 할 일이 없습니다 |